Add core performance profile for matched view-distance comparisons

This commit is contained in:
Ludovic Marie
2026-10-04 07:14:50 +02:00
parent 970f466d8b
commit 470022f10b
6 changed files with 34 additions and 4 deletions
+9 -2
View File
@@ -6,13 +6,14 @@ Client-first performance research for Minecraft Java **26.3**, preserving vanill
## Play on your Mac
Download **horizon-mac-starter-0.18.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.19.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.
| 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 |
@@ -36,6 +37,12 @@ Balanced combines [Sodium](https://modrinth.com/mod/sodium), [Lithium](https://m
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.
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)
@@ -135,7 +142,7 @@ python3 tools/build_mod.py
python3 tools/build_release.py
```
Gitignored `dist/` contains nineteen 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 twenty 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 <label> <seconds>`. [Server instructions](docs/server-quickstart.txt) cover setup and a baseline. Files are prepared before you accept Minecraft's EULA locally. A 50-active-player workload remains to be measured.
@@ -1,7 +1,7 @@
{
"schemaVersion": 1,
"id": "horizonlab",
"version": "0.18.0",
"version": "0.19.0",
"name": "Horizon Lab",
"description": "Client frame pacing and server tick measurements for reproducible optimization experiments.",
"authors": [
+6
View File
@@ -25,6 +25,12 @@ PROFILES
- m2-balanced: 12 chunks of full-detail terrain plus 128 chunks of distant LOD.
Sodium, Lithium, FerriteCore, ImmediatelyFast, EntityCulling, Distant Horizons.
Recommended first test for your 16 GB M2 Pro. OpenGL, shaders not installed.
- core-performance: 12 full-detail chunks, no distant LOD or shaders, with Sodium,
Lithium, FerriteCore, ImmediatelyFast and EntityCulling. Compare this against
baseline first to test the core mods at the same view and simulation distances.
Use the same heap, resolution, world copy, camera route and Java flags in both.
All original experimental controllers are disabled. This is a full-detail
comparison profile; it does not add balanced's 128-chunk distant horizon.
- baseline: original game renderer and simulation with Fabric API and the same
Horizon timing instrument. 12 full-detail chunks, no performance mods or LOD.
Use the SAME 6144 MiB maximum heap as m2-balanced for a fair comparison.
+1 -1
View File
@@ -3,7 +3,7 @@
"minecraft": "26.3",
"java_major": 25,
"fabric_loader": "0.19.5",
"pack_version": "0.18.0",
"pack_version": "0.19.0",
"options_data_version": 5023,
"projects": {
"sodium": {
+16
View File
@@ -46,6 +46,22 @@ class PackTests(unittest.TestCase):
for profile in build_pack.PROFILES.values():
build_pack.validate_selection(lock, profile["mods"])
def test_core_performance_matches_baseline_view_and_simulation(self):
baseline = build_pack.PROFILES["baseline"]
candidate = build_pack.PROFILES["core-performance"]
self.assertEqual(candidate["mods"], build_pack.CORE)
for key in ["render", "lod", "heap"]:
self.assertEqual(candidate[key], baseline[key])
files = build_pack.overrides("core-performance", b"original fixture")
before = build_pack.overrides("baseline", b"original fixture")
for name, value in before.items():
if name != "config/horizon-profile.txt":
self.assertEqual(files[name], value, name)
self.assertNotIn("config/DistantHorizons.toml", files)
self.assertNotIn("config/iris.properties", files)
self.assertNotIn("distanthorizons", candidate["mods"])
self.assertNotIn("iris", candidate["mods"])
def test_missing_exact_iris_sodium_dependency_is_rejected(self):
with self.assertRaisesRegex(ValueError, "Missing pinned dependency"):
build_pack.validate_selection(build_pack.read_lock(), ["iris"])
+1
View File
@@ -17,6 +17,7 @@ ROOT = lab.ROOT
CORE = ["fabric-api", "sodium", "lithium", "ferrite-core", "immediatelyfast", "entityculling"]
PROFILES = {
"baseline": {"title": "Vanilla baseline", "mods": ["fabric-api"], "render": 12, "lod": 0, "heap": 6144},
"core-performance": {"title": "Full-detail performance comparison", "mods": CORE, "render": 12, "lod": 0, "heap": 6144},
"m2-balanced": {"title": "M2 Pro balanced", "mods": CORE + ["distanthorizons"], "render": 12, "lod": 128, "heap": 6144},
"adaptive": {"title": "Adaptive terrain experiment", "mods": CORE + ["distanthorizons"], "render": 12, "lod": 128, "heap": 6144, "adaptive": True},
"worker-pacing": {"title": "Precise worker pacing experiment", "mods": CORE + ["distanthorizons"], "render": 12, "lod": 128, "heap": 6144, "pacing": True},