diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index 2ccf4654b..0048a14e0 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -8,12 +8,7 @@ permissions: contents: read jobs: verify: - strategy: - fail-fast: false - matrix: - # Linux only. macOS only when started by hand: gh workflow run checks --ref . - os: ${{ fromJSON(github.event_name == 'workflow_dispatch' && '["ubuntu-latest", "macos-26"]' || '["ubuntu-latest"]') }} - runs-on: ${{ matrix.os }} + runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 with: @@ -27,14 +22,30 @@ jobs: python tools/check_public_tree.py --history - name: Test offline research tooling run: python -m unittest discover -s tests -v - - name: Install Rust toolchain - run: rustup toolchain install stable --profile minimal --component rustfmt --component clippy + - name: Install Rust toolchain and the ALSA headers the client's audio links against + run: | + sudo apt-get update && sudo apt-get install -y --no-install-recommends libasound2-dev + rustup toolchain install stable --profile minimal --component rustfmt --component clippy - name: Check formatting and lint run: | cargo +stable fmt --all -- --check cargo +stable clippy --workspace --all-targets -- -D warnings - name: Test Rust core and voxel kernel correctness run: cargo +stable test --workspace + # Horizon never downloads the game. These jobs need a self-hosted Linux runner + # (label horizon-game) holding the maintainer's own copy: the official launcher's + # game directory in HORIZON_MINECRAFT_DIR and the pinned server jar in + # HORIZON_SERVER_JAR. Start them by hand: gh workflow run checks --ref . + vanilla-parity: + if: github.event_name == 'workflow_dispatch' + runs-on: [self-hosted, linux, horizon-game] + steps: + - uses: actions/checkout@v4 + - uses: actions/setup-python@v5 + with: + python-version: '3.12' + - name: Install Rust toolchain + run: rustup toolchain install stable --profile minimal - uses: actions/setup-java@v4 with: distribution: temurin @@ -374,12 +385,8 @@ jobs: RUSTUP_TOOLCHAIN: stable run: python tools/test_float_log_parity.py portable-mod: - strategy: - fail-fast: false - matrix: - # Linux only. macOS only when started by hand: gh workflow run checks --ref . - os: ${{ fromJSON(github.event_name == 'workflow_dispatch' && '["ubuntu-latest", "macos-26"]' || '["ubuntu-latest"]') }} - runs-on: ${{ matrix.os }} + if: github.event_name == 'workflow_dispatch' + runs-on: [self-hosted, linux, horizon-game] steps: - uses: actions/checkout@v4 - uses: actions/setup-python@v5 @@ -466,7 +473,7 @@ jobs: - name: Upload original mod and pack manifests only uses: actions/upload-artifact@v4 with: - name: horizon-${{ matrix.os }} + name: horizon-linux path: | dist/*.mrpack dist/horizon-*.jar diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml new file mode 100644 index 000000000..ed094cdef --- /dev/null +++ b/.github/workflows/release.yml @@ -0,0 +1,27 @@ +name: release builds +# Started by hand: gh workflow run release.yml --ref +# Builds the Windows x64 client and uploads the playable folder as an artifact. +# Linux and macOS builds are made on the development machines. +on: + workflow_dispatch: +permissions: + contents: read +jobs: + windows: + runs-on: windows-latest + steps: + - uses: actions/checkout@v4 + - name: Install Rust toolchain + run: rustup toolchain install stable --profile minimal + - name: Build the client + # The C runtime linked in, so the game runs without the Visual C++ redistributable. + env: + RUSTFLAGS: -C target-feature=+crt-static + run: cargo +stable build --release --locked -p horizon-client --bin horizon-client + - name: Package + shell: bash + run: packaging/package.sh target/release/horizon-client.exe dist/horizon-windows-x64 + - uses: actions/upload-artifact@v4 + with: + name: horizon-windows-x64 + path: dist/horizon-windows-x64 diff --git a/README.md b/README.md index c8ae1d65c..32ecb88c4 100644 --- a/README.md +++ b/README.md @@ -1,337 +1,199 @@ +

+ Horizon: Minecraft Java Edition 26.3, rewritten from scratch in Rust +

+ +

+ CI + Minecraft Java 26.3 + Rust + Vanilla parity 88% + Linux, macOS and Windows + MIT license +

+ +

+ Get started · + Screenshots · + Parity status · + Native client guide +

