Add core performance profile for matched view-distance comparisons
This commit is contained in:
@@ -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": [
|
||||
|
||||
@@ -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.
|
||||
|
||||
@@ -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": {
|
||||
|
||||
@@ -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"])
|
||||
|
||||
@@ -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},
|
||||
|
||||
Reference in New Issue
Block a user