From bd20994266f02b2e9ab12ab6544cfbf2242e1f45 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 4 Oct 2026 08:18:19 +0200 Subject: [PATCH] Record matched core client observations and validation limits --- README.md | 2 + .../live-observations.json | 303 ++++++++++++++++++ docs/core-performance.md | 55 ++++ packs/START-HERE.txt | 5 +- 4 files changed, 363 insertions(+), 2 deletions(-) create mode 100644 benchmarks/core-client-2026-10-04/live-observations.json create mode 100644 docs/core-performance.md diff --git a/README.md b/README.md index 8be850da8..04e6c37cf 100644 --- a/README.md +++ b/README.md @@ -42,6 +42,8 @@ For the first comparison at the same view distance, use `baseline` versus 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. +[Core comparison protocol and selected observations](docs/core-performance.md) +include one software-rendered pair; M2 performance remains unmeasured. 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). diff --git a/benchmarks/core-client-2026-10-04/live-observations.json b/benchmarks/core-client-2026-10-04/live-observations.json new file mode 100644 index 000000000..8619ceb93 --- /dev/null +++ b/benchmarks/core-client-2026-10-04/live-observations.json @@ -0,0 +1,303 @@ +{ + "schema": 1, + "measurement": "Single fixed-order stationary matched-view Linux software-rendered pair; descriptive observations, not statistical hardware speedup", + "minecraft": "26.3", + "java_vendor": "Ubuntu", + "java_runtime_version": "25.0.4.1+1-1-26.04.4-Ubuntu", + "graphics": "llvmpipe LLVM21.1.8 OpenGL,1280x800", + "captured_settings_match": true, + "settings": { + "full_detail_chunks": 12, + "simulation_chunks": 12, + "distant_terrain": "not installed", + "iris_shaders": "not installed", + "heap_max": "3G", + "collector": "G1", + "compact_headers": true, + "world_difficulty": "PEACEFUL", + "fov": 70, + "graphics_preset": "CUSTOM", + "frame_limit": "uncapped", + "all_original_controllers": false + }, + "runs": [ + { + "profile": "baseline", + "elapsed_seconds": 120.175428046, + "frame_samples": 651, + "tick_samples": 2401, + "tick_elapsed_seconds": 120.028670836, + "recorded_tick_samples_per_elapsed_second": 20.003554011529317, + "excluded_frames": 0, + "dropped_samples": 0, + "visual_settings_changed": [], + "frame_stats": { + "count": 651, + "meanMs": 183.95013769585256, + "p50Ms": 181.43732, + "p95Ms": 194.888166, + "p99Ms": 242.713818, + "maxMs": 300.17755, + "meanRate": 5.436255783909352, + "lowOnePercentRate": 3.864724477942431, + "over16Ms": 651, + "over33Ms": 651, + "over50Ms": 651, + "over100Ms": 651 + }, + "tick_execution_stats": { + "count": 2401, + "meanMs": 8.97966414119117, + "p50Ms": 7.166902, + "p95Ms": 16.131444, + "p99Ms": 19.670957, + "maxMs": 38.194457, + "meanRate": 111.36273966114595, + "lowOnePercentRate": 43.536701509030834, + "over16Ms": 106, + "over33Ms": 2, + "over50Ms": 0, + "over100Ms": 0 + }, + "process_cpu_seconds": 337.86, + "process_rss_peak_sampled_bytes": 2842439680, + "mods": [ + "fabric-advancement-api-v1@1.0.0+38c7a2d55d", + "fabric-api-base@2.0.6+fcdff87f5d", + "fabric-api-lookup-api-v1@2.0.24+3434d6d95d", + "fabric-api@0.161.0+26.3", + "fabric-biome-api-v1@20.0.9+74ed1ea55d", + "fabric-block-api-v1@3.1.0+0ae6f9115d", + "fabric-block-getter-api-v2@2.0.9+3434d6d95d", + "fabric-command-api-v2@3.1.2+fcdff87f5d", + "fabric-content-registries-v0@15.0.4+74ed1ea55d", + "fabric-convention-tags-v2@4.10.3+6b5b47fd5d", + "fabric-crash-report-info-v1@1.0.7+fcdff87f5d", + "fabric-creative-tab-api-v1@5.0.21+fcdff87f5d", + "fabric-data-attachment-api-v1@2.2.30+3434d6d95d", + "fabric-data-generation-api-v1@27.2.4+427eab975d", + "fabric-debug-api-v1@1.0.4+3434d6d95d", + "fabric-dimensions-v1@5.1.19+47f74c985d", + "fabric-entity-events-v1@6.0.4+3434d6d95d", + "fabric-events-interaction-v0@5.3.6+3434d6d95d", + "fabric-game-rule-api-v1@4.0.10+3434d6d95d", + "fabric-item-api-v1@14.7.0+cf6bc2db5d", + "fabric-key-mapping-api-v1@2.0.8+3434d6d95d", + "fabric-lifecycle-events-v1@4.1.9+ffef5f675d", + "fabric-loot-api-v3@4.0.8+4068fd645d", + "fabric-menu-api-v1@2.0.27+ed66f0a35d", + "fabric-message-api-v1@7.0.10+3434d6d95d", + "fabric-model-loading-api-v1@8.0.35+fcdff87f5d", + "fabric-networking-api-v1@6.3.8+fcdff87f5d", + "fabric-object-builder-api-v1@24.1.9+3434d6d95d", + "fabric-particles-v1@5.0.24+3434d6d95d", + "fabric-permission-api-v1@1.0.8+fcdff87f5d", + "fabric-recipe-api-v1@10.0.8+fcdff87f5d", + "fabric-registry-sync-v0@8.0.1+fcdff87f5d", + "fabric-renderer-api-v1@17.0.15+79385d0b5d", + "fabric-renderer-indigo@9.1.23+b9d63e335d", + "fabric-rendering-fluids-v1@6.0.6+3434d6d95d", + "fabric-rendering-v1@27.0.14+901a437c5d", + "fabric-resource-conditions-api-v1@6.1.5+3434d6d95d", + "fabric-resource-loader-v0@3.3.26+4fc5413f5d", + "fabric-resource-loader-v1@3.0.4+fcdff87f5d", + "fabric-screen-api-v1@5.2.4+48607d035d", + "fabric-serialization-api-v1@2.0.7+74ed1ea55d", + "fabric-sound-api-v1@2.0.7+3434d6d95d", + "fabric-tag-api-v1@2.1.10+fcdff87f5d", + "fabric-transfer-api-v1@8.0.25+fcdff87f5d", + "fabric-transitive-access-wideners-v1@8.1.16+52268a0e5d", + "fabricloader@0.19.5", + "horizonlab@0.19.0", + "java@25", + "minecraft@26.3", + "mixinextras@0.5.5" + ], + "preceding_jfr_server_render_allocation_counters": [ + { + "thread_id": 59, + "thread": "Server thread", + "counter_observations": 2, + "observed_seconds": 64.375293599, + "observed_allocated_bytes": 1096511648, + "observed_bytes_per_second": 17033112.96458356 + }, + { + "thread_id": 3, + "thread": "Render thread", + "counter_observations": 2, + "observed_seconds": 64.375293599, + "observed_allocated_bytes": 203851256, + "observed_bytes_per_second": 3166607.0102889067 + } + ], + "preceding_jfr_gc_pause_total_ms": 30.391511, + "preceding_jfr_gc_pause_longest_ms": 18.705464, + "exit_code": 0 + }, + { + "profile": "core-performance", + "elapsed_seconds": 120.10416213, + "frame_samples": 785, + "tick_samples": 2402, + "tick_elapsed_seconds": 120.041892203, + "recorded_tick_samples_per_elapsed_second": 20.0096812530915, + "excluded_frames": 0, + "dropped_samples": 0, + "visual_settings_changed": [], + "frame_stats": { + "count": 785, + "meanMs": 152.43891740636943, + "p50Ms": 150.474848, + "p95Ms": 163.179892, + "p99Ms": 198.41, + "maxMs": 228.508471, + "meanRate": 6.560004603904492, + "lowOnePercentRate": 4.756900949481116, + "over16Ms": 785, + "over33Ms": 785, + "over50Ms": 785, + "over100Ms": 785 + }, + "tick_execution_stats": { + "count": 2402, + "meanMs": 6.370044777268943, + "p50Ms": 5.805562, + "p95Ms": 10.732708, + "p99Ms": 13.377683, + "maxMs": 23.875155, + "meanRate": 156.98476776308226, + "lowOnePercentRate": 63.74793922036882, + "over16Ms": 5, + "over33Ms": 0, + "over50Ms": 0, + "over100Ms": 0 + }, + "process_cpu_seconds": 345.46, + "process_rss_peak_sampled_bytes": 2211401728, + "mods": [ + "entityculling@1.11.2", + "fabric-advancement-api-v1@1.0.0+38c7a2d55d", + "fabric-api-base@2.0.6+fcdff87f5d", + "fabric-api-lookup-api-v1@2.0.24+3434d6d95d", + "fabric-api@0.161.0+26.3", + "fabric-biome-api-v1@20.0.9+74ed1ea55d", + "fabric-block-api-v1@3.1.0+0ae6f9115d", + "fabric-block-getter-api-v2@2.0.9+3434d6d95d", + "fabric-command-api-v2@3.1.2+fcdff87f5d", + "fabric-content-registries-v0@15.0.4+74ed1ea55d", + "fabric-convention-tags-v2@4.10.3+6b5b47fd5d", + "fabric-crash-report-info-v1@1.0.7+fcdff87f5d", + "fabric-creative-tab-api-v1@5.0.21+fcdff87f5d", + "fabric-data-attachment-api-v1@2.2.30+3434d6d95d", + "fabric-data-generation-api-v1@27.2.4+427eab975d", + "fabric-debug-api-v1@1.0.4+3434d6d95d", + "fabric-dimensions-v1@5.1.19+47f74c985d", + "fabric-entity-events-v1@6.0.4+3434d6d95d", + "fabric-events-interaction-v0@5.3.6+3434d6d95d", + "fabric-game-rule-api-v1@4.0.10+3434d6d95d", + "fabric-item-api-v1@14.7.0+cf6bc2db5d", + "fabric-key-mapping-api-v1@2.0.8+3434d6d95d", + "fabric-lifecycle-events-v1@4.1.9+ffef5f675d", + "fabric-loot-api-v3@4.0.8+4068fd645d", + "fabric-menu-api-v1@2.0.27+ed66f0a35d", + "fabric-message-api-v1@7.0.10+3434d6d95d", + "fabric-model-loading-api-v1@8.0.35+fcdff87f5d", + "fabric-networking-api-v1@6.3.8+fcdff87f5d", + "fabric-object-builder-api-v1@24.1.9+3434d6d95d", + "fabric-particles-v1@5.0.24+3434d6d95d", + "fabric-permission-api-v1@1.0.8+fcdff87f5d", + "fabric-recipe-api-v1@10.0.8+fcdff87f5d", + "fabric-registry-sync-v0@8.0.1+fcdff87f5d", + "fabric-renderer-api-v1@17.0.15+79385d0b5d", + "fabric-renderer-indigo@9.1.23+b9d63e335d", + "fabric-rendering-fluids-v1@6.0.6+3434d6d95d", + "fabric-rendering-v1@27.0.14+901a437c5d", + "fabric-resource-conditions-api-v1@6.1.5+3434d6d95d", + "fabric-resource-loader-v0@3.3.26+4fc5413f5d", + "fabric-resource-loader-v1@3.0.4+fcdff87f5d", + "fabric-screen-api-v1@5.2.4+48607d035d", + "fabric-serialization-api-v1@2.0.7+74ed1ea55d", + "fabric-sound-api-v1@2.0.7+3434d6d95d", + "fabric-tag-api-v1@2.1.10+fcdff87f5d", + "fabric-transfer-api-v1@8.0.25+fcdff87f5d", + "fabric-transitive-access-wideners-v1@8.1.16+52268a0e5d", + "fabricloader@0.19.5", + "ferritecore@9.0.0", + "horizonlab@0.19.0", + "immediatelyfast@1.17.1+26.3", + "java@25", + "lithium@0.26.2+mc26.3", + "minecraft@26.3", + "mixinextras@0.5.5", + "sodium@0.9.2+mc26.3", + "transition@1.0.25", + "trender@1.0.17" + ], + "preceding_jfr_server_render_allocation_counters": [ + { + "thread_id": 55, + "thread": "Server thread", + "counter_observations": 2, + "observed_seconds": 64.387372441, + "observed_allocated_bytes": 691148360, + "observed_bytes_per_second": 10734222.158752 + }, + { + "thread_id": 3, + "thread": "Render thread", + "counter_observations": 2, + "observed_seconds": 64.387372441, + "observed_allocated_bytes": 107888768, + "observed_bytes_per_second": 1675619.9843200867 + } + ], + "preceding_jfr_gc_pause_total_ms": 54.65954, + "preceding_jfr_gc_pause_longest_ms": 25.746574, + "exit_code": 0 + } + ], + "provenance": { + "production_mod_source_commit": "2a268fefbf0ab3d478ca7755e609f7146d6f5145", + "workflow_run": "https://github.com/ludovic111/minecraft-optimization-lab/actions/runs/37179596850", + "runtime_mod_matches_linux_ci": true, + "original_mod_sha256": "df0bab0a6d87a1c609a051c190939010506f8cdd81897e82aa48caad032ef4e0", + "initial_player_snapshot_sha256": "b4d11dbd6443625415a1e32aa242d0e2d09cd77ddb1becfde5d35cb6ab8d278a", + "saved_first_cameras_match": true, + "saved_camera": { + "position": [ + -56.5, + 69.0, + 55.5 + ], + "rotation": [ + 141.5, + 16.950002670288086 + ] + }, + "private_world_timing_protocol": { + "world_copy": "private only", + "advance_time": false, + "advance_weather": false, + "overworld_clock_ticks": 6000, + "modified_file_sha256": { + "game_rules": "47abf5e1fe82d54057ad7b095df3b9e29a8e4e9db7484988e09f3caaeedc12eb", + "world_clocks": "575d4a7663b154077a5be4c596790f3af178a00ab5a1e9cd58f37c1afa2c03b5" + }, + "level_and_player_files_unchanged": true, + "pack_default_rules_unchanged": true + }, + "clock_and_rules_verified_after_both_saves": true, + "candidate_save_reload_second_save_exit_zero": true + }, + "notes": [ + "Separate private copies, baseline then core. JFR begins about 121 seconds after demo dismissal; a separate 120-second frame capture begins about 307 seconds after dismissal.", + "Both captures have zero menu/pause/focus exclusions and no drops. Actual CSV counts and means match; viewer charts, 390-pixel layout and explicit software-change warnings pass.", + "Core records about 20.7% higher average FPS and 22.2% lower sampled peak RSS in this pair; whole-process CPU is slightly higher while rendering more frames.", + "No mod is isolated by this group comparison. Rendering-work completion, entity activity, cache/JIT and thermal state remain variables. Matching captured configuration is not pixel equivalence or exhaustive vanilla gameplay proof.", + "Tick execution inverse meanRate is capacity, not actual TPS. Record counts/elapsed seconds are exposed separately and include any pauses. Both captures have about 20 tick samples per elapsed second.", + "Preceding JFR server/render allocation counters are lower with core, but total and longest measured GC pauses are higher. Those profiles precede the frame captures and are not simultaneous with them.", + "No hardware GPU or M2/Apple Silicon result; RSS is not complete unified/GPU memory. Repeat alternating trials on real hardware.", + "No private worlds, full game logs, JFR recordings, game binaries or fixture agents are included." + ] +} diff --git a/docs/core-performance.md b/docs/core-performance.md new file mode 100644 index 000000000..acf8c5f5d --- /dev/null +++ b/docs/core-performance.md @@ -0,0 +1,55 @@ +# Core performance comparison + +`core-performance` adds the pinned core performance mods while retaining the +baseline's 12 full-detail chunks, 12 simulation chunks, suggested heap, custom +graphics preset and OpenGL backend. Neither profile installs distant terrain or +Iris shaders; every original experimental controller is disabled. Use this pair +for the first comparison at the same view distance, then test balanced separately +for its additional 128-chunk distant horizon. + +The loaded-mod report also exposes dependencies bundled inside those downloads, +such as Transition and Trender in this observed core run. The comparator treats +these software changes as explicit experiment variables. Matching configuration +is not proof of pixel-identical rendering or exhaustive gameplay equivalence. + +The selected 4 October 2026 live observations use separate private world copies, +a stationary camera, native Linux x64 Java 25, G1, compact headers and the same +3 GiB maximum heap. The test copies use Peaceful difficulty and a noon clock with +weather/time advancement disabled to reduce lighting variation. Distributed packs +do not change world rules. First saved cameras and saved clock/rules are checked. +JFR begins roughly 121 seconds after demo dismissal; a separate 120-second frame +capture begins roughly 307 seconds after dismissal. + +| Observation | Vanilla baseline | Core mods | +| --- | ---: | ---: | +| Eligible frames | 651 | 785 | +| Average frame rate | 5.44 FPS | 6.56 FPS | +| 95th-percentile frame interval | 194.89 ms | 163.18 ms | +| Sampled peak process RSS | 2,710.76 MiB | 2,108.96 MiB | +| Average process CPU | 2.81 cores | 2.88 cores | +| Tick execution mean | 8.98 ms | 6.37 ms | +| Recorded tick samples | 2,401 | 2,402 | + +In this single fixed-order, software-rendered pair, average FPS is about 20.7% +higher and sampled peak RSS about 22.2% lower with the core stack. Process CPU is +slightly higher while more frames are rendered. Tick execution durations are +lower; their inverse is execution capacity, not observed TPS. Both captures span +about 120 seconds and record approximately 20 tick samples per elapsed second. +These are descriptive observations, not a statistical or universal speedup claim. +They do not isolate which mod caused a difference. Entity activity, completion +of rendering work, cache/JIT and thermal state remain possible variables. RSS +excludes a complete GPU/unified-memory measurement; Apple Silicon performance +remains unmeasured. Hardware graphics and repeated alternating trials are needed. + +Preceding JFR counter rates for the server and render thread are lower with the +core stack, but total and longest measured GC pauses are higher in that profile. +Those recordings precede the frame captures, so rates/pauses must not be treated +as if they covered the later frame interval. Selected observations retain both +findings instead of presenting only favorable measurements. + +The [selected raw observations](../benchmarks/core-client-2026-10-04/live-observations.json) +retain software identity, protocol and both positive and negative measurements. +Both clients save and exit with code zero; the core world reloads and saves again. +Actual JSON/CSV viewer and mobile checks pass. Windows, macOS ARM and Linux builds +pass, with byte-identical local and independent Linux production JARs. These are +platform build checks, not game graphics tests on each platform. diff --git a/packs/START-HERE.txt b/packs/START-HERE.txt index 7b045913f..c04d16226 100644 --- a/packs/START-HERE.txt +++ b/packs/START-HERE.txt @@ -26,8 +26,9 @@ PROFILES 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. + Lithium, FerriteCore, ImmediatelyFast and EntityCulling. After a first balanced smoke test, + compare this against baseline 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.