From 33f9f5a5ef6443fe3959b4eea9460ab232a53efe Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 4 Oct 2026 00:53:12 +0200 Subject: [PATCH] Combine foreground terrain controls and validate collector experiments --- .github/workflows/ci.yml | 2 + README.md | 11 ++++- docs/collectors.md | 49 +++++++++++++++++++ docs/compact-headers.md | 2 +- docs/foreground-first.md | 30 ++++++++++++ docs/playable-validation.md | 18 ++++++- docs/process-memory.md | 5 ++ docs/server-quickstart.txt | 5 ++ docs/vulkan.md | 32 ++++++++++++ .../dev/horizonlab/client/HorizonClient.java | 2 + .../src/main/resources/fabric.mod.json | 2 +- packs/START-HERE.txt | 8 +++ packs/mods.lock.json | 2 +- tests/test_packs.py | 15 +++++- tools/Compare-Benchmarks.html | 5 ++ tools/build_mod.py | 2 + tools/build_pack.py | 4 +- tools/runtime.py | 12 ++++- tools/server.py | 3 +- tools/test_jfr.py | 10 ++-- 20 files changed, 206 insertions(+), 13 deletions(-) create mode 100644 docs/collectors.md create mode 100644 docs/foreground-first.md create mode 100644 docs/vulkan.md diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index 0a2b4ee21..2d2b47b65 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -45,6 +45,8 @@ jobs: 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 diff --git a/README.md b/README.md index 88c52f471..325627cac 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,7 @@ Client-first performance research for Minecraft Java **26.3**, preserving vanill ## Play on your Mac -Download **horizon-mac-starter-0.10.0.zip** from [Releases](https://github.com/ludovic111/minecraft-optimization-lab/releases), 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. +Download **horizon-mac-starter-0.11.0.zip** from [Releases](https://github.com/ludovic111/minecraft-optimization-lab/releases), 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. @@ -20,6 +20,8 @@ Use native **Java 25 ARM64**, maximum heap **6144 MiB**, minimum **512 MiB** on | queue-wait (experimental) | 12 | 128 | 6144 MiB | | adaptive-queue (experimental) | 12 | 128 | 6144 MiB | | dispatch-retry (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 | @@ -31,6 +33,11 @@ Distant LOD is simplified terrain. Nearby blocks retain full detail. Initial gen 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.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. @@ -82,7 +89,7 @@ python3 tools/build_mod.py python3 tools/build_release.py ``` -Gitignored `dist/` contains twelve packs, our original instrumentation JAR, client/server starter ZIPs and SHA256SUMS. [mods.lock.json](packs/mods.lock.json) pins mod versions, exact dependency closure, SHA-1/SHA-512 and source/license; [fabric.lock.json](packs/fabric.lock.json) pins loader/library SHA-256. Packs use the [Modrinth format](https://support.modrinth.com/en/articles/8802351-modrinth-modpack-format-mrpack). They embed only original project code; third-party mods, game and assets download from their publishers. +Gitignored `dist/` contains fourteen packs, our original instrumentation JAR, client/server starter ZIPs and SHA256SUMS. [mods.lock.json](packs/mods.lock.json) pins mod versions, exact dependency closure, SHA-1/SHA-512 and source/license; [fabric.lock.json](packs/fabric.lock.json) pins loader/library SHA-256. Packs use the [Modrinth format](https://support.modrinth.com/en/articles/8802351-modrinth-modpack-format-mrpack). They embed only original project code; third-party mods, game and assets download from their publishers. The server starter uses Lithium/FerriteCore and `/horizonserver bench