Console Chess

다양한 AI 엔진 지원

Console Chess는 네 가지 서로 다른 체스 엔진을 제공합니다. 기본 엔진인 ‘noise’는 material, center, mobility 요소에 configurable noise를 추가한 수준으로 ELO 750~1250 정도입니다. ‘adam’ 엔진은 minimax 탐색과 piece-square 테이블을 사용해 ELO ~1600 수준의 강도를 보이며, ‘greedy’ 엔진은 항상 가장 높은 가치의 말을 잡는 간단한 전략으로 ELO ~500 수준입니다. 또한 Stockfish 엔진을 UCI 프로토콜을 통해 subprocess로 실행하여, `-d easy` 또는 `-d hard` 옵션으로 ELO 1350 또는 2800 수준으로 제한하여 사용할 수 있습니다.

터미널 기반 UI 및 조작법

게임은 터미널에서 실행되며, 키보드를 통해 조작합니다. 화살표 키 또는 hjkl 키로 커서를 이동하고, Enter 또는 Space 키로 말을 선택하고 수를 확인합니다. ‘q’ 키를 누르면 게임을 종료할 수 있습니다. Windows에서는 Windows Terminal 또는 VT 지원 콘솔에서 실행해야 하며, 유니코드 폰트(예: Cascadia Mono)를 사용해야 체스 기호가 정상적으로 표시됩니다. 레거시 conhost에서는 폰트 변환이 필요할 수 있습니다.

버전 확인 및 빌드 옵션

`console-chess –version` 또는 `-V` 명령을 통해 현재 실행 중인 버전을 확인할 수 있습니다. 버전 정보는 빌드 시 `-Pversion=x.y.z` 플래그, Git 태그 `vX.Y.Z`, 또는 기본값 `0.0.0-SNAPSHOT` 순으로 결정됩니다. 또한 `.scriptschess.sh` 스크립트를 통해 다양한 작업을 수행할 수 있습니다: `play`로 게임 실행 (필요 시 JVM 빌드), `build`로 JVM 배포판만 빌드, `test`로 단위 테스트 실행, `native`로 GraalVM을 사용한 네이티브 바이너리 빌드, `nrun`로 네이티브 빌드 및 실행, `ci`로 테스트와 네이티브 빌드를 순차적으로 수행할 수 있습니다.

다운로드 및 설치 방법

Windows 사용자는 Chocolatey 패키지 관리자를 통해 간단히 설치할 수 있습니다. 관리자 권한으로 PowerShell을 열고 다음 명령을 실행합니다:

choco install console-chess

이 명령은 공식 Chocolatey 저장소에서 Console Chess 패키지를 다운로드하고 설치합니다. 설치 후, PowerShell 또는 Windows Terminal에서 `console-chess` 명령을 입력하여 게임을 시작할 수 있습니다. 또한 GitHub 릴리스 페이지에서 플랫폼별 ZIP 파일을 직접 다운로드받아 사용할 수도 있습니다: Windows x64용은 `console-chess-windows.exe`가 포함된 ZIP 파일을 제공하며, 다운로드 후 압축을 해제하고 실행 파일을 직접 실행하면 됩니다.

실행 방법

설치 후 Windows Terminal을 열고 다음 명령을 입력하여 게임을 시작할 수 있습니다:

.console-chess.exe

또는 Chocolatey를 통해 설치한 경우 PATH에 등록되어 있으므로 단순히 `console-chess` 명령을 입력해도 실행됩니다. 게임 시작 시 기본적으로 ‘noise’ 엔진과 medium 난이도로 대국이 시작됩니다. 엔진과 난이도를 지정하려면 다음과 같이 실행할 수 있습니다:

console-chess -e adam -d hard # ELO ~1600 수준의 adam 엔진, 어려운 난이도
console-chess -e stockfish -d easy # Stockfish 엔진을 ELO 1350 수준으로 제한
console-chess -e noise -d medium -s 42 # 시드 42로 재현 가능한 noise 엔진 실행

게임 중에는 화살표 키 또는 hjkl로 커서를 이동하고, Enter 또는 Space로 말을 선택하고 이동시킬 수 있습니다. ‘q’ 키를 누르면 언제든지 게임을 종료할 수 있습니다.

지원 환경 및 시스템 요구사항

Console Chess는 Windows x64, Linux x64, macOS arm64 플랫폼에서 실행 가능한 네이티브 바이너리를 제공합니다. Windows에서는 Windows 10 이상, Windows Terminal 또는 VT 지원 콘솔에서 실행하는 것이 권장되며, 유니코드 폰트(예: Cascadia Mono, Consolas)를 설정해야 체스 기호가 정상적으로 표시됩니다. 레거시 conhost에서는 폰트 변환이 필요할 수 있습니다. 네이티브 바이너리는 GraalVM을 사용하여 빌드되며, 종속성이 없어 별도의 Java 런타임 설치 없이 실행할 수 있습니다. JVM 버전을 사용할 경우 Java 21 이상이 필요합니다.

최신 버전 및 업데이트 정보

현재 버전은 1.1.0이며, 소스 코드는 GitHub 저장소에서 확인할 수 있습니다. 버전 정보는 `–version` 플래그를 통해 확인할 수 있으며, 릴리스 정보는 GitHub 태그와 함께 관리됩니다. 최신 빌드된 바이너리는 GitHub Actions를 통해 nightly.link에서 제공되며, main 브랜치의 최신 커밋 기준으로 생성됩니다.