누군가 Minecraft를 Rust로 다시 짰고, 833가지 행동 차이를 하나씩 맞췄다

Horizon은 Minecraft: Java Edition 26.3을 Rust로 다시 짠 것이다. ZIP 파일 하나, 네이티브 바이너리 하나, 자바는 필요 없다. 기존 월드를 읽고, 바닐라 서버에 접속하고, 지형 생성도 같은 것을 돌린다.
게임을 다시 짜는 일이 흔한 취미라면 이 설명은 별것 아니다. 그렇지 않으니까 문제다. 어려운 쪽은 렌더링이 아니다. Minecraft의 행동은 오랜 세월 쌓인 방대한 예외 덩어리로 정의되고, 재작성이 맞다고 말하려면 그 예외를 전부 재현해야 한다. 아무도 문서로 남기지 않은 것까지 포함해서.
Horizon이 이 문제에 답한 방식이, 이 저장소를 한 시간 들여 볼 만한 이유다.
이식 원장
`port_ledger.py`라는 도구가 바닐라 26.3의 모든 메서드를 읽고 Horizon 코드와 하나씩 대조한다. 나오는 값은 하나다. 플레이어가 알아차릴 만한 바닐라 행동 가운데 Horizon에 아직 없는 것의 수.
README 기준으로 833건이 발견됐고 미해결은 0건이다. 분류는 영역별로 촘촘하다. 동물, 몬스터와 보스, 엔티티와 발사체, 아이템과 인챈트, 블록과 레드스톤, 월드 생성과 저장, 화면과 HUD, 렌더링과 모델, 서버 측 플레이어 처리, 몹 AI와 습격. 영역마다 이슈가 붙어 있다.
두 번째 도구 `parity_gaps.py`는 그 숫자가 줄어드는 것을 추적한다. Horizon이 말하는 '일치'의 범위는 좁다. 누군가 지적한 차이를 모두 막은 데까지다.

