diff --git a/.gitattributes b/.gitattributes
new file mode 100644
index 000000000..358aeae7a
--- /dev/null
+++ b/.gitattributes
@@ -0,0 +1,6 @@
+# Generated files that tests compare byte for byte with what they generate: LF on every OS, also
+# where Git for Windows' core.autocrlf would check them out with CRLF.
+docs/launcher-commands.md text eol=lf
+docs/horizon-ctl-commands.md text eol=lf
+website/src/tokens.css text eol=lf
+docs/api/*-reference.md text eol=lf
diff --git a/.githooks/pre-push b/.githooks/pre-push
index a886ccf0c..d067dd226 100755
--- a/.githooks/pre-push
+++ b/.githooks/pre-push
@@ -1,2 +1,2 @@
#!/bin/sh
-exec python3 tools/check_public_tree.py --history
+exec python3 tools/check_public_tree.py --pre-push
diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS
index 8d8687753..5567eb184 100644
--- a/.github/CODEOWNERS
+++ b/.github/CODEOWNERS
@@ -6,7 +6,6 @@
/.github/ @ludovic111
/tools/ci/ @ludovic111
/tools/release_train.py @ludovic111
-/tools/release_channels.py @ludovic111
/crates/horizon-release-sign/ @ludovic111
/crates/horizon-server/src/update.rs @ludovic111
/crates/horizon-server/Cargo.toml @ludovic111
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 8966854c2..eff82fa99 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -3,7 +3,8 @@ name: checks
# check main requires, so it never has a condition: a skipped job counts as passed, and every run of this workflow
# must report a real verify (a pull request that changes no Rust finishes it in seconds instead).
# parity: the vanilla harnesses a pull request's changes can affect, on the Mac mini's runner, which holds the
-# maintainer's own Minecraft files (Horizon never downloads the game); .github/workflows/parity.yml. A fork's pull
+# maintainer's own Minecraft files (Horizon never downloads the game); .github/workflows/parity.yml. Only for a pull
+# request that changes a harness, oracle, probe or the runner: the rest are checked on main by parity-main. A fork's pull
# request runs it only when a maintainer adds the run-parity label (.github/workflows/run-parity.yml), so labels
# never start this workflow. See docs/release-flow.md.
on:
@@ -61,14 +62,48 @@ jobs:
if: steps.rust.outputs.required != 'false'
run: |
cargo +stable fmt --all -- --check
- cargo +stable clippy --workspace --all-targets -- -D warnings
+ # With the game's code mods (on in every release build, off by default).
+ cargo +stable clippy --workspace --all-targets --features horizon-client/mods -- -D warnings
# The server build (released as horizon-engine): the game without sound or controllers.
cargo +stable clippy -p horizon-client --all-targets --no-default-features -- -D warnings
+ # Libraries, binaries and integration tests, then doc tests: not the ~275 examples, which clippy above already
+ # type-checks and the parity job builds and runs (they were most of this step's build and link time).
- name: Test Rust core and voxel kernel correctness
if: steps.rust.outputs.required != 'false'
- run: cargo +stable test --workspace
- parity:
+ run: |
+ cargo +stable test --workspace --lib --bins --tests --features horizon-client/mods,horizon-mods/pack
+ cargo +stable test --workspace --doc --features horizon-client/mods,horizon-mods/pack
+ # Most pull requests leave the harnesses to parity-main, which runs them on main a batch of merges at a time
+ # (.github/workflows/parity-main.yml; releases wait for it). A pull request still runs them itself when it changes
+ # a harness, an oracle, a probe or the runner, or carries the run-parity label (run-parity.yml, when it is added).
+ parity-scope:
if: github.event_name == 'pull_request' && github.event.pull_request.head.repo.full_name == github.repository
+ runs-on: ubuntu-latest
+ outputs:
+ run: ${{ steps.scope.outputs.run }}
+ steps:
+ - uses: actions/checkout@v4
+ with:
+ ref: ${{ github.event.pull_request.head.sha }}
+ fetch-depth: 0
+ persist-credentials: false
+ - id: scope
+ env:
+ BASE_SHA: ${{ github.event.pull_request.base.sha }}
+ LABELS: ${{ join(github.event.pull_request.labels.*.name, ' ') }}
+ run: |
+ changed=$(git diff --name-only "$(git merge-base "$BASE_SHA" HEAD)" HEAD)
+ harness=$(grep -E '^(tools/test_[a-z0-9_]+_parity\.py|tools/(parity[a-z_]*|lab)\.py|tools/parity_hosts\.json|mods/horizon/src/test/|crates/[^/]+/examples/|crates/horizon-client/src/game/[a-z_]*(fixture|harness)\.rs|\.github/workflows/parity[a-z-]*\.yml)' <<< "$changed" || true)
+ if [ -n "$harness" ] || [[ " $LABELS " == *" run-parity "* ]]; then
+ echo "run=true" >> "$GITHUB_OUTPUT"
+ echo "The pull request runs its harnesses: ${harness:-label run-parity}"
+ else
+ echo "run=false" >> "$GITHUB_OUTPUT"
+ echo "No harness, oracle, probe or runner change: parity-main checks this on main"
+ fi
+ parity:
+ needs: parity-scope
+ if: needs.parity-scope.outputs.run == 'true'
uses: ./.github/workflows/parity.yml
with:
base: ${{ github.event.pull_request.base.sha }}
@@ -425,7 +460,7 @@ jobs:
env:
RUSTUP_TOOLCHAIN: stable
run: python tools/test_float_log_parity.py
- portable-mod:
+ jfr-analysis:
if: github.event_name == 'workflow_dispatch'
runs-on: [self-hosted, linux, horizon-game]
steps:
@@ -437,101 +472,7 @@ jobs:
with:
distribution: temurin
java-version: '25'
- - name: Compile original mod and test metrics
- run: python tools/build_mod.py
- name: Verify streaming JFR analysis against the JDK exporter
run: python tools/test_jfr.py
- name: Verify ZGC pause and allocation event interpretation
run: python tools/test_jfr.py --gc zgc
- - name: Build pinned portable packs
- run: python tools/build_pack.py
- - name: Measure isolated worker pacing on this platform
- run: python -c "from tools.build_mod import benchmark_workers; benchmark_workers()"
- - name: Measure isolated debounce queue polling
- run: python -c "from tools.build_mod import benchmark_debounce; benchmark_debounce()"
- - name: Measure wakeable idle queue latency
- run: python -c "from tools.build_mod import benchmark_idle; benchmark_idle()"
- - name: Measure object allocations with compact headers off and on
- run: python -c "from tools.build_mod import benchmark_headers; benchmark_headers()"
- - name: Test pack integrity and comparisons
- run: python -m unittest discover -s tests -v
- - name: Start recommended OpenGL macOS clients and verify framebuffer readback
- if: runner.os == 'macOS'
- run: |
- python tools/test_client_graphics.py --native-display
- cp dist/client-graphics-smoke.json dist/client-graphics-macos-title.json
- python tools/test_client_graphics.py --native-display --world
- cp dist/client-graphics-smoke.json dist/client-graphics-macos-world.json
- - name: Compile the private dispatch fixture
- run: python -c "from tools.build_mod import build_dispatch_fixture; build_dispatch_fixture()"
- - name: Compile the private integrated-server graphics fixture
- run: python -c "from tools.build_mod import build_integration_fixture; build_integration_fixture('server-graphics', 'dev.horizonlab.metrics.ServerGraphicsIntegration', fixture_dependencies={})"
- - name: Compile the private tick-manager state fixture
- run: python -c "from tools.build_mod import build_integration_fixture; build_integration_fixture('tick-state', 'dev.horizonlab.metrics.TickStateIntegration')"
- - name: Compile the private terrain tick membership fixture
- run: python -c "from tools.build_mod import build_tick_dedup_fixture; build_tick_dedup_fixture()"
- - name: Compile the private culling whitelist fixture
- run: python -c "from tools.build_mod import build_culling_empty_fixture; build_culling_empty_fixture()"
- - name: Compile the private culling ray geometry fixture
- run: python -c "from tools.build_mod import build_integration_fixture; build_integration_fixture('culling-rays', 'dev.horizonlab.dispatch.CullingRayIntegration', ['entityculling'], ['CullingRayAccess'])"
- - name: Compile the private terrain position lookup fixture
- run: python -c "from tools.build_mod import build_integration_fixture; build_integration_fixture('terrain-position', 'dev.horizonlab.dispatch.PositionIntegration')"
- - name: Compile the private terrain quad reuse fixture
- run: python -c "from tools.build_mod import build_integration_fixture; build_integration_fixture('quad-reuse', 'dev.horizonlab.dispatch.QuadReuseIntegration')"
- - name: Compile the private object-size agent and terrain quad fixture
- run: python -c "from tools.test_quad_sizes import build_agent; from tools.build_mod import build_integration_fixture; build_agent(); build_integration_fixture('quad-size', 'dev.horizonlab.dispatch.QuadSizeIntegration')"
- - name: Compile the private terrain read shutdown fixture
- run: python -c "from tools.build_mod import build_integration_fixture; build_integration_fixture('terrain-read', 'dev.horizonlab.dispatch.TerrainReadIntegration')"
- - name: Install headless graphics libraries for applied-hook checks
- if: runner.os == 'Linux'
- run: sudo apt-get update && sudo apt-get install -y xvfb libgl1 libegl1 libvulkan1 mesa-vulkan-drivers libasound2t64 libxkbcommon0
- - name: Verify integrated-server graphics report against the actual device
- run: python tools/test_server_graphics.py ${{ runner.os == 'macOS' && '--native-display' || '' }}
- - name: Exercise the applied dispatcher hooks and upstream rejection path
- if: runner.os == 'Linux'
- run: python tools/test_dispatch.py
- - name: Verify applied tick membership transitions and allocation
- if: runner.os == 'Linux'
- run: python tools/test_tick_dedup.py
- - name: Verify live culling whitelist registration and empty iteration
- if: runner.os == 'Linux'
- run: python tools/test_culling_empty.py
- - name: Compare applied culling ray geometry and provider queries
- if: runner.os == 'Linux'
- run: python tools/test_culling_rays.py
- - name: Verify actual full-data position lookup equivalence
- if: runner.os == 'Linux'
- run: python tools/test_terrain_position.py
- - name: Verify actual terrain quad geometry and allocation
- if: runner.os == 'Linux'
- run: python tools/test_quad_reuse.py
- - name: Measure actual builder and quad shallow sizes in both header modes
- if: runner.os == 'Linux'
- run: python tools/test_quad_sizes.py
- - name: Verify interrupted DH reads and preserved shared futures
- if: runner.os == 'Linux'
- run: python tools/test_terrain_read.py
- - name: Upload original mod and pack manifests only
- uses: actions/upload-artifact@v4
- with:
- name: horizon-linux
- path: |
- dist/*.mrpack
- dist/horizon-*.jar
- dist/worker-pacing-benchmark.txt
- dist/debounce-queue-benchmark.txt
- dist/idle-queue-benchmark.txt
- dist/object-header-benchmark.txt
- dist/dispatch-integration.json
- dist/tick-dedup-integration.json
- dist/culling-empty-integration.json
- dist/terrain-read-integration.json
- dist/culling-rays-integration.json
- dist/terrain-position-integration.json
- dist/quad-reuse-integration.json
- dist/quad-size-integration.json
- dist/server-graphics-smoke.json
- dist/client-graphics-smoke.json
- dist/client-graphics-macos-title.json
- dist/client-graphics-macos-world.json
- retention-days: 3
diff --git a/.github/workflows/mod-registry.yml b/.github/workflows/mod-registry.yml
new file mode 100644
index 000000000..0f252bb68
--- /dev/null
+++ b/.github/workflows/mod-registry.yml
@@ -0,0 +1,34 @@
+name: mod-registry
+# The submission service is its own workspace (crates/horizon-mod-registry), so the checks job doesn't build
+# it: this one does, when it or horizon-mods (the checks it shares with the launcher and the game) changes.
+on:
+ push:
+ branches: [main]
+ paths:
+ - 'crates/horizon-mods/**'
+ - 'crates/horizon-mod-registry/**'
+ - '.github/workflows/mod-registry.yml'
+ pull_request:
+ paths:
+ - 'crates/horizon-mods/**'
+ - 'crates/horizon-mod-registry/**'
+ - '.github/workflows/mod-registry.yml'
+permissions:
+ contents: read
+jobs:
+ check:
+ runs-on: ubuntu-latest
+ timeout-minutes: 20
+ defaults:
+ run:
+ working-directory: crates/horizon-mod-registry
+ steps:
+ - uses: actions/checkout@v4
+ - run: rustup toolchain install stable --profile minimal --component rustfmt --component clippy
+ - uses: Swatinem/rust-cache@v2
+ with:
+ workspaces: crates/horizon-mod-registry
+ save-if: ${{ github.ref == 'refs/heads/main' }}
+ - run: cargo +stable fmt --check
+ - run: cargo +stable clippy --all-targets --locked -- -D warnings
+ - run: cargo +stable test --locked
diff --git a/.github/workflows/parity-main.yml b/.github/workflows/parity-main.yml
new file mode 100644
index 000000000..1ddfb24bb
--- /dev/null
+++ b/.github/workflows/parity-main.yml
@@ -0,0 +1,70 @@
+name: parity-main
+# The vanilla harnesses on main, a batch of merges at a time (docs/release-flow.md#parity-on-main), on the Mac mini's
+# runner. One run at a time: merges that land while a run goes on wait in one pending run (GitHub keeps only the
+# newest), which checks every merge since main's last green parity-main (tools/parity_main.py base). On a failure it
+# bisects the failing harnesses over those merges and comments on the pull request that broke them. Releases ship
+# only a commit whose parity-main passed (tools/release_train.py), so nothing a harness catches reaches players.
+on:
+ push:
+ branches: [main]
+ workflow_dispatch:
+permissions:
+ contents: read
+ # The comment on the merge that broke a harness.
+ pull-requests: write
+ # tools/parity_main.py base reads earlier runs.
+ actions: read
+concurrency:
+ group: parity-main
+ cancel-in-progress: false
+env:
+ # Test runs never reach the telemetry server: no live-count ping, no uploads (docs/telemetry.md).
+ HORIZON_TELEMETRY_URL: "off"
+
+jobs:
+ parity-main:
+ runs-on: [self-hosted, horizon-game]
+ timeout-minutes: 240 # a core-crate batch reruns ~300 harnesses (~60-90 min), a bisect a few rounds of the failures
+ steps:
+ - uses: actions/checkout@v4
+ with:
+ ref: ${{ github.sha }}
+ fetch-depth: 0
+ persist-credentials: false
+ # Keeps .local/ (parity state, probe builds, oracle results) and target/ between runs.
+ clean: false
+ - uses: dtolnay/rust-toolchain@stable
+ - name: Tools from the runner
+ run: bash tools/ci/runner-env.sh
+ - name: Vanilla data, and resources prepared by this preparer
+ run: bash tools/ci/vanilla-data.sh
+ - name: Main's last green parity-main
+ id: base
+ env:
+ GH_TOKEN: ${{ github.token }}
+ run: echo "sha=$(python3 tools/parity_main.py base)" >> "$GITHUB_OUTPUT"
+ - name: The harnesses the merges since then can affect
+ env:
+ PARITY_HOSTS: ''
+ BASE_SHA: ${{ steps.base.outputs.sha }}
+ run: |
+ echo "Merges since ${BASE_SHA}:"
+ git log --first-parent --format=' %h %s' "$BASE_SHA..HEAD"
+ python3 tools/parity.py --changed "$BASE_SHA" --timeout 2400
+ - name: The merge that broke them
+ if: failure()
+ env:
+ GH_TOKEN: ${{ github.token }}
+ PARITY_HOSTS: ''
+ BASE_SHA: ${{ steps.base.outputs.sha }}
+ run: |
+ rm -rf .local/parity-main-logs && cp -R .local/parity-runner/logs .local/parity-main-logs 2>/dev/null || true
+ python3 tools/parity_main.py bisect "$BASE_SHA" --comment
+ - name: Logs of the failed harnesses
+ if: failure()
+ uses: actions/upload-artifact@v4
+ with:
+ name: parity-main-logs
+ path: .local/parity-main-logs/
+ if-no-files-found: ignore
+ retention-days: 7
diff --git a/.github/workflows/parity.yml b/.github/workflows/parity.yml
index a18fc5019..577380338 100644
--- a/.github/workflows/parity.yml
+++ b/.github/workflows/parity.yml
@@ -37,13 +37,56 @@ jobs:
run: bash tools/ci/runner-env.sh
- name: Vanilla data, and resources prepared by this preparer
run: bash tools/ci/vanilla-data.sh
+ - name: The prepared output is the one the preparer's OUTPUT_VERSION says
+ env:
+ BASE_SHA: ${{ inputs.base }}
+ run: python3 tools/prepare_output.py check --cache --base "$BASE_SHA"
- name: The version constants are the pinned jar's
run: python3 tools/gen_version_consts.py --check
- name: The harnesses this change can affect
env:
PARITY_HOSTS: ''
BASE_SHA: ${{ inputs.base }}
- run: python3 tools/parity.py --changed "$BASE_SHA" --timeout 2400 # world_spawn takes ~1480 s on a busy runner
+ run: |
+ # main's selection (tools/parity.py --changed --list with main's parity.py and parity_reach.py), so a
+ # branch made before a better selection landed gets it too; the head's own runner then runs those
+ # harnesses. A branch that changes the selection itself selects with its own code.
+ set -euo pipefail
+ own() { python3 tools/parity.py --changed "$BASE_SHA" --timeout 2400; } # world_spawn takes ~1480 s on a busy runner
+ fork_point=$(git merge-base "$BASE_SHA" HEAD)
+ if ! git rev-parse --verify -q origin/main >/dev/null || ! git diff --quiet "$fork_point" HEAD -- tools/parity.py tools/parity_reach.py; then
+ own
+ exit
+ fi
+ had_reach=$(git ls-files tools/parity_reach.py)
+ git show origin/main:tools/parity.py > tools/parity.py
+ git show origin/main:tools/parity_reach.py > tools/parity_reach.py
+ status=0
+ python3 tools/parity.py --changed "$BASE_SHA" --list > .local/parity-selection.txt || status=$?
+ git checkout -- tools/parity.py
+ if [ -n "$had_reach" ]; then git checkout -- tools/parity_reach.py; else rm -f tools/parity_reach.py; fi
+ cat .local/parity-selection.txt
+ if [ "$status" != 0 ]; then
+ echo "main's selection failed: the head's own selection runs"
+ own
+ exit
+ fi
+ names=$(sed '$d' .local/parity-selection.txt | grep -E '^[A-Za-z0-9_#]+$' || true)
+ # The summary line says how many would run: a count that doesn't match the names read (a format change)
+ # must not let the job pass untested.
+ expected=$(tail -1 .local/parity-selection.txt | sed -nE 's/^([0-9]+) of [0-9]+ harnesses would run$/\1/p')
+ count=$(printf '%s' "$names" | grep -c . || true)
+ if [ -z "$expected" ] || [ "$expected" != "$count" ]; then
+ echo "main's selection listed $count names, its summary says '${expected:-?}': the head's own selection runs"
+ own
+ exit
+ fi
+ if [ "$count" = 0 ]; then
+ echo "Nothing to run."
+ exit 0
+ fi
+ # shellcheck disable=SC2086
+ python3 tools/parity.py $names --timeout 2400
- name: Logs of the failed harnesses
if: failure()
uses: actions/upload-artifact@v4
diff --git a/.github/workflows/promote.yml b/.github/workflows/promote.yml
deleted file mode 100644
index 3966f571b..000000000
--- a/.github/workflows/promote.yml
+++ /dev/null
@@ -1,55 +0,0 @@
-name: promote
-# Beta game releases become stable once a day (docs/release-flow.md, "Channels"): at 20:00 UTC (21:00 in Paris in
-# winter time, 22:00 in summer) tools/release_channels.py promotes the newest beta that had been out 6 hours by then,
-# passed its release smoke test and isn't covered by an issue labelled release-blocker. Launchers on the Alpha
-# channel install every beta when it is published; Stable gets the day's promotion. The later runs of the evening are
-# retries for a run GitHub starts late or skips: they promote the same beta, so stable still moves once.
-# By hand, from GitHub's app too (Actions > promote > Run workflow):
-# gh workflow run promote -f tag=v0.2.3 # that beta now, without waiting for 20:00
-# gh workflow run promote -f tag=v0.2.3 -f force=true # even blocked or without its smoke test
-# gh workflow run promote -f dry_run=true # say what would be promoted
-# Holding betas back: label an issue release-blocker. While it is open it holds every beta; closed as completed it
-# still holds the betas published before it closed. The issue's text is never read (its author could edit it).
-# When the oldest waiting beta is 30 hours old (it missed a promotion it was due for), an issue "Promotion to stable
-# has stalled" says so; it closes itself after the next promotion.
-on:
- schedule:
- - cron: '7,37 20-21 * * *'
- workflow_dispatch:
- inputs:
- tag:
- description: The beta to promote now (empty = the newest beta that is due)
- type: string
- default: ''
- force:
- description: Promote that tag even if a release-blocker covers it or its smoke test didn't run
- type: boolean
- default: false
- dry_run:
- description: Say what would be promoted, change nothing
- type: boolean
- default: false
-permissions:
- contents: write
- issues: write
-concurrency:
- group: promote
- cancel-in-progress: false
-jobs:
- promote:
- runs-on: ubuntu-latest
- timeout-minutes: 10
- steps:
- - uses: actions/checkout@v4
- with:
- # The notes of a promoted release cover every pull request since the last stable one.
- fetch-depth: 0
- # gh uses GH_TOKEN below; nothing needs git credentials on disk.
- persist-credentials: false
- - name: Promote
- env:
- GH_TOKEN: ${{ github.token }}
- TAG: ${{ inputs.tag }}
- FORCE: ${{ inputs.force && 'yes' || '' }}
- DRY_RUN: ${{ (inputs.dry_run || github.ref != 'refs/heads/main') && 'yes' || '' }}
- run: python3 tools/release_channels.py promote ${TAG:+--tag "$TAG"} ${FORCE:+--force} ${DRY_RUN:+--dry-run}
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index b19ba9ce5..05f590096 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -1,21 +1,26 @@
name: release
# Automatic game releases (docs/release-flow.md). After every green `checks` run on main, every 10 minutes (so a
-# release waiting for merges to settle goes out without another merge) and by hand, tools/release_train.py decides:
-# a release when pull requests merged since the last one changed what players run and the newest merged 5 minutes
-# ago (the oldest 20 minutes ago, if merges never pause), or at once for a pull request labelled release-now.
-# RELEASES_PAUSED=1 (repository variable) stops them.
+# release waiting for merges to settle goes out without another merge) and by hand, tools/release_train.py decides,
+# for a commit whose checks and parity-main (the vanilla harnesses on main) both passed:
+# a release when 5 pull requests merged since the last one changed what players run and the newest merged 5 minutes
+# ago, or when the oldest has waited 6 hours, or at once for a pull request labelled release-now.
+# RELEASES_PAUSED=1 (repository variable) stops them; so does an open issue labelled release-blocker, forced runs too.
# Builds Linux (an older Ubuntu, so the binary runs on any recent distribution and on NixOS through nix-ld) and
# Windows on GitHub, macOS on the Mac mini's runner (MAC_RUNNER=macos-latest sends it to GitHub), then
# publishes vX.Y.Z on the release line in .github/release-line.txt (docs/versioning.md; without it, the dated
-# vYYYY.MM.DD[.N] from before 0.2) with notes from the merged pull requests, as a beta (a pre-release) that promote.yml makes
-# stable in its daily promotion. macOS: with the repository variable MACOS_SIGN_IDENTITY set, the programs are signed with
+# vYYYY.MM.DD[.N] from before 0.2) with notes from the merged pull requests, as the release and GitHub's latest: one
+# channel, which launchers, `horizon-server update` and install.sh follow at once. So it is published only after the
+# checks that used to gate a promotion pass in this run: the Mac mini's smoke test drew a world, and no release-blocker
+# is open (tools/release_train.py gate); otherwise nothing is published. macOS: with the repository variable
+# MACOS_SIGN_IDENTITY set, the programs are signed with
# Developer ID and the hardened runtime and the zip is notarized, from the runner's signing keychain
# (packaging/macos/README.md); unset (forks), ad hoc.
# gh workflow run release --ref # dry run: builds and notes, publishes nothing
# gh workflow run release -f dry_run=false -f force=true # on main: release now, whatever the rules say
on:
workflow_run:
- workflows: [checks]
+ # A game release ships a commit both passed on (parity-main runs on batches: the newest commit it passed on).
+ workflows: [checks, parity-main]
types: [completed]
branches: [main]
schedule:
@@ -32,6 +37,8 @@ on:
default: false
permissions:
contents: read
+ # The open release-blocker issues (decide).
+ issues: read
concurrency:
group: game-release
cancel-in-progress: false
@@ -59,8 +66,8 @@ jobs:
env:
GH_TOKEN: ${{ github.token }}
RELEASES_PAUSED: ${{ vars.RELEASES_PAUSED }}
- # The commit whose checks just passed; a dry run builds the branch it was started on; otherwise
- # main's newest commit with green checks.
+ # The commit whose checks or parity-main just passed; a dry run builds the branch it was started on;
+ # otherwise main's newest commit with green checks and parity-main.
HEAD_SHA: ${{ github.event.workflow_run.head_sha || (steps.mode.outputs.dry_run == 'true' && github.sha) || '' }}
FORCE: ${{ inputs.force && 'yes' || '' }}
run: |
@@ -128,7 +135,8 @@ jobs:
if: runner.os == 'Linux'
run: sudo apt-get update && sudo apt-get install -y --no-install-recommends libasound2-dev libudev-dev
- name: Build the client, horizon-ctl, horizon-prepare and horizon-server
- run: cargo build --release --locked -p horizon-client --bin horizon-client --bin horizon-ctl -p horizon-prepare --bin horizon-prepare -p horizon-server --bin horizon-server
+ # `horizon-client/mods`: every released game runs code mods (the feature is off in dev builds).
+ run: cargo build --release --locked --features horizon-client/mods -p horizon-client --bin horizon-client --bin horizon-ctl -p horizon-prepare --bin horizon-prepare -p horizon-server --bin horizon-server
- name: Every program the release folder takes was built
run: |
for binary in horizon-client horizon-ctl horizon-prepare horizon-server; do
@@ -203,7 +211,7 @@ jobs:
or not report.get("meshed_sections") or not report.get("player"):
sys.exit("the smoke run did not draw a world")
EOF
- # Published with the release: a beta becomes stable only with it (tools/release_channels.py).
+ # Published with the release; the publish job checks it again before it publishes anything.
cp "$home/smoke.json" "$RUNNER_TEMP/smoke-test.json"
- uses: actions/upload-artifact@v4
if: runner.environment == 'self-hosted'
@@ -250,8 +258,9 @@ jobs:
run: |
set -euo pipefail
# After the client is packaged: target/release/horizon-client is rebuilt without the audio and
- # controllers features, so it needs neither libasound nor libudev (minimal server images lack them).
- cargo build --release --locked -p horizon-client --no-default-features --bin horizon-client
+ # controllers features, so it needs neither libasound nor libudev (minimal server images lack them),
+ # and with code mods like the client.
+ cargo build --release --locked -p horizon-client --no-default-features --features mods --bin horizon-client
cargo run --locked -p xtask -- package-server target/release/horizon-client "dist/${{ matrix.server_dir }}"
folder="dist/${{ matrix.server_dir }}"
python3 tools/check_imports.py --server "$folder/horizon-engine" "$folder/horizon-server" "$folder/horizon-prepare"
@@ -319,6 +328,7 @@ jobs:
timeout-minutes: 15
permissions:
contents: write
+ issues: read
steps:
- uses: actions/checkout@v4
with:
@@ -341,6 +351,17 @@ jobs:
run: |
key=(); [[ -n "$EPHEMERAL" ]] && key=(--key "$(cat dist/ephemeral.pub)")
cargo run --locked --quiet -p horizon-release-sign -- verify --tag "$TAG" --publishing "${key[@]}" dist
+ - name: Ready to publish (the smoke test passed, no release-blocker is open)
+ # Right before publishing: an issue labelled while the builds ran still holds this release. A dry run only
+ # reports what a real run would do.
+ env:
+ GH_TOKEN: ${{ github.token }}
+ DRY_RUN: ${{ needs.decide.outputs.dry_run }}
+ run: |
+ if ! python3 tools/release_train.py gate --kind game --smoke dist/smoke-test.json --blockers; then
+ [[ "$DRY_RUN" == true ]] || { echo "::error::Nothing published"; exit 1; }
+ echo "::warning::A real run would publish nothing"
+ fi
- name: Publish ${{ needs.decide.outputs.tag }}
if: needs.decide.outputs.dry_run != 'true'
env:
@@ -348,17 +369,20 @@ jobs:
TAG: ${{ needs.decide.outputs.tag }}
run: |
signature=(); [[ -f dist/SHA256SUMS.sig ]] && signature=(dist/SHA256SUMS.sig)
- smoke=(); [[ -f dist/smoke-test.json ]] && smoke=(dist/smoke-test.json)
- # A beta (pre-release), the Alpha channel's: promote.yml makes it stable and latest in its daily promotion
- # (docs/release-flow.md).
+ # The release and the latest at once: there is one channel (docs/release-flow.md). Each archive gets a
+ # label (file#label), which GitHub's page shows instead of the file name, so nobody takes the game's
+ # files for the download (#1647). Launchers, servers and install.sh match the name, which stays.
gh release create "$TAG" --target "${{ needs.decide.outputs.head }}" --title "$(cat notes/title.txt)" \
- --notes-file notes/body.md --prerelease --latest=false dist/horizon-linux-x86_64.tar.gz \
- dist/horizon-windows-x64.zip dist/horizon-macos-arm64.zip dist/horizon-server-linux-x86_64.tar.gz \
- dist/SHA256SUMS "${signature[@]}" "${smoke[@]}"
+ --notes-file notes/body.md --latest \
+ "dist/horizon-linux-x86_64.tar.gz#Game files the launcher installs: Linux (horizon-linux-x86_64.tar.gz)" \
+ "dist/horizon-windows-x64.zip#Game files the launcher installs: Windows (horizon-windows-x64.zip)" \
+ "dist/horizon-macos-arm64.zip#Game files the launcher installs: macOS (horizon-macos-arm64.zip)" \
+ "dist/horizon-server-linux-x86_64.tar.gz#Dedicated server for Linux (horizon-server-linux-x86_64.tar.gz)" \
+ dist/SHA256SUMS "${signature[@]}" dist/smoke-test.json
- name: Dry run, the release that would be published
if: needs.decide.outputs.dry_run == 'true'
run: |
- echo "Would publish ${{ needs.decide.outputs.tag }} at ${{ needs.decide.outputs.head }}: $(cat notes/title.txt)"
+ echo "Would publish ${{ needs.decide.outputs.tag }} at ${{ needs.decide.outputs.head }} as the release and latest: $(cat notes/title.txt)"
ls -l dist
- uses: actions/upload-artifact@v4
with:
diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 000000000..549fa5c7f
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,178 @@
+# Horizon: a map for agents
+
+Minecraft: Java Edition 26.3 rewritten in Rust (wgpu). Vanilla is the specification wherever it has the
+feature. Read [CONTRIBUTING.md](CONTRIBUTING.md) once; this page tells you where things are.
+Feature → files → harness for the most-changed areas: [docs/architecture.md](docs/architecture.md).
+
+## Rules that bite
+
+- **Never commit Mojang's files**: game jars, assets, decompiled source, prepared resources (`.local/`).
+ `tools/check_public_tree.py` rejects them; `git config core.hooksPath .githooks` runs it on commit.
+- **Keep your runs away from real player data.** Any game or launcher you start gets fresh `mktemp -d`
+ folders in `HORIZON_HOME` (the game's data), `HORIZON_LAUNCHER_HOME`, `XDG_DATA_HOME` and
+ `XDG_CONFIG_HOME`, plus `HORIZON_LAUNCHER_NO_SELF_UPDATE=1` and `HORIZON_NO_AUDIO=1`. Never write to
+ `~/.local/share/{applications,horizon,horizon-launcher}` or `~/.local/bin`.
+- **Mark what an agent posts.** A PR body starts with a line naming whose agent opened it and with what.
+ Ludovic's agents write `> 🤖 Opened by Ludovic's AI agent (Claude), not by Ludovic himself.`, and a
+ contributor's agent names its own person and tool (issues: "Filed by", reviews: "Review by"). Every
+ comment starts with `🤖 Agent:`. Never write as Ludovic or as anyone else.
+- **Attribution.** Commits end with a `Co-Authored-By:` line for the agent that wrote them, and PR bodies
+ with that agent's own "Generated with" line. Ludovic's agents use
+ `Co-Authored-By: Claude ` and
+ `🤖 Generated with [Claude Code](https://claude.com/claude-code)`.
+- Everything players run is Rust. Python/Java only for dev tools and harness drivers in `tools/`.
+- Horizon-only features follow [docs/design-system.md](docs/design-system.md) and are off by default where
+ they would change the vanilla look.
+- Small PRs (< ~500 lines). Labels: `feature` (players get something new), `skip-release` (they see no
+ change), none for a fix. Agents never add `release-now`: the maintainer decides it. Merges ship in batches of 5, or after
+ 6 hours ([docs/release-flow.md](docs/release-flow.md)).
+- Contributors first: `gh pr list --state open --search ` before you start; never duplicate theirs.
+
+## Crates
+
+Game workspace (root `Cargo.toml`); `launcher/` and `crates/horizon-telemetry-server` are separate workspaces.
+
+| Crate | Owns |
+|---|---|
+| `horizon-client` | The game: a lib (`src/lib.rs`, ~190 flat modules) and the bin (`src/main.rs` → `game.rs` + `game/`), plus `horizon-ctl` (`src/bin/horizon-ctl/`). Also the dedicated server (`--dedicated`) |
+| `horizon-world` | Vanilla world data with no gameplay loop: NBT, regions, chunks, `datafix/`, `worldgen/`, `level/` (server-side block behaviour, ticks, redstone), entity physics, items, effects, food, damage |
+| `horizon-core` | Simulation primitives: Java `Random`s, `jmath` (HotSpot-exact `Math`), positions, noise, density, paletted storage, `version.rs` (the pinned version) |
+| `horizon-protocol` | Network protocol 777: codecs, framing, encryption, `packets/{handshake,status,login,configuration,play}.rs`, `entity_data.rs` |
+| `horizon-assets` | Resource decoding: block-state and item models, baking, atlases |
+| `horizon-prepare` | Builds `.local/horizon-client/26.3` from the player's own Minecraft install (runs the Java exporters) |
+| `horizon-server` | `horizon-server`: `server.toml`, CLI, supervisor of the headless game ([docs/hosting.md](docs/hosting.md)) |
+| `horizon-server-files` | `server.properties`, eula, ops/whitelist/bans, usercache |
+| `horizon-friends`, `horizon-relay` | Play with Friends: invite codes, encrypted tunnel, the relay ([docs/play-with-friends.md](docs/play-with-friends.md)) |
+| `horizon-mods`, `horizon-mod-sdk`, `cargo-horizon-mod` | Sandboxed WebAssembly mods: runtime, SDK + WIT, `cargo horizon-mod` ([docs/mods.md](docs/mods.md)) |
+| `horizon-port-pack` | Porting Java modpacks ([docs/modpacks.md](docs/modpacks.md)) |
+| `horizon-shader-api` | Horizon's own WGSL shader packs ([docs/api/shaders.md](docs/api/shaders.md)): `horizon-shaders.toml`, the `.hshader` package; shared by the game, the launcher and the registry |
+| `horizon-shaders` | Shader packs (the `shaders/` folder format), rebuilt clean-room from a written spec of the format; no wgpu |
+| `horizon-theme` | Design tokens and fonts for the launcher, the game's own menus and the website |
+| `horizon-telemetry`, `horizon-telemetry-server`, `horizon-bench` | Opt-in data collection, its ingest server, the benchmark report format |
+| `horizon-dualsense`, `horizon-threads`, `horizon-release-sign`, `horizon-bots`, `xtask` | DualSense output, thread priorities, signed release checksums, load-test bots, repo tasks |
+| `launcher/` | GPUI launcher: `main.rs` (UI), `backend.rs` (installs, updates), `cli.rs`, `mcp.rs`, `*_page.rs` |
+
+Other top-level folders: `tools/` (harnesses and dev scripts), `tests/` (Python unit tests: `python3 -m
+unittest discover -s tests`), `mods/horizon/src/test/java/dev/horizonlab/parity/` (Java oracles),
+`website/` (playhorizon.dev; its paths are relative to `website/`), `docs/`, `.github/workflows/`.
+
+## Build and test fast
+
+```sh
+python3 tools/pr_ready.py # the self-check: fmt, clippy -D warnings, touched crates' tests, harnesses; paste its block in the PR
+python3 tools/pr_ready.py --quick # same without harnesses
+cargo test -p horizon-client --lib --bins --tests # skips the 104 examples (pr_ready does this); `--doc` separately
+cargo build --profile fast -p horizon-client # optimized, quick to link: use it to play or run lan_e2e
+python3 tools/parity.py --changed origin/main # the harnesses your branch can affect (CI's parity job)
+python3 tools/parity.py --changed-files paths.txt --list # which harnesses cover these files, without running them
+python3 tools/parity.py mob_ai sculk # named harnesses
+python3 tools/lan_e2e.py --check chest # two real games over LAN (host in-frame); --server-thread for the host on its server thread
+python3 tools/agent_control_e2e.py # horizon-ctl / MCP end to end
+```
+
+- Harnesses and the game need the vanilla data in `.local/` (`minecraft/`, `horizon-client/26.3`, `datagen/`,
+ `tools/`): see [docs/parity-workflow.md](docs/parity-workflow.md). Without it, pr_ready lists the
+ harnesses for CI.
+- A harness = `tools/test__parity.py` (324 of them) + a Java oracle (`mods/horizon/src/test/java/dev/horizonlab/parity/Vanilla*Oracle.java`)
+ + a Rust probe: `crates//examples/_{probe,fixture}.rs` (horizon-world 175, horizon-client 104),
+ or the game binary with a fixture env var (`game/dispense_fixture.rs`, `game/sculk_fixture.rs`,
+ `game/command_harness.rs`, `game/net_harness.rs`). Copy a nearby harness for a new one.
+- Probes build into `.local/parity-target/`; harnesses find binaries via `lab.cargo_target()`, never `target/`.
+- What a change reruns (of 329 harnesses, measured 2026-10-23): a file of the game binary (`game.rs`, `game/`)
+ ~25, a file of the client lib ~103, of `horizon-world` ~103–109, of `horizon-core` ~119. Plan for it.
+- Rust integration tests: `crates/horizon-client/tests/` (`lan_bot.rs`, `generation_saves.rs`, `streaming_meshes.rs`).
+- **macOS:** `cargo build/test --workspace` may fail to link the two wasm guest cdylibs (undefined
+ `horizon:mods/events` symbols) until #1446 lands: add `--exclude coords-hud --exclude predator-missile --exclude horizon-mods-test-guest --exclude horizon-mods-test-ui-guest`.
+ Their real check is `cargo test -p horizon-mods` (builds them for `wasm32-unknown-unknown`).
+- Linux needs `libasound2-dev libudev-dev`; `--no-default-features` drops audio and controllers (the server build).
+- Run and drive the game (starts the `horizon-client` beside `horizon-ctl`; other arguments go to the game):
+ `target/fast/horizon-ctl --socket $PWD/ctl.sock launch --world W --creative --offscreen --wait --resources $PWD/.local/horizon-client/26.3`,
+ then `horizon-ctl --socket … state|keys|turn|command|screenshot|quit`
+ ([docs/horizon-ctl-commands.md](docs/horizon-ctl-commands.md)).
+
+## Vanilla reference
+
+- Decompiled sources: `.local/minecraft/26.3/sources/{client,server}/` (`python3 tools/lab.py decompile`).
+- Bytecode queries (callers through lambdas, every overload):
+ `python3 tools/rea_vanilla.py method net.minecraft.world.level.block.DispenserBlock dispenseFrom`
+ ([docs/decompilation-status.md](docs/decompilation-status.md)).
+- A harness runs the oracle against the real 26.3 jars and the Rust probe on the same inputs, then compares
+ their JSON. Oracle runs are cached by `tools/parity_shim.py`; `--fresh` reruns them.
+- Mirror vanilla's `Math` calls with `horizon_core::jmath`, and vanilla's RNG with `horizon_core::random`:
+ random draws must happen in vanilla's order.
+
+## horizon-client: where things live
+
+`L:` = lib (`crates/horizon-client/src/`), `G:` = bin (`crates/horizon-client/src/game/`). The lib can't see
+`Game`; bin code reaches the lib as `horizon_client::`.
+
+| Subsystem | Files |
+|---|---|
+| Game loop, tick, frame | `game.rs`: `fn run`, `impl ApplicationHandler for Game` (`window_event`, `about_to_wait`), `fn tick`, `fn tick_world`, `fn render`; L: `clock.rs`, `window.rs`, `spans.rs` |
+| Rendering | L: `gfx.rs` (`Renderer::new`, `Renderer::render`), `gfx/` (cull, occlusion, translucency, upload, timing, lod, weather, stars, end_sky), `*.wgsl`, `particles.rs`, `block_entity_render.rs`, `item_render.rs`, `fog.rs`, `clouds.rs`, `camera.rs`, `first_person.rs`; G: `render_tick.rs`, `item_draw.rs` |
+| Chunks, streaming, light | L: `streaming.rs` (worker pool: generate, light, mesh), `world.rs`, `chunk.rs`, `chunk_map.rs`, `light.rs`, `mesher.rs` + `mesher/`, `vanillagen.rs` (binds horizon-world's generator), `lod.rs` + `lod/`, `ticket_levels.rs`; G: `world_loading.rs`, `postprocess.rs`; game.rs `fn update_world` |
+| World generation | `crates/horizon-world/src/worldgen/` (`generator*.rs`, `feature_graph.rs`, `structure/`, `carver/`) |
+| Block behaviour | `crates/horizon-world/src/level/` (`mod.rs`, `tick.rs`, `hooks.rs`, `redstone.rs`, `place.rs`, `interact.rs`); game.rs `fn tick_blocks`, `fn process_level_events` |
+| Mobs | L: `mobs.rs` (types), `mobs/` (`ai.rs`, `goals.rs`, `brain.rs`, `*_brain.rs`, `nav.rs`, `path.rs`, `species.rs`, `spawning.rs`, `render.rs`, `anim.rs`); G: `creatures.rs` (ticking, spawning, mob events), one file per mob family (`dragon.rs`, `wither.rs`, `villagers.rs`, `piglins.rs`, `golems.rs`...), `natural_spawning.rs` |
+| Other entities | L: `entities.rs`, `projectiles.rs`, `arrows.rs`; G: `boats.rs`, `minecarts.rs`, `mounts.rs`, `armor_stands.rs`, `paintings.rs`, `frames.rs`, `fireworks.rs`, `tnt.rs`, `explosion.rs` |
+| Player actions | game.rs (`fn use_hand`, `fn use_item`, `fn attack`, `fn tick_mining`, `fn break_block`); G: `hand.rs`, `combat.rs`, `consume.rs`, `potions.rs`, `shield.rs`, `crossbow.rs`, `trident.rs`, `fishing.rs`; L: `motion.rs` + `motion/` (movement), `collisions.rs`, `items.rs`, `item_data.rs` |
+| Inventory and containers | L: `menu.rs` (`AbstractContainerMenu.clicked`), `container_screen.rs`, `containers.rs`, `creative.rs`, `crafting.rs`, `recipe_book*.rs`, `stations.rs`, `merchant.rs`; game.rs `fn menu_ops`, `fn click_inventory`; G: `stations.rs`, `trading.rs`, `recipe_book.rs`, `machines.rs` |
+| Commands | parse: L: `command/` (`args.rs`, `selector.rs`, `tree_*.rs`, `vanilla.rs`); run: G: `commands.rs` (dispatch) + `commands/*.rs` (`admin`, `execute`, `items`, `players`, `world_cmds`...); L: `scoreboard_cmd.rs`, `data_cmd.rs`, `nbt_path.rs`; G: `functions.rs`, `command_blocks.rs` |
+| UI screens | `Screen` enum in game.rs; L: `title.rs` + `title/`, `options_ui.rs`, `multiplayer.rs`, `pack_screen.rs`, `graphics_ui.rs`, `screen_draw.rs`, `ui.rs` (widgets), `hud.rs`, `hud_layout.rs`, `hud_overlays.rs`, `chat.rs`, `tab_list.rs`; G: `startup_menu.rs`, `screens.rs` (pause, death), `options.rs`, `lan_screen.rs`, `chat.rs`, `sign_edit.rs`, `books.rs` |
+| Multiplayer client | L: `net.rs` (network thread); G: `remote.rs` (`fn handle_packet`, `fn tick_remote`), `remote_*.rs` (mob data, objects, projectiles, vehicles, stations) |
+| LAN host / server side | L: `lan/` (`conn.rs` handshake + login threads, `hub.rs` + `hub/` play state, `chunks.rs`, `entity.rs`, `tracking.rs`, `guest.rs`, `playerdata.rs`); G: `lan.rs` (`LanHost`), `lan_actions.rs` (`fn as_guest`, `fn tick_guests`), `lan_*.rs` per feature, `lan_entities.rs` (tracked entities) |
+| Integrated server | G: `integrated.rs` (the server thread), `levels.rs` (one level per dimension, `fn tick_server`), `server_travel.rs` |
+| Dedicated server | G: `dedicated.rs`, `dedicated/status.rs`; crates `horizon-server-files`, `horizon-server` |
+| Save and load | L: `save.rs` (level.dat, regions, playerdata), `entity_nbt.rs`, `block_entity_nbt.rs`, `options_file.rs`; G: `saving.rs`, `persist.rs` (entities); `crates/horizon-world/src/{region.rs,nbt.rs,datafix/}` |
+| Input | game.rs `fn window_event`, `fn key_pressed`, `fn play_mouse`; L: `keybinds.rs`, `keymapping.rs`, `key_names.rs`, `mouse.rs`, `input.rs`, `interaction_input.rs`, `gamepad.rs`, `osk.rs`, `clipboard.rs`; G: `pad.rs`, `pad_menu.rs` |
+| Audio | L: `audio.rs` (mixer), `sound_engine.rs`, `sound_events.rs`, `music.rs`, `ambience.rs`; G: `music.rs`, `subtitle_hud.rs` |
+| Resource packs | L: `packs.rs` + `packs/`, `pack_screen.rs`, `atlas_sources.rs`, `sprites.rs`, `mipmap.rs`, `model_library.rs`, `font.rs`, `lang.rs`; crate `horizon-assets`; G: `packs.rs` |
+| Agent control | L: `control.rs` (socket), `bin/horizon-ctl/`; G: `control.rs`, `agent.rs`, `events.rs`, `ui_control.rs` ([docs/agent-control.md](docs/agent-control.md)) |
+| Mods | crate `horizon-mods`; G: `mods.rs`; L: `mod_content.rs`, `mod_list.rs` |
+| Horizon extras, settings | L: `extras.rs`, `graphics.rs`, `settings.rs`, `minimap.rs`; G: `extras.rs`, `tweaks.rs`, `options.rs` |
+
+## How `Game` is organised
+
+- `struct Game` (game.rs, ~290 fields) holds everything. Its methods are spread over ~180 files: game.rs keeps
+ the core (tick, render, input, inventory, world open/close) and each `game/.rs` adds an
+ `impl Game<'_>` block for one feature, with its own state types. Fields are private to the bin.
+- Find a feature's code: `grep -rn "fn tick_\|fn _" crates/horizon-client/src/game*`;
+ the file is usually `game/s.rs`. Who calls it: grep the name in game.rs's `fn tick` / `fn tick_world`.
+- Fields that say which mode runs: `remote` (this window is a client of a server: multiplayer, LAN guest, or
+ single player on its server thread), `lan` (`LanHost`: this world is open to the network), `integrated`
+ (the window's own server thread), `serving` (this `Game` *is* that server thread), `options.dedicated`.
+ `fn tick` returns `tick_remote()` when `remote` is set; nothing else of the local simulation runs.
+- A server's players run through the same gameplay code as the local player: `as_guest` swaps the guest's
+ state (position, inventory, mode, mining, item use) into `Game` for one call (`game/lan_actions.rs`), and
+ `levels.rs` swaps whole dimensions in the same way. Changes reach clients through the block log, level
+ events and the entity tracker (`lan/tracking.rs`, `game/lan_entities.rs`).
+- Shared read-only data: `Resources` (`res`: blocks, items, recipes, mob types, biomes) and `PackResources`
+ (`pack`), both in game.rs.
+
+## The two single-player paths
+
+1. **Server thread (default since #1514):** `game/integrated.rs` runs a second `Game` (`serving`) on a
+ "Server thread" with one level per dimension; the window joins it as a client through memory (`remote`),
+ exactly as a LAN guest or a dedicated server's player does. This is what players run. Open
+ `[server-thread]` issues list the gaps left.
+2. **In-frame (`--in-frame`, `--no-server-thread` or `HORIZON_SERVER_THREAD=0`):** the window's `Game` ticks
+ the world itself, one level that follows the player (`fn enter_dimension`). Most harnesses test this path.
+
+LAN guests and dedicated servers always use the server code, so a fix there serves both. Test both paths
+when you touch player-facing gameplay:
+
+```sh
+cargo run --profile fast -p horizon-client -- --resources .local/horizon-client/26.3 --world T # server thread
+cargo run --profile fast -p horizon-client -- --resources .local/horizon-client/26.3 --world T --in-frame # in-frame
+python3 tools/lan_e2e.py --check # host in-frame, guest is a server client
+python3 tools/lan_e2e.py --server-thread --check # host on its server thread (portals, levels, distance, lava need it)
+python3 tools/parity.py dedicated_server server_entities server_player_damage
+```
+
+## Docs worth knowing
+
+[docs/parity-workflow.md](docs/parity-workflow.md) (runner, gate, shards, scopes) ·
+[docs/native-client.md](docs/native-client.md) (options, controls, horizon-ctl) ·
+[docs/server-levels.md](docs/server-levels.md) (levels per dimension) ·
+[docs/rust-parity.md](docs/rust-parity.md) (what is ported) · [docs/known-issues.md](docs/known-issues.md) ·
+[docs/release-flow.md](docs/release-flow.md) · [docs/README.md](docs/README.md) (index).
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 120000
index 000000000..47dc3e3d8
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1 @@
+AGENTS.md
\ No newline at end of file
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index af44d89f8..21951c083 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -7,6 +7,11 @@ welcome on [Discord](https://discord.gg/HcTeMZxe5E).
This repository holds the game, the launcher and the website, plus the tools, tests and docs that build, check and
release them. Anything else (videos, Discord and other community material) lives elsewhere.
+**Where to start: [playhorizon.dev/hub](https://playhorizon.dev/hub).** It shows what is being done now and next
+([ROADMAP.md](ROADMAP.md) in the repository), the work board, good first tasks, and the forms to report a bug or
+suggest something. A pull request for a roadmap item carries its `roadmap:` label; ideas go to the suggestion
+queue (the hub, or `/suggest` on Discord) rather than to issues, which are for bugs.
+
## Build it
You need Rust (stable), Python 3.10+, JDK 25, and on Linux the ALSA and udev headers (`libasound2-dev libudev-dev`).
@@ -39,6 +44,17 @@ probe against Horizon, and compares their outputs. There are about 290 of them.
Never commit game files, decompiled source or prepared resources (`.local/`): `tools/check_public_tree.py` rejects
them (`git config core.hooksPath .githooks` runs it before every commit).
+The pre-push hook checks the full history reachable from the branches and tags being pushed. Run
+`python3 tools/check_public_tree.py --history` to audit the history of all local refs.
+
+## Only original code
+
+Horizon's code is written from Minecraft 26.3 itself and from public documentation, never from another mod, loader
+or renderer. Don't read, copy, translate or paraphrase the source of Iris, OptiFine, Sodium or any other project,
+and don't send code an AI tool wrote from it. Their user documentation and file formats are fine to read, and their
+packs and mods are fine to run and observe. Shader packs were removed on 24 October 2026 (#1561) because their code
+had been written from another project's source; they come back only as a clean-room rewrite from a written
+description of the pack format.
## Before asking for review
diff --git a/Cargo.lock b/Cargo.lock
index 420f2226c..311274032 100644
--- a/Cargo.lock
+++ b/Cargo.lock
@@ -178,15 +178,6 @@ version = "1.0.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "175571dd1d178ced59193a6fc02dde1b972eb0bc56c892cde9beeceac5bf0f6b"
-[[package]]
-name = "ascii-canvas"
-version = "4.0.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ef1e3e699d84ab1b0911a1010c5c106aa34ae89aeac103be5ce0c3859db1e891"
-dependencies = [
- "term",
-]
-
[[package]]
name = "ash"
version = "0.38.0+1.3.281"
@@ -225,30 +216,15 @@ version = "0.22.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "72b3254f16251a8381aa12e40e3c4d2f0199f8c6508fbecb9d91f575e0fbb8c6"
-[[package]]
-name = "bit-set"
-version = "0.8.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "08807e080ed7f9d5433fa9b275196cfc35414f66a0c79d864dc51a0d825231a3"
-dependencies = [
- "bit-vec 0.8.0",
-]
-
[[package]]
name = "bit-set"
version = "0.10.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "09ec2f926cc3060f09db9ebc5b52823d85268d24bb917e472c0c4bea35780a7d"
dependencies = [
- "bit-vec 0.9.1",
+ "bit-vec",
]
-[[package]]
-name = "bit-vec"
-version = "0.8.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5e764a1d40d510daf35e07be9eb06e75770908c27d411ee6c92109c9840eaaf7"
-
[[package]]
name = "bit-vec"
version = "0.9.1"
@@ -294,16 +270,6 @@ dependencies = [
"objc2 0.6.5",
]
-[[package]]
-name = "borsh"
-version = "1.8.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "553c5d846a6ba5150c65e3b1b8ec073bcf1abc20f9b7220de384a4443ea4e20a"
-dependencies = [
- "bytes",
- "cfg_aliases",
-]
-
[[package]]
name = "bumpalo"
version = "3.20.3"
@@ -473,6 +439,8 @@ version = "0.13.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "af491d569909a7e4dee0ad7db7f5341fef5c614d5b8ec8cf765732aba3cff681"
dependencies = [
+ "serde",
+ "termcolor",
"unicode-width",
]
@@ -495,15 +463,6 @@ dependencies = [
"crossbeam-utils",
]
-[[package]]
-name = "convert_case"
-version = "0.10.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "633458d4ef8c78b72454de2d54fd6ab2e60f9e02be22f3c6104cdc8a4e0fceb9"
-dependencies = [
- "unicode-segmentation",
-]
-
[[package]]
name = "coords-hud"
version = "0.1.0"
@@ -825,41 +784,6 @@ dependencies = [
"syn 2.0.119",
]
-[[package]]
-name = "darling"
-version = "0.20.11"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "fc7f46116c46ff9ab3eb1597a45688b6715c6e628b5c133e288e709a29bcb4ee"
-dependencies = [
- "darling_core",
- "darling_macro",
-]
-
-[[package]]
-name = "darling_core"
-version = "0.20.11"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0d00b9596d185e565c2207a0b01f8bd1a135483d02d9b7b0a54b11da8d53412e"
-dependencies = [
- "fnv",
- "ident_case",
- "proc-macro2",
- "quote",
- "strsim",
- "syn 2.0.119",
-]
-
-[[package]]
-name = "darling_macro"
-version = "0.20.11"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "fc34b93ccb385b40dc71c6fceac4b2ad23662c7eeb248cf10d529b7e055b6ead"
-dependencies = [
- "darling_core",
- "quote",
- "syn 2.0.119",
-]
-
[[package]]
name = "dasp_sample"
version = "0.11.0"
@@ -877,29 +801,6 @@ dependencies = [
"syn 3.0.6",
]
-[[package]]
-name = "derive_more"
-version = "2.1.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d751e9e49156b02b44f9c1815bcb94b984cdcc4396ecc32521c739452808b134"
-dependencies = [
- "derive_more-impl",
-]
-
-[[package]]
-name = "derive_more-impl"
-version = "2.1.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "799a97264921d8623a957f6c3b9011f3b5492f557bbb7a5a19b7fa6d06ba8dcb"
-dependencies = [
- "convert_case",
- "proc-macro2",
- "quote",
- "rustc_version",
- "syn 2.0.119",
- "unicode-xid",
-]
-
[[package]]
name = "digest"
version = "0.10.7"
@@ -986,15 +887,6 @@ version = "0.6.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "edd0f118536f44f5ccd48bcb8b111bdc3de888b58c74639dfb034a357d0f206d"
-[[package]]
-name = "ena"
-version = "0.14.4"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "eabffdaee24bd1bf95c5ef7cec31260444317e72ea56c4c91750e8b7ee58d5f1"
-dependencies = [
- "log",
-]
-
[[package]]
name = "encoding_rs"
version = "0.8.42"
@@ -1287,6 +1179,17 @@ dependencies = [
"stable_deref_trait",
]
+[[package]]
+name = "gl_generator"
+version = "0.14.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1a95dfc23a2b4a9a2f5ab41d194f8bfda3cabec42af4e39f08c339eb2a0c124d"
+dependencies = [
+ "khronos_api",
+ "log",
+ "xml-rs",
+]
+
[[package]]
name = "glam"
version = "0.30.10"
@@ -1294,55 +1197,24 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "19fc433e8437a212d1b6f1e68c7824af3aed907da60afa994e7f542d18d12aa9"
[[package]]
-name = "glsl-lang"
-version = "0.8.1"
+name = "glow"
+version = "0.17.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "983a18d0c2ecad18ac9ff3c94b069d6bd03b47405a200836d9d8d63def8e34de"
+checksum = "29038e1c483364cc6bb3cf78feee1816002e127c331a1eec55a4d202b9e1adb5"
dependencies = [
- "glsl-lang-lexer",
- "glsl-lang-types",
- "lalrpop",
- "lalrpop-util",
- "lang-util",
- "once_cell",
- "thiserror 2.0.21",
+ "js-sys",
+ "slotmap",
+ "wasm-bindgen",
+ "web-sys",
]
[[package]]
-name = "glsl-lang-lexer"
-version = "0.8.1"
+name = "glutin_wgl_sys"
+version = "0.6.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "abdbc0bdfbc81d557f4865e695457eb23d68031bfb061fda3444f56511b26eee"
+checksum = "2c4ee00b289aba7a9e5306d57c2d05499b2e5dc427f84ac708bd2c090212cf3e"
dependencies = [
- "glsl-lang-pp",
- "glsl-lang-types",
- "lalrpop-util",
- "lang-util",
- "thiserror 2.0.21",
-]
-
-[[package]]
-name = "glsl-lang-pp"
-version = "0.8.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "88677876fb27f116015d0ecebda6d77bdf65f3a6fa3f5dfeed10b8c8f04cb2c5"
-dependencies = [
- "arrayvec",
- "derive_more",
- "lang-util",
- "string_cache",
- "string_cache_codegen",
- "thiserror 2.0.21",
-]
-
-[[package]]
-name = "glsl-lang-types"
-version = "0.8.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "bd8b1532b424d40df634cf2dc2be56d59f994b9ac07fa7c1e3183fd33db9cb07"
-dependencies = [
- "lang-util",
- "thiserror 2.0.21",
+ "gl_generator",
]
[[package]]
@@ -1492,7 +1364,7 @@ dependencies = [
"horizon-mods",
"horizon-protocol",
"horizon-server-files",
- "horizon-shaderpack",
+ "horizon-shaders",
"horizon-telemetry",
"horizon-theme",
"horizon-threads",
@@ -1505,9 +1377,9 @@ dependencies = [
"rustix 1.1.5",
"serde",
"serde_json",
+ "sha1",
"sha2",
"symphonia",
- "toml",
"ureq",
"wgpu",
"winit",
@@ -1542,7 +1414,7 @@ dependencies = [
"serde",
"serde_json",
"sha2",
- "socket2",
+ "socket2 0.5.10",
"spake2",
]
@@ -1557,10 +1429,11 @@ dependencies = [
name = "horizon-mods"
version = "0.1.0"
dependencies = [
- "horizon-mods",
"log",
+ "minisign-verify",
"serde",
"serde_json",
+ "sha2",
"toml",
"wasmtime",
"wit-component",
@@ -1575,6 +1448,13 @@ dependencies = [
"horizon-mod-sdk",
]
+[[package]]
+name = "horizon-mods-test-ui-guest"
+version = "0.1.0"
+dependencies = [
+ "horizon-mod-sdk",
+]
+
[[package]]
name = "horizon-port-pack"
version = "0.1.0"
@@ -1606,6 +1486,7 @@ dependencies = [
"getrandom 0.3.4",
"horizon-core",
"horizon-world",
+ "ipconfig",
"serde_json",
"sha1",
"sha2",
@@ -1660,12 +1541,24 @@ dependencies = [
]
[[package]]
-name = "horizon-shaderpack"
+name = "horizon-shader-api"
version = "0.1.0"
dependencies = [
- "glsl-lang",
+ "bytemuck",
+ "naga",
+ "serde",
+ "serde_json",
+ "sha2",
+ "toml",
+ "zip",
+]
+
+[[package]]
+name = "horizon-shaders"
+version = "0.1.0"
+dependencies = [
+ "horizon-core",
"naga",
- "pp-rs",
"zip",
]
@@ -1820,12 +1713,6 @@ version = "2.3.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "3d3067d79b975e8844ca9eb072e16b31c3c1c36928edf9c6789548c524d0d954"
-[[package]]
-name = "ident_case"
-version = "1.0.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b9e0384b61958566e926dc50660321d12159025e767c18e043daf26b70104c39"
-
[[package]]
name = "idna"
version = "1.1.0"
@@ -1898,6 +1785,19 @@ dependencies = [
"generic-array",
]
+[[package]]
+name = "ipconfig"
+version = "0.3.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4d40460c0ce33d6ce4b0630ad68ff63d6661961c48b6dba35e5a4d81cfb48222"
+dependencies = [
+ "socket2 0.6.5",
+ "widestring",
+ "windows-registry",
+ "windows-result 0.4.1",
+ "windows-sys 0.61.2",
+]
+
[[package]]
name = "itertools"
version = "0.14.0"
@@ -2009,71 +1909,21 @@ dependencies = [
]
[[package]]
-name = "keccak"
-version = "0.1.6"
+name = "khronos-egl"
+version = "6.0.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "cb26cec98cce3a3d96cbb7bced3c4b16e3d13f27ec56dbd62cbc8f39cfb9d653"
+checksum = "6aae1df220ece3c0ada96b8153459b67eebe9ae9212258bb0134ae60416fdf76"
dependencies = [
- "cpufeatures",
+ "libc",
+ "libloading",
+ "pkg-config",
]
[[package]]
-name = "lalrpop"
-version = "0.22.2"
+name = "khronos_api"
+version = "3.1.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ba4ebbd48ce411c1d10fb35185f5a51a7bfa3d8b24b4e330d30c9e3a34129501"
-dependencies = [
- "ascii-canvas",
- "bit-set 0.8.0",
- "ena",
- "itertools",
- "lalrpop-util",
- "petgraph 0.7.1",
- "pico-args",
- "regex",
- "regex-syntax",
- "sha3",
- "string_cache",
- "term",
- "unicode-xid",
- "walkdir",
-]
-
-[[package]]
-name = "lalrpop-util"
-version = "0.22.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b5baa5e9ff84f1aefd264e6869907646538a52147a755d494517a8007fb48733"
-dependencies = [
- "regex-automata",
- "rustversion",
-]
-
-[[package]]
-name = "lang-util"
-version = "0.8.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d1715a1e56998f119cd6d49ac8a69802dcbe4fca96d8291243d6dae87abeb913"
-dependencies = [
- "derive_more",
- "lalrpop-util",
- "lang-util-derive",
- "line-span",
- "smol_str 0.3.6",
- "text-size",
-]
-
-[[package]]
-name = "lang-util-derive"
-version = "0.8.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1f2acc66aedf0e445534e0a6b3f0f6ee20ef6ebb9647dbe10735e52ea8d6a096"
-dependencies = [
- "darling",
- "proc-macro2",
- "quote",
- "syn 2.0.119",
-]
+checksum = "e2db585e1d738fc771bf08a151420d3ed193d9d895a36df7f6f8a9456b911ddc"
[[package]]
name = "lazy_static"
@@ -2131,12 +1981,6 @@ dependencies = [
"pkg-config",
]
-[[package]]
-name = "line-span"
-version = "0.1.5"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "29fc123b2f6600099ca18248f69e3ee02b09c4188c0d98e9a690d90dec3e408a"
-
[[package]]
name = "linux-raw-sys"
version = "0.4.15"
@@ -2221,6 +2065,12 @@ dependencies = [
"libc",
]
+[[package]]
+name = "minisign-verify"
+version = "0.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "871285dc19d8d0ebe0eef3d0e99a205f2a71363b122632cbbfa4a6c370a960ce"
+
[[package]]
name = "miniz_oxide"
version = "0.8.9"
@@ -2254,7 +2104,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "a616d2fb8c89516ac2723a581f69d6c18576046bed761bd6b305e5618e6ae130"
dependencies = [
"arrayvec",
- "bit-set 0.10.0",
+ "bit-set",
"bitflags 2.13.2",
"cfg-if",
"cfg_aliases",
@@ -2316,12 +2166,6 @@ dependencies = [
"jni-sys 0.3.1",
]
-[[package]]
-name = "new_debug_unreachable"
-version = "1.0.6"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "650eef8c711430f1a879fdd01d4745a7deea475becfb90269c06775983bbf086"
-
[[package]]
name = "nix"
version = "0.31.3"
@@ -2821,16 +2665,6 @@ version = "2.3.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "9b4f627cb1b25917193a259e49bdad08f671f8d9708acfd5fe0a8c1455d87220"
-[[package]]
-name = "petgraph"
-version = "0.7.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3672b37090dbd86368a4145bc067582552b29c27377cad4e0a306c97f9bd7772"
-dependencies = [
- "fixedbitset",
- "indexmap",
-]
-
[[package]]
name = "petgraph"
version = "0.8.3"
@@ -2842,31 +2676,6 @@ dependencies = [
"indexmap",
]
-[[package]]
-name = "phf_generator"
-version = "0.11.3"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3c80231409c20246a13fddb31776fb942c38553c51e871f8cbd687a4cfb5843d"
-dependencies = [
- "phf_shared",
- "rand",
-]
-
-[[package]]
-name = "phf_shared"
-version = "0.11.3"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "67eabc2ef2a60eb7faa00097bd1ffdb5bd28e62bf39990626a582201b7a754e5"
-dependencies = [
- "siphasher",
-]
-
-[[package]]
-name = "pico-args"
-version = "0.5.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5be167a7af36ee22fe3115051bc51f6e6c7054c9348e28deb4f49bd6f705a315"
-
[[package]]
name = "pin-project"
version = "1.1.13"
@@ -2995,10 +2804,11 @@ dependencies = [
]
[[package]]
-name = "precomputed-hash"
-version = "0.1.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "925383efa346730478fb4838dbe9137d2a47675ad789c546d150a6e1dd4ab31c"
+name = "predator-missile"
+version = "0.1.0"
+dependencies = [
+ "horizon-mod-sdk",
+]
[[package]]
name = "presser"
@@ -3093,15 +2903,6 @@ version = "6.0.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "f8dcc9c7d52a811697d2151c701e0d08956f92b0e24136cf4cf27b57a6a0d9bf"
-[[package]]
-name = "rand"
-version = "0.8.8"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e058c7de0b26af77780c769414d6257830bb240f3c38477dbc2c16e5f54d6d4c"
-dependencies = [
- "rand_core",
-]
-
[[package]]
name = "rand_core"
version = "0.6.4"
@@ -3447,16 +3248,6 @@ dependencies = [
"digest",
]
-[[package]]
-name = "sha3"
-version = "0.10.9"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "77fd7028345d415a4034cf8777cd4f8ab1851274233b45f84e3d955502d93874"
-dependencies = [
- "digest",
- "keccak",
-]
-
[[package]]
name = "shlex"
version = "2.0.1"
@@ -3485,18 +3276,21 @@ version = "0.1.5"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "e3a9fe34e3e7a50316060351f37187a3f546bce95496156754b601a5fa71b76e"
-[[package]]
-name = "siphasher"
-version = "1.0.4"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "33f4fe9184a62d842c9ef383018f3306d8ba224fd9d836f56d7288308847c256"
-
[[package]]
name = "slab"
version = "0.4.12"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "0c790de23124f9ab44544d7ac05d60440adc586479ce501c1d6d7da3cd8c9cf5"
+[[package]]
+name = "slotmap"
+version = "1.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bdd58c3c93c3d278ca835519292445cb4b0d4dc59ccfdf7ceadaab3f8aeb4038"
+dependencies = [
+ "version_check",
+]
+
[[package]]
name = "smallvec"
version = "1.16.2"
@@ -3540,16 +3334,6 @@ dependencies = [
"serde",
]
-[[package]]
-name = "smol_str"
-version = "0.3.6"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4aaa7368fcf4852a4c2dd92df0cace6a71f2091ca0a23391ce7f3a31833f1523"
-dependencies = [
- "borsh",
- "serde_core",
-]
-
[[package]]
name = "socket2"
version = "0.5.10"
@@ -3560,6 +3344,16 @@ dependencies = [
"windows-sys 0.52.0",
]
+[[package]]
+name = "socket2"
+version = "0.6.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c3d1e2c7f27f8d4cb10542a02c49005dbd6e93095799d6f3be745fae9f8fedd4"
+dependencies = [
+ "libc",
+ "windows-sys 0.61.2",
+]
+
[[package]]
name = "spake2"
version = "0.4.0"
@@ -3599,37 +3393,6 @@ version = "0.1.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "6637bab7722d379c8b41ba849228d680cc12d0a45ba1fa2b48f2a30577a06731"
-[[package]]
-name = "string_cache"
-version = "0.8.9"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "bf776ba3fa74f83bf4b63c3dcbbf82173db2632ed8452cb2d891d33f459de70f"
-dependencies = [
- "new_debug_unreachable",
- "parking_lot",
- "phf_shared",
- "precomputed-hash",
- "serde",
-]
-
-[[package]]
-name = "string_cache_codegen"
-version = "0.5.4"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c711928715f1fe0fe509c53b43e993a9a557babc2d0a3567d0a3006f1ac931a0"
-dependencies = [
- "phf_generator",
- "phf_shared",
- "proc-macro2",
- "quote",
-]
-
-[[package]]
-name = "strsim"
-version = "0.11.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7da8b5736845d9f2fcb837ea5d9e2628564b3b043a70948a3f0b778838c5fb4f"
-
[[package]]
name = "subtle"
version = "2.6.1"
@@ -3746,15 +3509,6 @@ version = "0.13.5"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "adb6935a6f5c20170eeceb1a3835a49e12e19d792f6dd344ccc76a985ca5a6ca"
-[[package]]
-name = "term"
-version = "1.2.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d8c27177b12a6399ffc08b98f76f7c9a1f4fe9fc967c784c5a071fa8d93cf7e1"
-dependencies = [
- "windows-sys 0.61.2",
-]
-
[[package]]
name = "termcolor"
version = "1.4.1"
@@ -3764,12 +3518,6 @@ dependencies = [
"winapi-util",
]
-[[package]]
-name = "text-size"
-version = "1.1.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f18aa187839b2bdb1ad2fa35ead8c4c2976b64e4363c386d45ac0f7ee85c9233"
-
[[package]]
name = "thiserror"
version = "1.0.69"
@@ -3930,7 +3678,7 @@ checksum = "b8765b90061cba6c22b5831f675da109ae5561588290f9fa2317adab2714d5a6"
dependencies = [
"memchr",
"nom",
- "petgraph 0.8.3",
+ "petgraph",
]
[[package]]
@@ -4046,10 +3794,6 @@ version = "0.9.5"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "0b928f33d975fc6ad9f86c8f283853ad26bdd5b10b7f1542aa2fa15e2289105a"
-[[package]]
-name = "voxel-kernels"
-version = "0.1.0"
-
[[package]]
name = "walkdir"
version = "2.5.0"
@@ -4541,6 +4285,7 @@ dependencies = [
"hashbrown 0.17.1",
"js-sys",
"log",
+ "naga",
"parking_lot",
"portable-atomic",
"profiling",
@@ -4562,8 +4307,8 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "14c018fce9b6270aa203c2fdd56f3cce996713534bd757e4ea58c8560b121f14"
dependencies = [
"arrayvec",
- "bit-set 0.10.0",
- "bit-vec 0.9.1",
+ "bit-set",
+ "bit-vec",
"bitflags 2.13.2",
"bytemuck",
"cfg_aliases",
@@ -4582,6 +4327,7 @@ dependencies = [
"smallvec",
"thiserror 2.0.21",
"wgpu-core-deps-apple",
+ "wgpu-core-deps-emscripten",
"wgpu-core-deps-windows-linux-android",
"wgpu-hal",
"wgpu-naga-bridge",
@@ -4597,6 +4343,15 @@ dependencies = [
"wgpu-hal",
]
+[[package]]
+name = "wgpu-core-deps-emscripten"
+version = "30.0.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d98b86cf4abf524a902dd35f18ca6a3f08fc2ae9847c8f10b48e30491b1f0b86"
+dependencies = [
+ "wgpu-hal",
+]
+
[[package]]
name = "wgpu-core-deps-windows-linux-android"
version = "30.0.1"
@@ -4613,19 +4368,24 @@ dependencies = [
"android_system_properties",
"arrayvec",
"ash",
- "bit-set 0.10.0",
+ "bit-set",
"bitflags 2.13.2",
"block2 0.6.2",
"bytemuck",
"cfg-if",
"cfg_aliases",
+ "glow",
+ "glutin_wgl_sys",
"gpu-allocator",
"hashbrown 0.17.1",
+ "js-sys",
+ "khronos-egl",
"libc",
"libloading",
"log",
"naga",
"naga-types",
+ "ndk-sys",
"objc2 0.6.5",
"objc2-core-foundation",
"objc2-core-graphics",
@@ -4645,10 +4405,14 @@ dependencies = [
"smallvec",
"static_assertions",
"thiserror 2.0.21",
+ "wasm-bindgen",
+ "wayland-sys",
+ "web-sys",
"wgpu-naga-bridge",
"wgpu-types",
"windows 0.62.2",
"windows-core 0.62.2",
+ "windows-result 0.4.1",
]
[[package]]
@@ -4677,6 +4441,12 @@ dependencies = [
"web-sys",
]
+[[package]]
+name = "widestring"
+version = "1.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "72069c3113ab32ab29e5584db3c6ec55d416895e60715417b5b883a357c3e471"
+
[[package]]
name = "winapi-util"
version = "0.1.11"
@@ -4789,6 +4559,17 @@ dependencies = [
"windows-link",
]
+[[package]]
+name = "windows-registry"
+version = "0.6.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "02752bf7fbdcce7f2a27a742f798510f3e5ad88dbe84871e5168e2120c3d5720"
+dependencies = [
+ "windows-link",
+ "windows-result 0.4.1",
+ "windows-strings",
+]
+
[[package]]
name = "windows-result"
version = "0.1.2"
@@ -5091,7 +4872,7 @@ dependencies = [
"rustix 0.38.44",
"sctk-adwaita",
"smithay-client-toolkit",
- "smol_str 0.2.2",
+ "smol_str",
"tracing",
"unicode-segmentation",
"wasm-bindgen",
@@ -5303,6 +5084,12 @@ version = "0.2.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "b9cc00251562a284751c9973bace760d86c0276c471b4be569fe6b068ee97a56"
+[[package]]
+name = "xml-rs"
+version = "0.8.29"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e450f9b2ed1dff33c94c12589a87338689467b9c4f5d8a5710bd09a847d2c8a7"
+
[[package]]
name = "xtask"
version = "0.1.0"
diff --git a/Cargo.toml b/Cargo.toml
index bc67ec748..fff062e3a 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -1,6 +1,6 @@
[workspace]
-exclude = ["launcher", "crates/horizon-telemetry-server", "third_party/wgpu-hal"]
-members = ["crates/horizon-core", "crates/horizon-dualsense", "crates/horizon-threads", "crates/horizon-world", "crates/voxel-kernels", "crates/horizon-client", "crates/horizon-server-files", "crates/horizon-server", "crates/horizon-bots", "crates/horizon-assets", "crates/horizon-protocol", "crates/horizon-theme", "crates/horizon-shaderpack", "crates/horizon-prepare", "crates/horizon-telemetry", "crates/horizon-bench", "crates/horizon-friends", "crates/horizon-relay", "crates/horizon-mod-sdk", "crates/horizon-mods", "crates/horizon-mods/tests/guest", "crates/cargo-horizon-mod", "crates/horizon-port-pack", "crates/horizon-release-sign", "crates/horizon-mod-sdk/examples/coords-hud", "xtask"]
+exclude = ["launcher", "crates/horizon-telemetry-server", "crates/horizon-mod-registry", "third_party/wgpu-hal"]
+members = ["crates/horizon-core", "crates/horizon-dualsense", "crates/horizon-threads", "crates/horizon-world", "crates/horizon-client", "crates/horizon-server-files", "crates/horizon-server", "crates/horizon-bots", "crates/horizon-assets", "crates/horizon-protocol", "crates/horizon-theme", "crates/horizon-prepare", "crates/horizon-telemetry", "crates/horizon-bench", "crates/horizon-friends", "crates/horizon-relay", "crates/horizon-mod-sdk", "crates/horizon-mods", "crates/horizon-mods/tests/guest", "crates/horizon-mods/tests/ui_guest", "crates/cargo-horizon-mod", "crates/horizon-port-pack", "crates/horizon-shaders", "crates/horizon-shader-api", "crates/horizon-release-sign", "crates/horizon-mod-sdk/examples/coords-hud", "crates/horizon-mod-sdk/examples/predator-missile", "xtask"]
resolver = "2"
[workspace.package]
diff --git a/README.md b/README.md
index 4abb52b86..ceee29249 100644
--- a/README.md
+++ b/README.md
@@ -16,6 +16,7 @@
Download ·
Documentation ·
Release notes ·
+ Roadmap ·
Project status ·
Contributing
@@ -45,7 +46,7 @@ The [documentation](https://playhorizon.dev/docs/) covers each of these.
- **The game:** singleplayer with vanilla's world generation, mobs, villagers, raids, redstone, every command, the HUD and the recipe book, on saves in vanilla's format. Worlds from 1.8 to 26.2 are upgraded as vanilla does. [Status table](#project-status).
- **Horizon's own extras:** new menus (vanilla's are one setting away), graphics presets, distant terrain up to 1024 chunks, controller support, optional zoom, minimap and more, all off by default where they would change the vanilla look. See [Settings](https://playhorizon.dev/docs/settings).
-- **Resource packs, shader packs and data packs:** resource packs work, Java shader packs run their full-screen effects (experimental), and data packs load functions, predicates and item modifiers.
+- **Resource packs and data packs:** resource packs work, and data packs load functions, predicates and item modifiers.
- **Playing with others:** invite friends from the pause menu's Friends button with a code, Open to LAN, and joining offline-mode servers. Horizon cannot sign in to a Microsoft account yet, so it cannot join servers that check accounts. See [Multiplayer](https://playhorizon.dev/docs/multiplayer).
- **Mods:** Horizon has its own mod system (Rust compiled to WebAssembly). Java mod jars do not run. See [Mods and data packs](https://playhorizon.dev/docs/mods).
@@ -57,7 +58,7 @@ Screenshots, captured in the Rust client itself with vanilla assets and no mods