c43f4bdb2b
Clean-room implementation from spec-lithostitched.md §3-§5 and spec-ctov.md §4. The game reads Lithostitched's processors as its data writes them (processor/litho.rs): block_swap (only the properties the new block can have: ripe wheat becomes ripe carrots, beetroot keeps its default age), reference, apply_random, condition (with else, one processor or a list), set_block (simple and weighted providers, preserve_state, block entity modifier) and discard_input; the conditions all_of, any_of, not, random_chance, true and matching_blocks (input or location, properties). Their random follows random_mode per block or per piece; Lithostitched's own seeding is open (OPEN-L6), so a positional random of the world seed and the processor stands in (impl-questions IQ-7). horizon-port-pack's new lithostitched module carries the processors as they are, with the processors nested in them carried, drops those the game cannot read (lists named by tag, other providers) as Java processors, turns CTOV's modular_compat into a reference when its mod is ported along (else nothing), maps lithostitched:jigsaw to vanilla's jigsaw (vanilla layouts, the decision on OPEN-L5), unwraps limited/guaranteed/delegating elements to their delegate (limits counted as lost until the next PR) and writes add_template_pool_elements modifiers as horizon:add_to pools when their NeoForge load conditions pass. Deleted unread: legacy_structure_mods/lithostitched.rs and horizon-world's structure/processor/lithostitched.rs. Blind edits to the legacy folder, located by exact text or the compiler's error position: its module line removed, dead_code allowed on ctov (its modular compat is unused now) and on a test helper, and ctov's modular compat test ignored. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Horizon documentation
To play, use the launcher; the project site is playhorizon.dev. These pages are for developers.
Build and run
- AGENTS.md and Architecture: where each part of the code lives, how
Gameis organised, which harness checks which area. - Build from source: your own copy of the game, resource preparation,
cargo run. - Native client: options, controls, the dedicated server,
horizon-ctlscripting, packaging, architecture. - Host a server: install
horizon-server, prepare the game files, first run,server.toml, the commands, the web panel, backups, services and Docker; what works today and what doesn't yet. - Hosting a server: design:
horizon-server, the design and the plan: install,server.toml, the CLI, the web panel, backups, services, Docker, and the bot benchmark against vanilla. - Agent control: what AI agents can drive in the launcher and the game, and the design of the control socket,
horizon-ctland MCP. - Graphics: the Simple and Advanced graphics settings, the graphics benchmark and what it measured.
- Benchmark: Horizon against vanilla 26.3 and vanilla with performance mods, on the same machine, world, path and settings: what is measured, how it is kept fair, how to reproduce it.
- Extras: optional zoom, minimap, FPS and keystroke overlays and auto-reconnect, all off by default.
- Mods: Horizon's own mod system (Rust, sandboxed WebAssembly), how to make and install mods.
- Modpacks: porting whole packs (ATM10 and smaller): import, inventory, carry-over, an agent per mod with a harness against the Java original, coverage, and how "10x" is measured.
- Launcher: installs, updates and starts builds; its CLI and MCP server; releasing it.
- Versioning: how releases are numbered from 0.2 (
v0.2.x,launcher@0.2.x), how installs from before 0.2 get there, and the steps for the day 0.2 ships. - Resource packs: everything a 26.3 resource pack can change, whether Horizon honours it, and the proof.
- Opt-in data collection: the consent, exactly what is sent, how it is stored and sent.
- Benchmark report format: the versioned JSON every benchmark writes (game, launcher,
tools/perf_bench.py), the local log and, with consent, the upload. - Horizon APIs: every surface other programs build on (mods, shaders, agent control, servers, the launcher, data formats), each with its guide, generated reference, stability and changelog, and the stability and versioning policy.
- Menus: every screen is vanilla's (title, world list, create world, multiplayer, options, pause). Horizon's own settings hang off vanilla's Options the way mods add theirs: Horizon Settings... and Mods... in the last two slots of the Options grid (Horizon Settings opens Graphics, Advanced Graphics, Controller Settings, Extras and Mods, each a vanilla options list), with Horizon Graphics and Advanced Graphics also at the top of Video Settings and Controller Settings at the bottom of Controls. The title screen's and pause menu's Friends buttons open Join a Friend and Play with Friends (play-with-friends.md).
Parity
- Rust rewrite status: completion criteria, how to reproduce the validation, and per-area scope.
- Parity workflow:
tools/parity.py, the gate, other machines, merging. - Area notes: block behaviours and ticking, section meshing.
- Version ports: how a new Minecraft release is detected, diffed against the pinned one and ported, and what stays manual.
- Decompilation and research lab and decompilation status: the local game inspection workspace the harnesses build on.
Architecture: world generation
- World generation: the pipeline from noise to features.
- Noise generation, compiled density functions, structure density, terrain filling.
- Biomes: lookup, temperatures.
- Surfaces: material surfaces, material conditions, rule libraries, vertical anchors, value providers.
- Carving, heightmaps, feature placement.
Architecture: world data and simulation
- World data: chunk storage, palettes, region files.
- Block-state codecs, scheduled ticks.
- Collision geometry: shapes, collision, movement and fluids.
- Face visibility: which model faces the mesher emits.