# Horizon Horizon is a Rust rewrite of Minecraft Java **26.3** targeting one-to-one vanilla gameplay parity, alongside client performance research. Not affiliated with Mojang or Microsoft. **The Rust game is now playable.** The [native client](docs/native-client.md) opens on a vanilla-style title screen with world creation and selection, and generates worlds with the Rust port of the vanilla overworld generator: noise terrain, aquifers, surface rules, carvers, and the placed features ported so far, all checked against vanilla. It streams and lights chunks on worker threads and renders every vanilla block model with smooth lighting, biome tints, the vanilla sky, sun, moon, stars and clouds. Gameplay so far: - validated player physics, health and hunger; - mining with vanilla tool rules and loot tables; - placing, crafting, chests and furnaces; - dropped items and particles; - sounds; - passive and hostile mobs with combat, including guardians, shulkers, illagers, ravagers, the wither and the ender dragon fight; - villagers that take jobs, trade, restock, meet at the bell and sleep in beds; - boats, minecarts, item frames, paintings and armor stands; - shields, maps, books, fireworks, beacons, advancements and statistics; - Anvil saves. Parity is **not** complete. Still missing: the warden and the sculk family, the breeze, sniffer, creaking, happy ghast, llamas and a few other mobs, raids and pillager patrols, villager breeding and gossip, the loom, crafter and recipe book, scoreboards, subtitles, and spawned mob gear enchantments. Multiplayer joins vanilla servers but Horizon cannot host one. See [Rust rewrite status](docs/rust-parity.md). ### Java parity: 73% Each subsystem scores 0 (absent), 0.25 (started, not playable), 0.5 (playable, major vanilla features missing), 0.75 (playable, mostly complete) or 1 (complete and verified against vanilla by differential tests). The percentage is the average; `tests/test_parity.py` keeps it in sync with this table. Last audited 2026-10-09 against the code, not the docs: all 217 `tools/test_*_parity.py` differential harnesses pass, and the client joins a vanilla 26.3 server. | Subsystem | Score | Main gaps | | --- | ---: | --- | | Window, input and game loop | 0.75 | Frame timing and input not compared with vanilla | | Assets and resources | 0.75 | Heuristic item icons for some items | | Network protocol and multiplayer | 0.5 | Joins vanilla servers (chunks, entities, chat); cannot host or open to LAN | | Chunk storage and palettes | 0.75 | Client uses plain arrays; palettes only on save | | Section meshing | 0.75 | Whole-mesh output not compared with vanilla | | Rendering | 0.75 | Held blocks not drawn in mob hands; no elder guardian curse overlay | | Lighting | 0.75 | Slabs/stairs light wrong; light not saved or tested against vanilla | | World generation | 0.75 | Tree feature output diverges from vanilla; whole chunks not compared end to end | | Region files and saves | 0.75 | Light not saved; some block entities kept as raw NBT | | Entities and physics | 0.75 | No warden, breeze, sniffer, creaking, happy ghast, llamas or copper golem; no raids, patrols or villager breeding | | Interaction and inventory | 0.75 | No loom, crafter, recipe book or horse inventory screen | | Menus, HUD and chat | 0.75 | About 30 commands; no scoreboards, subtitles or recipe book | | Audio | 0.75 | Music and ambience not verified by ear; no subtitles | | Block behaviours and ticking | 0.75 | No sculk or creaking hearts; dispensers lack most item behaviours | ### Next steps 1. `/summon` with NBT, and enchantments on spawned mob gear (`mob_spawn_equipment`). 2. Pillager patrols and raids (bad omen, raid waves, the raid bar), then villager breeding, gossip and iron golem summoning. 3. The warden and the sculk family (sensors, shriekers, catalysts), then the creaking and its heart. 4. Remaining mobs: breeze, sniffer, llamas and trader llamas, happy ghast, copper golem, illusioner. 5. The loom, crafter, recipe book and horse inventory screen. 6. Scoreboards and subtitles. 7. Hosting: an integrated server so Horizon worlds can be opened to LAN. ```sh python3 tools/prepare_native_client.py --prepare # needs JDK 25; extracts private vanilla resources python3 tools/fetch_sounds.py # optional: vanilla sounds cargo run --release -p horizon-client ``` **Target machine:** the Rust rewrite targets one machine, **ludodesktop**: Ubuntu 26.04, Intel i7-13700KF, NVIDIA RTX 4080, GNOME on Wayland. The final deliverable is a playable native Linux build validated there. macOS (including the M2 Pro Mac) and Windows are out of scope. Track implementation and acceptance criteria in [Rust rewrite status](docs/rust-parity.md). **Java performance packs (no longer developed):** the earlier track of pinned Java performance packs, distant terrain, an original frame/tick recorder and client/server starter downloads. No release downloads are published; build the packs and starters locally with `python3 tools/build_release.py` (see [Build and run](#build-and-run)). They are no longer a development target. ## Java packs: Mac starter (out of scope) Build **horizon-mac-starter-0.21.0.zip** with `python3 tools/build_release.py` (it lands in `dist/`), extract it and open `Mac-Start.command`. It verifies and installs official universal Prism Launcher in `~/Applications` if needed, then opens the balanced pack import. Sign into Microsoft **inside Prism yourself**. This project needs no credentials. Use native **Java 25 ARM64**, maximum heap **6144 MiB**, minimum **512 MiB** on your 16 GB M2 Pro. Prism can download Java automatically. Start at 1280×800 or 1920×1200; full Retina resolution is a larger GPU workload. [START-HERE.txt](packs/START-HERE.txt) has details. The same `.mrpack` files import into Prism on Windows and Linux. If Prism is already installed, follow the [Mac import and first comparison guide](docs/mac-first-test.md). Core and balanced also pass [macOS title/demo-world rendering probes](docs/client-graphics-smoke.md) on the hosted ARM64 software renderer, including readback, saves and clean exits. Physical M2 GPU performance and macOS 27 remain to be tested. | Profile | Full-detail chunks | Distant LOD radius | Suggested maximum heap | | --- | ---: | ---: | ---: | | baseline | 12 | none | 6144 MiB | | core-performance | 12 | none | 6144 MiB | | m2-balanced | 12 | 128 | 6144 MiB | | adaptive (experiment) | 12 | 128 | 6144 MiB | | worker-pacing (experiment) | 12 | 128 | 6144 MiB | | adaptive-pacing (experiment) | 12 | 128 | 6144 MiB | | queue-wait (experimental) | 12 | 128 | 6144 MiB | | adaptive-queue (experimental) | 12 | 128 | 6144 MiB | | dispatch-retry (experimental) | 12 | 128 | 6144 MiB | | tick-dedup (experimental) | 12 | 128 | 6144 MiB | | culling-empty (experimental) | 12 | 128 | 6144 MiB | | quad-reuse (experimental) | 12 | 128 | 6144 MiB | | terrain-position (experimental) | 12 | 128 | 6144 MiB | | culling-rays (experimental) | 12 | 128 | 6144 MiB | | foreground-first (combined experiment) | 12 | 128 | 6144 MiB | | foreground-vulkan (combined experiment) | 12 | 128 | 6144 MiB | | low-memory | 8 | none | 3072 MiB | | far-distance | 12 | 256 | 8192 MiB, with sufficient physical RAM | | cinematic | 12 | 128 | 6144 MiB | | vulkan | 12 | 128 | 6144 MiB | Balanced combines [Sodium](https://modrinth.com/mod/sodium), [Lithium](https://modrinth.com/mod/lithium), [FerriteCore](https://modrinth.com/mod/ferrite-core), [ImmediatelyFast](https://modrinth.com/mod/immediatelyfast), [EntityCulling](https://modrinth.com/mod/entityculling), and [Distant Horizons](https://modrinth.com/mod/distanthorizons). Cinematic adds [Iris](https://modrinth.com/mod/iris) and [Complementary Reimagined](https://modrinth.com/shader/complementary-reimagined), initially disabled. Vulkan independently experiments with the game's own backend and fallback, without Iris. Distant LOD is simplified terrain. Nearby blocks retain full detail. Initial generation costs CPU/disk/memory and needs warm-up. DH adjusts clouds, chunk fade and transparency to blend its renderer; assess appearance as well as speed. Shaders cost GPU time and have [Mac-specific limits](https://shaders.properties/current/reference/miscellaneous/macos/). Universal CPU/GPU support and exact vanilla equivalence remain validation goals. Simulation distance stays 12 in every profile; normal 20 TPS rules are retained. For the first comparison at the same view distance, use `baseline` versus `core-performance`: both select 12 full-detail chunks and no distant LOD or shaders. The latter adds only the pinned core performance mods and leaves every original controller disabled. Then test balanced separately for its additional distant terrain. Matching captured settings does not prove pixel-identical rendering. [Core comparison protocol and selected observations](docs/core-performance.md) include three repeated matched-view software-rendered pairs with 14–21% higher FPS in this workload; M2 performance remains unmeasured. [Heap budget experiment](docs/heap-budget.md): three pairs with 3 GiB versus 1.5 GiB maximum heap show variable RAM savings and GC/frame-time tradeoffs; playable defaults remain unchanged. [Matched graphics API comparison](docs/graphics-api-comparison.md): Vulkan adds about 1.5% average FPS but about 12% CPU in three Linux software-rendered pairs; backend defaults remain unchanged and physical Mac performance is unmeasured. The optional `queue-wait` pack yields during pending distant-terrain debounce retries; `adaptive-queue` combines it with the existing controllers. [Queue experiment and measurement limits](docs/debounce-queue.md). Version 0.16 adds a separate [terrain position arithmetic experiment](docs/terrain-position.md) for the sampled full-data lookup. It retains the pinned library’s unusual negative-coordinate rounding and invalid-level errors. Balanced keeps it off; whole-game and Mac performance still require measurement. Version 0.15 adds an isolated [culling ray scratch experiment](docs/culling-rays.md) that reuses two numeric vectors within each culling instance while retaining upstream arithmetic and decisions. Balanced keeps it off; hardware gains remain unmeasured. Version 0.14 adds an isolated [empty culling whitelist experiment](docs/culling-empty.md) that avoids allocating iterators while there are no dynamic handlers. Live registration and nonempty callbacks retain upstream behavior. Balanced keeps it off; whole-game gains still need hardware comparisons. DH profiles also request a scoped [interruptible blending-read wait](docs/terrain-read-wait.md) to let background workers leave a pending metadata read during shutdown. Version 0.13 adds an isolated [tick membership experiment](docs/tick-membership.md) that reuses compact storage for DH's private per-tick membership checks. The combined foreground profiles include it too; balanced keeps it off. The applied holder test verifies action semantics and removes repeated entry allocations; whole-game FPS and RAM gains still need hardware measurements. Version 0.12 captures effective distant-terrain quality, radius, worker budgets, Iris state and field of view. Start/end snapshots flag changed visual settings; [measurement details](docs/terrain-measurements.md) explain their limits. Version 0.11 adds combined foreground-first OpenGL/Vulkan profiles with a 120 FPS adaptive goal, plus explicit collector experiments and GC measurement guidance. See [combined controls](docs/foreground-first.md), [Vulkan on your Mac](docs/vulkan.md) and [collector comparisons](docs/collectors.md). The frame goal is not a rendering cap. Version 0.10 adds an isolated [rejected-dispatch retry experiment](docs/dispatch-retry.md). It bounds retry passes when a DH worker rejects queued work, preserving original requeue handling and allowing other executors to progress. Balanced keeps it off. Version 0.9 also makes the queue's idle wait wakeable for incoming work, preserving its debounce rules and bounded cache-maintenance cadence. It remains part of the optional queue profiles, with separate wake-latency measurements. Version 0.8 fixes a fresh-instance graphics preset that could override the selected render distance. It also records actual GC/header settings and supports an optional [compact object headers experiment](docs/compact-headers.md) for Java 25; packs do not enable that JVM flag automatically. ## Measure on your hardware The optional [adaptive terrain experiment](docs/adaptive-terrain.md) throttles distant terrain background work when frames slow down or heap pressure rises, keeping the balanced profile's view distances and simulation settings. It remains opt-in until real hardware demonstrates a benefit. The additional [precise worker pacing experiment](docs/worker-pacing.md) makes short terrain tasks respect their duty-cycle budget and avoids boxed worker timestamps. It changes generation speed and CPU use, so it stays separate from balanced. Press **F8** during gameplay to start a 120-second recording, or again to stop early. Rebind in Controls if needed. This also works with restricted chat accounts. Alternatively: `/horizon bench