+ # 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. +A Rust rewrite of Minecraft: Java Edition 26.3 that aims for one-to-one vanilla parity, checked against the game itself with differential tests. + +**Status:** in development. The native client is playable on Linux, macOS (Apple Silicon) and Windows; Java parity is 88% (see [Project status](#project-status)). + +> Not an official Minecraft product. Not approved by or associated with Mojang or Microsoft. Horizon contains no Minecraft code, assets or data: you need your own legally obtained copy of Minecraft: Java Edition 26.3. + +## Screenshots + +Captured in the Rust client itself, with vanilla assets and no mods or shaders. + + + + + + + + + + + + + + + + + +
Sunset over a savanna river valley and a plains village
A plains village with farms, an iron golem and animalsSurvival at dusk: a zombie attacks near the village
A crimson forest in the Nether with a zombified piglinMoonrise over a torch-lit village and river
Salmon swimming in a river + Vanilla world generation ported to Rust (terrain, aquifers, carvers, features, villages and the Nether), every block model with smooth lighting and biome tints, the vanilla sky and fog, mobs, the HUD, chat and advancements: everything in these frames is drawn by Horizon. +
+ +## What it does + +Horizon reimplements the Minecraft Java client and its game logic in Rust, one subsystem at a time, and compares each piece with the vanilla game. Each `tools/test_*_parity.py` harness drives the same inputs through Horizon and through the vanilla client and server bytecode from your own copy of the game, then checks that the outputs are identical. It is for players and developers interested in game reimplementation, and for anyone who wants to see how far a behaviour-exact native rewrite can go. + +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 generators: noise terrain, aquifers, surface rules, carvers and placed features, 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 includes: -**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; +- dropped items, particles and sounds; +- passive and hostile mobs with combat and vanilla AI, including guardians, shulkers, illagers, ravagers, the wither, the ender dragon fight, the breeze, the creaking, the sniffer, the happy ghast, llamas and the copper golem; +- villagers that take jobs, trade, restock, meet at the bell and sleep in beds, on a port of vanilla's brain; +- raids and pillager patrols; +- dispensers, crafters, the loom and the recipe book; +- every command, scoreboards and teams, the player list, subtitles and the HUD overlays; - boats, minecarts, item frames, paintings and armor stands; - shields, maps, books, fireworks, beacons, advancements and statistics; -- Anvil saves. +- Anvil saves, joining vanilla servers, and opening a world to LAN. -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). +## Getting it -### Java parity: 84% +Builds for **Linux x86-64**, **macOS Apple Silicon** and **Windows x64** are attached to the [releases](https://github.com/ludovic111/horizon/releases). Each folder holds the game, the resource preparation tool and a `PLAY.txt`; the first start prepares the resources from your own copy of the game, as below. You can also build from source. + +**Platform.** A GPU with Vulkan on Linux and Windows, or any Apple Silicon Mac. Development and the vanilla harnesses run on Linux. + +**Requirements.** Python 3.10 or newer and JDK 25 (for resource preparation). To build from source: Rust 1.90 or newer, and on Linux the ALSA development headers (`libasound2-dev` on Debian and Ubuntu). + +### Bring your own copy + +Horizon contains no game files and never downloads them. It builds its resources from **your own copy** of Minecraft: Java Edition 26.3, verified against the checksums in `research-lock.json`: + +1. **Client:** install Java Edition with the official launcher and play 26.3 once. Horizon reads `versions/26.3/`, `libraries/` and `assets/` from the launcher's game directory (`~/.minecraft` on Linux). If yours lives elsewhere, pass `--minecraft-dir` or set `HORIZON_MINECRAFT_DIR`. +2. **Server jar:** download the 26.3 server jar yourself, from [minecraft.net/download/server](https://www.minecraft.net/en-us/download/server) while 26.3 is the current release, or otherwise from the `downloads.server.url` in your launcher's `versions/26.3/26.3.json`. Pass it with `--server-jar` or set `HORIZON_SERVER_JAR`. It is only needed the first time. + +### Build and run + +```sh +git clone https://github.com/ludovic111/horizon.git +cd horizon +python3 tools/prepare_native_client.py --prepare --server-jar ~/Downloads/server.jar # needs JDK 25 +python3 tools/fetch_sounds.py # optional: sounds from your launcher install +cargo run --release -p horizon-client +``` + +Everything prepared lands in the gitignored `.local/`. It is derived from the game: never commit it or share it. + +## Usage + +The client starts on the title screen. Command-line options (`--world`, `--seed`, `--creative`, `--render-distance`), controls, scripting through `horizon-ctl`, and packaging for another of your own Linux machines are described in [the native client guide](docs/native-client.md). + +## Documentation + +- [Native client](docs/native-client.md): running, options, controls, scripting and architecture. +- [Rust rewrite status](docs/rust-parity.md): completion criteria and per-area scope. +- Parity notes: [block behaviours and ticking](docs/parity/blocks.md), [section meshing](docs/parity/meshing.md). +- [Decompilation and Rust research lab](docs/research-lab.md): the local game inspection workspace and the first research crates. +- [Decompilation status](docs/decompilation-status.md). +- [Java performance packs](docs/java-packs.md): the earlier, no longer developed Java track. + +## Project status + +Parity is **not** complete. The table below is the project's own audit of each subsystem. Still missing: the warden's brain and the sculk shrieker summoning it, villager breeding and gossip, spawned mob gear enchantments, the resource pack screen, a dedicated server mode, and worlds older than 1.17. + +### Java parity: 88% 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-10 against the code, not the docs. The harnesses that failed in the -previous audit (block updates, random ticks, redstone, command parsing, menu -clicks, whole chunks, entity models and item models) now pass; the save -round-trip harness has not been rerun. +2026-10-12 against the harness results: 270 harnesses pass. Two still differ +from vanilla in places: `mob_ai` (71 of 72 scenarios; a tempted ghastling) and +`sculk` (427 of 435; shrieker warnings and warden summoning). | Subsystem | Score | Main gaps | | --- | ---: | --- | -| Window, input and game loop | 0.75 | Game loop and options match vanilla; camera, auto-jump, toggle sprint/sneak and the frame limiter not compared | -| Assets and resources | 0.75 | Item models match vanilla over 196,290 stacks, but the client does not draw items through that pipeline yet; no pack screen | -| Network protocol and multiplayer | 0.75 | Opens worlds to LAN, but hosting is not tested against a vanilla client; no dedicated server mode | +| Window, input and game loop | 1 | None: the game loop, options, camera, auto-jump, toggle sprint/sneak, local input and the frame limiter match vanilla | +| Assets and resources | 0.75 | Item models match vanilla over 196,290 stacks and the client draws every item through them; no resource pack screen | +| Network protocol and multiplayer | 0.75 | Joins vanilla servers and opens worlds to LAN; server.properties, eula.txt and the user lists match vanilla, but there is no dedicated server mode and LAN hosting is not tested against a vanilla client | | Chunk storage and palettes | 1 | None: client and saves share paletted containers, identical to vanilla over 266 scenarios | | Section meshing | 1 | None: 112 scenes and over a million quads identical to vanilla | -| Rendering | 0.75 | Entity models match over 150 layers; block entity renderers and HUD overlays not compared | +| Rendering | 0.75 | Entity models, block entity renderers (400 cases, End portals and gateways included) and their animations (256 cases), the HUD overlays (2,200 states), the player list, subtitles and the world border match vanilla; the recipe book's drawing and the banner preview are not compared, and End gateways show no beam in game | | Lighting | 1 | None: saved and relit light matches vanilla, slabs and stairs included | | World generation | 1 | None: 2,352 whole chunks over 225 structure sites, in all three dimensions, identical to vanilla | -| Region files and saves | 0.75 | Saves round-trip with vanilla, and worlds from 1.18.2 to 26.2 upgrade as vanilla's DataFixers do over 22 sample worlds; worlds older than 1.18.2 are not upgraded | -| Entities and physics | 0.75 | Attributes, dimensions, death loot, spawn rules and natural spawning (15,500 NaturalSpawner cases) match; AI not compared; drowned, villagers, traders and the wither unverified | -| Interaction and inventory | 1 | None: menu clicks match over 6,000 click sequences | -| Menus, HUD and chat | 0.75 | Commands parse as vanilla over 39,685 inputs, but /item modify, /spectate, /waypoint and /dialog do not run; no tab list or world border rendering | -| Audio | 0.75 | Sound engine, music and ambience not compared with vanilla | -| Block behaviours and ticking | 0.75 | Block updates, random ticks, redstone and dispensers match vanilla; a container replaced by another block keeps its contents instead of spilling them, and there are no copper golems | +| Region files and saves | 0.75 | Saves round-trip with vanilla, and worlds from 1.17 to 26.2 upgrade as vanilla's DataFixers do; worlds older than 1.17 are not upgraded | +| Entities and physics | 0.75 | Attributes, dimensions, death loot, spawn rules, natural spawning (15,500 cases), raids and patrols (1,900 cases) and mob AI (71 of 72 scenarios, villager brains included) match; the warden's brain, villager breeding and gossip, and spawned mob gear are missing | +| Interaction and inventory | 1 | None: menu clicks match over 8,000 click sequences, the loom and the crafter included; recipe book placement (6,000 cases), its buttons (1,200), the saved book (1,500) and the loom and crafter screens (1,600) match vanilla | +| Menus, HUD and chat | 0.75 | Every command runs as vanilla (758 commands over 39,685 parsed inputs), scoreboards and teams match (81,000 operations), and the player list matches over 844,758 draw calls; the focused chat is not compared and player list heads use default skins | +| Audio | 1 | None: the sound engine, sound events, music, situational music, ambience and subtitles match vanilla | +| Block behaviours and ticking | 0.75 | Block updates, random ticks, redstone, dispensers (6,000 cases), crafters (4,000 crafts) and block entity removal (containers spill, 4,000 cases) match vanilla; 8 of 435 sculk scenarios differ (shrieker warnings and warden summoning) and the copper golem's chest sorting is not compared | -### Next steps +### What's new since the previous version -1. Upgrade saves older than 1.18.2 (the DataFixers before DataVersion 2970). -2. Draw every item through the item model pipeline, and add the resource pack screen. -3. An audio harness: sound engine attenuation, weighted sound events, music and ambience. -4. A mob AI harness, and an oracle for drowned, villagers, traders and the wither. -5. The missing commands, containers spilling when replaced, copper golems, the tab list and world border rendering. -6. Test LAN hosting with a vanilla client, and add a dedicated server mode. +- **Mob AI matches vanilla**, compared tick by tick in 72 scenarios, with villagers on a port of vanilla's brain (memories, sensors, schedules and behaviours). +- **New mobs:** the breeze and wind charges, the creaking and the creaking heart, the sniffer, the happy ghast and ghastlings, llamas and trader llamas, and the copper golem; the warden's model, animations and emissive layers. +- **Raids and pillager patrols**, with the Raid Omen, the waves and the Hero of the Village effect. +- **Dispensers, crafters, the loom and the recipe book**, and containers spill their items when their block is replaced. +- **Every command runs as vanilla**, including /item modify, /spectate, /waypoint, /dialog and /place. +- **Scoreboards and teams** in gameplay (criteria, friendly fire, collision, name tags), the **player list**, **subtitles**, every **HUD overlay**, **block entity animations** (chests, shulker boxes, bells, conduits, heads, the enchanting table's book) and **End portals and gateways** drawn with vanilla's shader. +- **Worlds from 1.17 onwards** open and are upgraded as vanilla does; server.properties, eula.txt and the server user lists are read and written as vanilla does. +- **Builds for Linux, macOS (Apple Silicon) and Windows.** + +### Known issues + +- **Render distance 2 never finishes loading:** a world opened with the render distance at 2 chunks stays on "Loading terrain…". Use a render distance of 3 or more (in Options > Video, or `--render-distance 12` on the command line). + +### Roadmap + +1. Fix loading at render distance 2; finish the warden's brain and the sculk shrieker summoning it, and the tempted ghastling. +2. Villager breeding and gossip, and spawned mob gear enchantments (both started on their branches). +3. A dedicated server mode, and LAN hosting tested with a vanilla client. +4. Save upgrades from before 1.17, and the resource pack screen. +5. Platform-independent float math, so every harness also gives vanilla's results on macOS. + +The rewrite is complete when it reaches one-to-one parity and packaged native builds pass the launch checks in [Rust rewrite status](docs/rust-parity.md#completion-criteria-and-playable-builds). + +### After the rewrite + +Once Horizon matches vanilla, the plan is to build on that exact base: + +- **Performance:** optimize the client and the server as far as they can go (rendering, chunk generation and meshing, memory, multithreaded ticking) while the differential harnesses keep gameplay identical to vanilla. +- **Modding support:** a stable API for writing mods against Horizon. +- **Agent control:** an MCP server and a CLI so AI agents and scripts can play and drive the game, growing out of today's `horizon-ctl` scripting socket. +- **Built-in recording:** capture gameplay video in a keypress, without external tools. +- **Automatic version updates:** a pipeline that ports each new Minecraft release on its own: compare the new version with the pinned one, regenerate the data, rewrite the changed parts and prove them with the same differential harnesses. + +## Contributing + +Issues and pull requests are welcome. Before opening a pull request, run the offline checks: ```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