하네스가 실제로 비교하는 것
여기서 README가 흔치 않은 일을 한다. 자동 비교가 어디까지 닿는지를 0에서 1까지 점수로 매긴 표를 공개하고, 1은 그 하위 시스템을 하네스가 덮고 통과했다는 뜻이며 바닐라와 다른 곳이 없다는 뜻은 아니라고 분명히 밝힌다.
창, 입력, 게임 루프가 1이라는 말은 루프, 옵션, 카메라, 자동 점프, 달리기와 웅크리기 전환, 프레임 제한이 모두 일치한다는 뜻이다. 에셋과 리소스는 1이고, 196,290개 아이템 스택에서 모델이 일치하며 리소스 팩 화면은 3,000회가 넘는 세션에서 시험됐다. 네트워크 프로토콜은 1이고, 바닐라 서버에 접속되며 전용 서버의 파일, 로그인, 설정, 플레이, 명령 트리가 일치하고 오프라인 모드에서 462건의 LAN 탐색 사례를 시험했다. 청크 저장은 1이고, 클라이언트와 저장 파일이 쓰는 팔레트 컨테이너가 266개 시나리오에서 바닐라와 동일하다. 섹션 메싱은 1이고, 112개 장면과 100만 개가 넘는 쿼드가 바닐라와 같다.
마지막 숫자는 잠깐 볼 만하다. 100만 쿼드가 똑같이 그려진다는 건 눈속임이 아니라 같은 형상이 그려졌다는 뜻이다.
성능 숫자
벤치 조건은 재현할 수 있을 만큼 구체적이다. Windows 11, Ryzen 7 9800X3D, RTX 5080, 1280×720 창 모드, VSync 끔, 값마다 3회, 장면 4개의 평균이고 괄호 안은 가장 느린 1% 프레임이다.
청크 8에서 Horizon은 초당 3,289프레임, 최악값 1,327. 바닐라 26.3은 2,437에 640. Sodium, Lithium, FerriteCore, ImmediatelyFast를 얹은 바닐라는 2,375에 709.
청크 16에서는 2,074 대 1,661과 1,586. 청크 32에서는 1,207 대 1,031과 879.
더 재미있는 쪽은 하위 1% 열이다. 모든 거리에서 Horizon의 최악 프레임은 바닐라 최악 프레임보다 두 배쯤 빠르다. 눈에 띄는 끊김과 눈에 안 띄는 끊김의 차이가 거기 있다.
로딩 시간도 같은 방향이다. 타이틀 화면은 2.9에서 3.2초, 바닐라는 7.5에서 7.7초, 모드를 깐 클라이언트는 10.8에서 11.1초. 청크 로딩은 2.9에서 3.8배 빠르다. 플레이 중 워킹 세트는 1.1에서 1.7 GB, 바닐라는 1.9에서 2.9 GB.
지금 빌드에 들어 있는 것
서바이벌, 크리에이티브, 하드코어, 관전자 모드. 세 차원 모두 바닐라 지형 생성. 몹, 주민, 습격, 레드스톤, 모든 명령어, HUD, 조합법 책. 1.8부터 26.2까지의 저장 파일은 열 때 업그레이드된다.
온라인 모드의 바닐라 서버와 멀티플레이가 된다. LAN 월드도 되고 런처가 발급하는 코드로 친구를 초대할 수도 있다. 리소스 팩, 데이터 팩, 셰이더 팩이 모두 로드된다. 콘텐츠 모드와 네이티브 Rust 모드는 런처에서 설치한다. 서버는 런처에서 열거나 VPS에서 `horizon-server`를 돌리면 된다.
바닐라 느낌을 바꾸는 그래픽 옵션은 기본으로 꺼져 있다. 1,024청크까지의 원경, HDR, 컨트롤러 지원이 여기 포함된다.
직접 빌드하기
빌드에는 Rust 1.90 이상, Python 3.11 이상, JDK 25가 필요하고 리눅스에서는 `libasound2-dev`와 `libudev-dev`도 필요하다.
예상 밖이었던 건 리소스 준비 단계다. `horizon-prepare`는 자기 손에 있는 Java Edition 26.3에서 게임 에셋을 만들고 `research-lock.json`과 대조한다. 내려받는 것은 없다. 공식 런처에서 26.3을 한 번 실행한 뒤 도구에 `.minecraft` 디렉터리를 지정하거나 `HORIZON_MINECRAFT_DIR`을 설정한다. 서버 jar는 따로 넣는다.
git clone https://github.com/horizon-rust/horizon.git
cd horizon
cargo run --release -p horizon-prepare -- --prepare --server-jar ~/Downloads/server.jar
cargo run --release -p horizon-prepare -- sounds
cargo run --release -p horizon-client
PR을 올리기 전에 기여자는 `python3 tools/pr_ready.py`를 돌린다. 포맷, clippy, 손댄 crate의 테스트, Python 테스트, 공개 트리 검사, 변경이 영향을 주는 바닐라 하네스를 확인한다. 게임 파일과 디컴파일한 소스, 준비된 리소스를 커밋하지 말라고 README가 경고한다.
이게 다른 이유
큰 소프트웨어의 클린룸 재작성은 보통 두 가지 이유로 화제가 된다. 더 빠르거나, 재주가 신기하거나. Horizon은 둘 다지만 가져갈 만한 것은 감사 구조 쪽이다.
대부분의 재작성은 같은 곳에서 넘어진다. 새 버전은 맞아 보이다가 아무도 시험하지 않은 구석에서 어긋나고, 그 어긋남이 쌓인다. Horizon은 구석을 먼저 세는 쪽을 택했다. 원장이 바닐라 메서드를 하나씩 읽어 유한한 목록을 만든다. 하네스가 각 하위 시스템을 바깥에서 증명하고 숫자가 따라붙는다. 196,290개 아이템 스택, 462건의 LAN 사례, 266개 저장 시나리오, 112개 장면.
0.75 이하인 점수가 솔직한 부분이다. 만점만 공개하는 프로젝트는 더 좋아 보이고 덜 알려준다. 표를 통째로 내놓으면 테스트가 닿지 않는 영역이 보이고, 청크 8에 내 모드 목록을 깔았을 때 이 1점이 얼마짜리인지 스스로 판단할 수 있다.
거버넌스 이야기도 있는데, README는 이걸 당연한 일처럼 쓴다. 당연하지 않다. 평의회가 있고, 주제별 그룹에 이름이 붙은 리드가 있고, 팀과 중재 정책이 있고, 전부 별도 문서에 적혀 있다. 수백 명이 참여하는 비공식 게임 재작성에는 누구의 PR을 받을지 정하는 절차가 필요하다. 필요해지기 전에 답을 적어 둔 사실은 833건이 어떻게 닫혔는지를 잘 보여준다.
MIT 라이선스, 비공식, 게임 본편은 직접 준비. 이 세 가지는 README 첫 문단에 있고, 거기 있어야 마땅하다.