diff --git a/README.md b/README.md index 9bcb945c6..47a14219d 100644 --- a/README.md +++ b/README.md @@ -49,6 +49,10 @@ 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) + +[Heap budget experiment](docs/heap-budget.md): three pairs with 3 GiB versus +1.5 GiB maximum heap show variable RAM savings and GC/frame-time tradeoffs; +playable defaults remain unchanged. include three repeated matched-view software-rendered pairs with 14–21% higher FPS in this workload; M2 performance remains unmeasured. diff --git a/benchmarks/heap-budget-2026-10-04/live-observations.json b/benchmarks/heap-budget-2026-10-04/live-observations.json new file mode 100644 index 000000000..dc9cf3a31 --- /dev/null +++ b/benchmarks/heap-budget-2026-10-04/live-observations.json @@ -0,0 +1,1387 @@ +{ + "schema": 1, + "measurement": "Three fixed-order heap experiments, 3 GiB then 1.5 GiB, same core profile; descriptive stationary Linux software-rendering observations", + "release": "0.20.0", + "source_commit": "86e33927409b2e78a3f60678375ebfa39dc5cfb7", + "original_mod_sha256": "e651ef49bc97486e8dacfd4b640465c442525cd645e2dba71ddea9fb64347dd8", + "private_fixture_sha256": "fe02ea765362f8185517dc206816e4ef0b5b83925776d1512ca7d9e2d347b3ae", + "host_cpu": "Intel Core i7-7500U, 2 physical cores / 4 logical processors", + "protocol": { + "warmup_seconds": 180, + "capture_seconds": 120, + "gc": "g1", + "compact_headers": true, + "framebuffer": [ + 1280, + 800 + ], + "full_detail_chunks": 12, + "simulation_chunks": 12, + "lod": "not installed", + "camera_yaw": 141.5, + "camera_pitch": 16.950002670288086, + "world_clock": 6000, + "advance_time": false, + "advance_weather": false, + "experiment_variable": "heap maximum only", + "control_heap": "3G", + "candidate_heap": "1536M", + "minimum_heap_bytes": 536870912, + "host_total_ram_bytes": 32456794112, + "new_process_per_run": true, + "stationary_position": [ + -56.5, + 69.0, + 55.5 + ], + "same_initial_world_copies": true, + "private_fixture_present_in_both_profiles": true, + "camera_enforced_each_client_tick": true, + "world_difficulty": "PEACEFUL", + "profiling_during_capture": false, + "native_gpu_access": "unavailable to this user", + "order": [ + "3G", + "1536M", + "3G", + "1536M", + "3G", + "1536M" + ] + }, + "settings": { + "minecraft": "26.3", + "kind": "frames", + "os": "Linux", + "os_version": "7.0.0-31-generic", + "architecture": "amd64", + "gpu": "llvmpipe (LLVM 21.1.8, 256 bits)", + "graphics_backend": "OpenGL", + "graphics_driver": "4.5 (Core Profile) Mesa 26.0.8-1ubuntu0.3", + "java_version": "25.0.4.1", + "framebuffer_width": 1280, + "framebuffer_height": 800, + "render_distance": 12, + "simulation_distance": 12, + "vsync": false, + "fps_limit": 260, + "graphics_preset": "CUSTOM", + "ambient_occlusion": true, + "improved_transparency": false, + "mipmap_levels": 4, + "entity_distance_scaling": 1.0, + "entity_shadows": true, + "particles": "ALL", + "clouds": "FANCY", + "cloud_range": 128, + "fov": 70, + "world_difficulty": "PEACEFUL", + "dh_capture_status": "not_installed", + "iris_capture_status": "not_installed", + "iris_shaders_enabled": false, + "garbage_collectors": [ + "G1 Concurrent GC", + "G1 Old Generation", + "G1 Young Generation" + ], + "compact_object_headers": true, + "fps_limit_unlimited": true + }, + "software": { + "java_vendor": "Ubuntu", + "java_vm_name": "OpenJDK 64-Bit Server VM", + "java_runtime_version": "25.0.4.1+1-1-26.04.4-Ubuntu", + "core-performance_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", + "horizon_client_batch_private_fixture@1", + "horizonlab@0.20.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" + ] + }, + "runs": [ + { + "index": 1, + "profile": "core-performance", + "heap_max_bytes": 3221225472, + "frames": { + "elapsed_seconds": 120.029256497, + "dropped_samples": 0, + "excluded_frames": 0, + "process_cpu_seconds": 366.31, + "process_cpu_mean_cores": 3.051839282276613, + "process_rss_peak_sampled_bytes": 2181107712, + "process_rss_samples": 120, + "process_rss_sample_interval_ms": 1000, + "heap_used_peak_sampled_bytes": 752473600, + "heap_committed_end_bytes": 796917760, + "nonheap_used_peak_sampled_bytes": 252488416, + "gc_collections": 9, + "gc_time_ms": 95, + "visual_settings_changed": [], + "stats": { + "count": 772, + "meanMs": 154.92052194818652, + "p50Ms": 152.873334, + "p95Ms": 166.257887, + "p99Ms": 197.525633, + "maxMs": 278.492088, + "meanRate": 6.454922739896603, + "lowOnePercentRate": 4.572392883862186, + "over16Ms": 772, + "over33Ms": 772, + "over50Ms": 772, + "over100Ms": 772 + }, + "private_report_sha256": "32a9faa75cd2ce9e48f9eaf970f8d1aa7159983c6d1acfd506a5a5c8d1e78a4c", + "private_csv_sha256": "ac47723331d18fc410971e8dcf38db456ca1f806ad4e86f8ea7e71fa27311016" + }, + "ticks": { + "elapsed_seconds": 120.013413533, + "dropped_samples": 0, + "excluded_frames": 0, + "process_cpu_seconds": 366.28, + "process_cpu_mean_cores": 3.051992183351107, + "process_rss_peak_sampled_bytes": 2181107712, + "process_rss_samples": 119, + "process_rss_sample_interval_ms": 1000, + "heap_used_peak_sampled_bytes": 752003928, + "heap_committed_end_bytes": 796917760, + "nonheap_used_peak_sampled_bytes": 252380992, + "gc_collections": 9, + "gc_time_ms": 95, + "observed_ticks_per_second": 20.006097062973705, + "tick_state_capture_status": "sampled_server_ticks", + "tick_state_samples": 2401, + "tick_state_invalid_samples": 0, + "tick_state_first": { + "sprinting": false, + "configured_tick_rate": 20.0, + "frozen": false, + "runs_game_elements": true, + "stepping": false + }, + "tick_state_last": { + "sprinting": false, + "configured_tick_rate": 20.0, + "frozen": false, + "runs_game_elements": true, + "stepping": false + }, + "tick_state_changed": [], + "tick_state_frozen_samples": 0, + "tick_state_stepping_samples": 0, + "tick_state_sprinting_samples": 0, + "tick_state_suppressed_samples": 0, + "tick_state_nonstandard_rate_samples": 0, + "stats": { + "count": 2401, + "meanMs": 7.05376176301541, + "p50Ms": 6.871681, + "p95Ms": 11.928427, + "p99Ms": 14.819835, + "maxMs": 103.622545, + "meanRate": 141.7683264046772, + "lowOnePercentRate": 49.38054632914065, + "over16Ms": 6, + "over33Ms": 1, + "over50Ms": 1, + "over100Ms": 1 + }, + "private_report_sha256": "3989b2757e3e2b01d24ef3078de5fd3dbaa809c07b033bdab16db1fa62caaf01", + "private_csv_sha256": "81071b7868f873daa01d290d27f7339e97b3e9202ecd5bb3a52045c026630c9b" + }, + "saved_camera_and_position_verified": true, + "saved_clock_and_weather_rules_verified": true, + "all_original_experiments_disabled": true, + "csv_counts_and_means_verified": true, + "launcher_exit_code": 0 + }, + { + "index": 2, + "profile": "core-performance", + "heap_max_bytes": 1610612736, + "frames": { + "elapsed_seconds": 120.08679883, + "dropped_samples": 0, + "excluded_frames": 0, + "process_cpu_seconds": 347.79, + "process_cpu_mean_cores": 2.896155142684304, + "process_rss_peak_sampled_bytes": 2140647424, + "process_rss_samples": 120, + "process_rss_sample_interval_ms": 1000, + "heap_used_peak_sampled_bytes": 685213656, + "heap_committed_end_bytes": 725614592, + "nonheap_used_peak_sampled_bytes": 253346416, + "gc_collections": 10, + "gc_time_ms": 162, + "visual_settings_changed": [], + "stats": { + "count": 780, + "meanMs": 153.53161113589744, + "p50Ms": 150.759433, + "p95Ms": 173.645525, + "p99Ms": 199.34945, + "maxMs": 245.114678, + "meanRate": 6.5133166557788345, + "lowOnePercentRate": 4.569524134771657, + "over16Ms": 780, + "over33Ms": 780, + "over50Ms": 780, + "over100Ms": 780 + }, + "private_report_sha256": "ce133f4fec3278ce8d0b994e5c30ac627a6efbda48dec0150ec135698c1761af", + "private_csv_sha256": "4e36bf0cbcb80f5b061764e4b9c43c86ba69785a32435a8c42d6046b2528e680" + }, + "ticks": { + "elapsed_seconds": 120.0134453, + "dropped_samples": 0, + "excluded_frames": 0, + "process_cpu_seconds": 347.54, + "process_cpu_mean_cores": 2.895842204440072, + "process_rss_peak_sampled_bytes": 2140647424, + "process_rss_samples": 119, + "process_rss_sample_interval_ms": 1000, + "heap_used_peak_sampled_bytes": 684554936, + "heap_committed_end_bytes": 725614592, + "nonheap_used_peak_sampled_bytes": 253346416, + "gc_collections": 10, + "gc_time_ms": 162, + "observed_ticks_per_second": 20.006091767452993, + "tick_state_capture_status": "sampled_server_ticks", + "tick_state_samples": 2401, + "tick_state_invalid_samples": 0, + "tick_state_first": { + "frozen": false, + "configured_tick_rate": 20.0, + "sprinting": false, + "stepping": false, + "runs_game_elements": true + }, + "tick_state_last": { + "frozen": false, + "configured_tick_rate": 20.0, + "sprinting": false, + "stepping": false, + "runs_game_elements": true + }, + "tick_state_changed": [], + "tick_state_frozen_samples": 0, + "tick_state_stepping_samples": 0, + "tick_state_sprinting_samples": 0, + "tick_state_suppressed_samples": 0, + "tick_state_nonstandard_rate_samples": 0, + "stats": { + "count": 2401, + "meanMs": 6.542429990837151, + "p50Ms": 5.564132, + "p95Ms": 10.992684, + "p99Ms": 13.829129, + "maxMs": 138.557407, + "meanRate": 152.84840669300655, + "lowOnePercentRate": 44.69009824767729, + "over16Ms": 10, + "over33Ms": 1, + "over50Ms": 1, + "over100Ms": 1 + }, + "private_report_sha256": "57d5daa20d82fa3510caa3c4a63aabf97c71d06314a5eda87ee712944d2af67a", + "private_csv_sha256": "b1c961e4ae39310f6635b95ad0995465ed5346d1bbc9dea7a61cfde6da50902f" + }, + "saved_camera_and_position_verified": true, + "saved_clock_and_weather_rules_verified": true, + "all_original_experiments_disabled": true, + "csv_counts_and_means_verified": true, + "launcher_exit_code": 0 + }, + { + "index": 3, + "profile": "core-performance", + "heap_max_bytes": 3221225472, + "frames": { + "elapsed_seconds": 120.01164803, + "dropped_samples": 0, + "excluded_frames": 0, + "process_cpu_seconds": 345.46, + "process_cpu_mean_cores": 2.878553920979765, + "process_rss_peak_sampled_bytes": 2603356160, + "process_rss_samples": 120, + "process_rss_sample_interval_ms": 1000, + "heap_used_peak_sampled_bytes": 1068649272, + "heap_committed_end_bytes": 1149239296, + "nonheap_used_peak_sampled_bytes": 275992368, + "gc_collections": 4, + "gc_time_ms": 72, + "visual_settings_changed": [], + "stats": { + "count": 784, + "meanMs": 152.60759124617348, + "p50Ms": 150.497902, + "p95Ms": 166.177231, + "p99Ms": 192.91669, + "maxMs": 246.597903, + "meanRate": 6.552753973993901, + "lowOnePercentRate": 4.797708840709534, + "over16Ms": 784, + "over33Ms": 784, + "over50Ms": 784, + "over100Ms": 784 + }, + "private_report_sha256": "e8b50e8d96742ad3be650ddb274122c9a2db1a048675e482c55118d287291a70", + "private_csv_sha256": "3e85ab8ec17c38805873f3c4fe6100a2ba454cfc6915a89293e79ce1933d3d33" + }, + "ticks": { + "elapsed_seconds": 120.005235194, + "dropped_samples": 0, + "excluded_frames": 0, + "process_cpu_seconds": 345.45, + "process_cpu_mean_cores": 2.878624415356104, + "process_rss_peak_sampled_bytes": 2603356160, + "process_rss_samples": 119, + "process_rss_sample_interval_ms": 1000, + "heap_used_peak_sampled_bytes": 1072843576, + "heap_committed_end_bytes": 1149239296, + "nonheap_used_peak_sampled_bytes": 276006608, + "gc_collections": 4, + "gc_time_ms": 72, + "observed_ticks_per_second": 19.99912750573064, + "tick_state_capture_status": "sampled_server_ticks", + "tick_state_samples": 2400, + "tick_state_invalid_samples": 0, + "tick_state_first": { + "sprinting": false, + "configured_tick_rate": 20.0, + "frozen": false, + "runs_game_elements": true, + "stepping": false + }, + "tick_state_last": { + "sprinting": false, + "configured_tick_rate": 20.0, + "frozen": false, + "runs_game_elements": true, + "stepping": false + }, + "tick_state_changed": [], + "tick_state_frozen_samples": 0, + "tick_state_stepping_samples": 0, + "tick_state_sprinting_samples": 0, + "tick_state_suppressed_samples": 0, + "tick_state_nonstandard_rate_samples": 0, + "stats": { + "count": 2400, + "meanMs": 6.301040273333333, + "p50Ms": 5.455708, + "p95Ms": 10.616525, + "p99Ms": 12.983533, + "maxMs": 105.912716, + "meanRate": 158.70395309677758, + "lowOnePercentRate": 53.05080994815685, + "over16Ms": 2, + "over33Ms": 1, + "over50Ms": 1, + "over100Ms": 1 + }, + "private_report_sha256": "58571f1c9fc3ddced41a770a615ee878c3dc1321610f9971caf0d25fe200321b", + "private_csv_sha256": "36a84320cd47d5e79f88d734cefb205c37a26db3a447c982b4e662913b3a0516" + }, + "saved_camera_and_position_verified": true, + "saved_clock_and_weather_rules_verified": true, + "all_original_experiments_disabled": true, + "csv_counts_and_means_verified": true, + "launcher_exit_code": 0 + }, + { + "index": 4, + "profile": "core-performance", + "heap_max_bytes": 1610612736, + "frames": { + "elapsed_seconds": 120.163736965, + "dropped_samples": 0, + "excluded_frames": 0, + "process_cpu_seconds": 346.74, + "process_cpu_mean_cores": 2.885562722645641, + "process_rss_peak_sampled_bytes": 2094477312, + "process_rss_samples": 121, + "process_rss_sample_interval_ms": 1000, + "heap_used_peak_sampled_bytes": 707671544, + "heap_committed_end_bytes": 746586112, + "nonheap_used_peak_sampled_bytes": 257110408, + "gc_collections": 12, + "gc_time_ms": 93, + "visual_settings_changed": [], + "stats": { + "count": 780, + "meanMs": 153.575491525641, + "p50Ms": 150.109864, + "p95Ms": 174.220873, + "p99Ms": 208.168144, + "maxMs": 261.709053, + "meanRate": 6.5114556370020775, + "lowOnePercentRate": 4.5538671941137805, + "over16Ms": 780, + "over33Ms": 780, + "over50Ms": 780, + "over100Ms": 780 + }, + "private_report_sha256": "23e4aed503a128036e49a0b54702a96f465ac2d5c0e77f122e477d0a45c538c6", + "private_csv_sha256": "a2852bfb23340ba48fc16d91bf96f750e923bf59ae3e80b24ccfed85e45c9385" + }, + "ticks": { + "elapsed_seconds": 120.018507965, + "dropped_samples": 0, + "excluded_frames": 0, + "process_cpu_seconds": 346.26, + "process_cpu_mean_cores": 2.885055029187473, + "process_rss_peak_sampled_bytes": 2093166592, + "process_rss_samples": 119, + "process_rss_sample_interval_ms": 1000, + "heap_used_peak_sampled_bytes": 705452000, + "heap_committed_end_bytes": 746586112, + "nonheap_used_peak_sampled_bytes": 257056624, + "gc_collections": 12, + "gc_time_ms": 93, + "observed_ticks_per_second": 20.00524786310611, + "tick_state_capture_status": "sampled_server_ticks", + "tick_state_samples": 2401, + "tick_state_invalid_samples": 0, + "tick_state_first": { + "frozen": false, + "configured_tick_rate": 20.0, + "sprinting": false, + "stepping": false, + "runs_game_elements": true + }, + "tick_state_last": { + "frozen": false, + "configured_tick_rate": 20.0, + "sprinting": false, + "stepping": false, + "runs_game_elements": true + }, + "tick_state_changed": [], + "tick_state_frozen_samples": 0, + "tick_state_stepping_samples": 0, + "tick_state_sprinting_samples": 0, + "tick_state_suppressed_samples": 0, + "tick_state_nonstandard_rate_samples": 0, + "stats": { + "count": 2401, + "meanMs": 6.8819487946688875, + "p50Ms": 6.168063, + "p95Ms": 10.993984, + "p99Ms": 13.568333, + "maxMs": 815.762583, + "meanRate": 145.30767807726954, + "lowOnePercentRate": 21.095148722405945, + "over16Ms": 3, + "over33Ms": 1, + "over50Ms": 1, + "over100Ms": 1 + }, + "private_report_sha256": "1e10adb0814ab6df145d55f526ddf958884ae422d6467308512254a51e269f21", + "private_csv_sha256": "8790ed40bd2b08cfb7d6c75e32692e9cc07abdf9b727b8fe83efc98a4dddbd92" + }, + "saved_camera_and_position_verified": true, + "saved_clock_and_weather_rules_verified": true, + "all_original_experiments_disabled": true, + "csv_counts_and_means_verified": true, + "launcher_exit_code": 0 + }, + { + "index": 5, + "profile": "core-performance", + "heap_max_bytes": 3221225472, + "frames": { + "elapsed_seconds": 120.138822898, + "dropped_samples": 0, + "excluded_frames": 0, + "process_cpu_seconds": 347.93, + "process_cpu_mean_cores": 2.896066330659813, + "process_rss_peak_sampled_bytes": 2351783936, + "process_rss_samples": 121, + "process_rss_sample_interval_ms": 1000, + "heap_used_peak_sampled_bytes": 876452296, + "heap_committed_end_bytes": 929038336, + "nonheap_used_peak_sampled_bytes": 258679120, + "gc_collections": 6, + "gc_time_ms": 71, + "visual_settings_changed": [], + "stats": { + "count": 786, + "meanMs": 152.38283862849875, + "p50Ms": 149.828045, + "p95Ms": 166.554163, + "p99Ms": 204.182013, + "maxMs": 275.337158, + "meanRate": 6.562418767102423, + "lowOnePercentRate": 4.3805191368670435, + "over16Ms": 786, + "over33Ms": 786, + "over50Ms": 786, + "over100Ms": 786 + }, + "private_report_sha256": "d039b29ab7323ebb63b93bc432c6c199f8d4879e076866735baa4586d99e671e", + "private_csv_sha256": "7ca324fc247dd5b5d5fb47ed39387cbe36e3cefd3c08826a321b3a8579c67176" + }, + "ticks": { + "elapsed_seconds": 120.044132105, + "dropped_samples": 0, + "excluded_frames": 0, + "process_cpu_seconds": 347.61, + "process_cpu_mean_cores": 2.8956850610236664, + "process_rss_peak_sampled_bytes": 2348769280, + "process_rss_samples": 119, + "process_rss_sample_interval_ms": 1000, + "heap_used_peak_sampled_bytes": 876452296, + "heap_committed_end_bytes": 929038336, + "nonheap_used_peak_sampled_bytes": 258672504, + "gc_collections": 6, + "gc_time_ms": 71, + "observed_ticks_per_second": 20.000977622962004, + "tick_state_capture_status": "sampled_server_ticks", + "tick_state_samples": 2401, + "tick_state_invalid_samples": 0, + "tick_state_first": { + "sprinting": false, + "configured_tick_rate": 20.0, + "frozen": false, + "runs_game_elements": true, + "stepping": false + }, + "tick_state_last": { + "sprinting": false, + "configured_tick_rate": 20.0, + "frozen": false, + "runs_game_elements": true, + "stepping": false + }, + "tick_state_changed": [], + "tick_state_frozen_samples": 0, + "tick_state_stepping_samples": 0, + "tick_state_sprinting_samples": 0, + "tick_state_suppressed_samples": 0, + "tick_state_nonstandard_rate_samples": 0, + "stats": { + "count": 2401, + "meanMs": 6.601056462307372, + "p50Ms": 5.995629, + "p95Ms": 10.930844, + "p99Ms": 14.00976, + "maxMs": 100.24067, + "meanRate": 151.4909023593557, + "lowOnePercentRate": 48.12884187999018, + "over16Ms": 10, + "over33Ms": 1, + "over50Ms": 1, + "over100Ms": 1 + }, + "private_report_sha256": "6513e873ca666433da0302555753cbfe218902dd9e3a23cebf50cf741a0cd6d7", + "private_csv_sha256": "79a8f9a6e14afa28ebaf2469107f2272c95efc86b12d88c40e8d501b2a807e57" + }, + "saved_camera_and_position_verified": true, + "saved_clock_and_weather_rules_verified": true, + "all_original_experiments_disabled": true, + "csv_counts_and_means_verified": true, + "launcher_exit_code": 0 + }, + { + "index": 6, + "profile": "core-performance", + "heap_max_bytes": 1610612736, + "frames": { + "elapsed_seconds": 120.133011724, + "dropped_samples": 0, + "excluded_frames": 0, + "process_cpu_seconds": 347.31, + "process_cpu_mean_cores": 2.8910454754762043, + "process_rss_peak_sampled_bytes": 2086072320, + "process_rss_samples": 121, + "process_rss_sample_interval_ms": 1000, + "heap_used_peak_sampled_bytes": 687347288, + "heap_committed_end_bytes": 723517440, + "nonheap_used_peak_sampled_bytes": 254699328, + "gc_collections": 12, + "gc_time_ms": 105, + "visual_settings_changed": [], + "stats": { + "count": 785, + "meanMs": 152.54083483821657, + "p50Ms": 150.068788, + "p95Ms": 165.816361, + "p99Ms": 196.179025, + "maxMs": 234.934386, + "meanRate": 6.555621654100628, + "lowOnePercentRate": 4.819789867295394, + "over16Ms": 785, + "over33Ms": 785, + "over50Ms": 785, + "over100Ms": 785 + }, + "private_report_sha256": "1f8d8b261c973cdf01815c1f36b7c8af470ec49589f45579756ebe08d1bbe60c", + "private_csv_sha256": "70263c816a7d834255bbe5ff1c0abb8c7e73549e63f31ceb3e6f8b36d8455d76" + }, + "ticks": { + "elapsed_seconds": 120.013463778, + "dropped_samples": 0, + "excluded_frames": 0, + "process_cpu_seconds": 346.89, + "process_cpu_mean_cores": 2.890425699583794, + "process_rss_peak_sampled_bytes": 2085285888, + "process_rss_samples": 119, + "process_rss_sample_interval_ms": 1000, + "heap_used_peak_sampled_bytes": 683314328, + "heap_committed_end_bytes": 723517440, + "nonheap_used_peak_sampled_bytes": 254683128, + "gc_collections": 12, + "gc_time_ms": 105, + "observed_ticks_per_second": 20.006088687193895, + "tick_state_capture_status": "sampled_server_ticks", + "tick_state_samples": 2401, + "tick_state_invalid_samples": 0, + "tick_state_first": { + "frozen": false, + "configured_tick_rate": 20.0, + "sprinting": false, + "stepping": false, + "runs_game_elements": true + }, + "tick_state_last": { + "frozen": false, + "configured_tick_rate": 20.0, + "sprinting": false, + "stepping": false, + "runs_game_elements": true + }, + "tick_state_changed": [], + "tick_state_frozen_samples": 0, + "tick_state_stepping_samples": 0, + "tick_state_sprinting_samples": 0, + "tick_state_suppressed_samples": 0, + "tick_state_nonstandard_rate_samples": 0, + "stats": { + "count": 2401, + "meanMs": 6.677182864639733, + "p50Ms": 6.189319, + "p95Ms": 10.953284, + "p99Ms": 14.067298, + "maxMs": 156.284835, + "meanRate": 149.76375820043606, + "lowOnePercentRate": 46.32227314081777, + "over16Ms": 9, + "over33Ms": 1, + "over50Ms": 1, + "over100Ms": 1 + }, + "private_report_sha256": "66cd01cb09f26eadd6e8f4df7d64c58279394030896077ff4e00ee873bb0d6bb", + "private_csv_sha256": "920203b0854c4359217199c44c1ade6995df21922b83594075d9c3bed2c1b09b" + }, + "saved_camera_and_position_verified": true, + "saved_clock_and_weather_rules_verified": true, + "all_original_experiments_disabled": true, + "csv_counts_and_means_verified": true, + "launcher_exit_code": 0 + } + ], + "pairs": [ + { + "pair": 1, + "frames": { + "kind": "frames", + "mismatches": [ + "heap_max_bytes: 3221225472 vs 1610612736" + ], + "warnings": [ + "World, route, warm-up, shader state and LOD cache must also match; these are not verified by this tool." + ], + "metrics": [ + { + "metric": "meanRate", + "baseline": 6.454922739896603, + "candidate": 6.5133166557788345, + "change_percent": 0.9046415927073781 + }, + { + "metric": "lowOnePercentRate", + "baseline": 4.572392883862186, + "candidate": 4.569524134771657, + "change_percent": -0.06274065163239806 + }, + { + "metric": "p95Ms", + "baseline": 166.257887, + "candidate": 173.645525, + "change_percent": 4.4434812286529235 + }, + { + "metric": "p99Ms", + "baseline": 197.525633, + "candidate": 199.34945, + "change_percent": 0.9233318087885856 + }, + { + "metric": "maxMs", + "baseline": 278.492088, + "candidate": 245.114678, + "change_percent": -11.985047848109787 + }, + { + "metric": "heap_used_end_bytes", + "baseline": 458011584, + "candidate": 635672712, + "change_percent": 38.78965821091547 + }, + { + "metric": "heap_used_peak_sampled_bytes", + "baseline": 752473600, + "candidate": 685213656, + "change_percent": -8.938512128531817 + }, + { + "metric": "nonheap_used_peak_sampled_bytes", + "baseline": 252488416, + "candidate": 253346416, + "change_percent": 0.33981757008607616 + }, + { + "metric": "process_rss_last_sampled_bytes", + "baseline": 2130587648, + "candidate": 2134691840, + "change_percent": 0.19263192499274773 + }, + { + "metric": "process_rss_peak_sampled_bytes", + "baseline": 2181107712, + "candidate": 2140647424, + "change_percent": -1.8550339250737569 + }, + { + "metric": "process_cpu_mean_cores", + "baseline": 3.051839282276613, + "candidate": 2.896155142684304, + "change_percent": -5.1013217011929735 + }, + { + "metric": "gc_time_ms", + "baseline": 95, + "candidate": 162, + "change_percent": 70.52631578947368 + } + ], + "experiment_variable": { + "field": "heap_max_bytes", + "control": 3221225472, + "candidate": 1610612736 + } + }, + "ticks": { + "kind": "ticks", + "mismatches": [ + "heap_max_bytes: 3221225472 vs 1610612736" + ], + "warnings": [ + "World, route, warm-up, shader state and LOD cache must also match; these are not verified by this tool.", + "Tick-manager state is sampled after measured server invocations. Changes entirely between samples, paused intervals and completed world work are not verified.", + "Tick durations exclude scheduler sleep. Observed TPS counts measured invocations, including frozen ticks, and includes recording time spent paused; tick execution capacity is not TPS." + ], + "metrics": [ + { + "metric": "meanMs", + "baseline": 7.05376176301541, + "candidate": 6.542429990837151, + "change_percent": -7.249064957924933 + }, + { + "metric": "p95Ms", + "baseline": 11.928427, + "candidate": 10.992684, + "change_percent": -7.844647077104117 + }, + { + "metric": "p99Ms", + "baseline": 14.819835, + "candidate": 13.829129, + "change_percent": -6.68500020411833 + }, + { + "metric": "maxMs", + "baseline": 103.622545, + "candidate": 138.557407, + "change_percent": 33.71357265930885 + }, + { + "metric": "heap_used_end_bytes", + "baseline": 455914432, + "candidate": 632526984, + "change_percent": 38.73809197599605 + }, + { + "metric": "heap_used_peak_sampled_bytes", + "baseline": 752003928, + "candidate": 684554936, + "change_percent": -8.969234001128779 + }, + { + "metric": "nonheap_used_peak_sampled_bytes", + "baseline": 252380992, + "candidate": 253346416, + "change_percent": 0.3825264305166165 + }, + { + "metric": "process_rss_last_sampled_bytes", + "baseline": 2130587648, + "candidate": 2134691840, + "change_percent": 0.19263192499274773 + }, + { + "metric": "process_rss_peak_sampled_bytes", + "baseline": 2181107712, + "candidate": 2140647424, + "change_percent": -1.8550339250737569 + }, + { + "metric": "process_cpu_mean_cores", + "baseline": 3.051992183351107, + "candidate": 2.895842204440072, + "change_percent": -5.1163295818006045 + }, + { + "metric": "gc_time_ms", + "baseline": 95, + "candidate": 162, + "change_percent": 70.52631578947368 + }, + { + "metric": "observed_ticks_per_second", + "baseline": 20.006097062973705, + "candidate": 20.006091767452993, + "change_percent": -2.646953424223497e-05 + } + ], + "experiment_variable": { + "field": "heap_max_bytes", + "control": 3221225472, + "candidate": 1610612736 + } + } + }, + { + "pair": 2, + "frames": { + "kind": "frames", + "mismatches": [ + "heap_max_bytes: 3221225472 vs 1610612736" + ], + "warnings": [ + "World, route, warm-up, shader state and LOD cache must also match; these are not verified by this tool." + ], + "metrics": [ + { + "metric": "meanRate", + "baseline": 6.552753973993901, + "candidate": 6.5114556370020775, + "change_percent": -0.6302439730794918 + }, + { + "metric": "lowOnePercentRate", + "baseline": 4.797708840709534, + "candidate": 4.5538671941137805, + "change_percent": -5.08246028868421 + }, + { + "metric": "p95Ms", + "baseline": 166.177231, + "candidate": 174.220873, + "change_percent": 4.840399585187449 + }, + { + "metric": "p99Ms", + "baseline": 192.91669, + "candidate": 208.168144, + "change_percent": 7.905720339696898 + }, + { + "metric": "maxMs", + "baseline": 246.597903, + "candidate": 261.709053, + "change_percent": 6.127850162618764 + }, + { + "metric": "heap_used_end_bytes", + "baseline": 831071096, + "candidate": 492274672, + "change_percent": -40.766238367649834 + }, + { + "metric": "heap_used_peak_sampled_bytes", + "baseline": 1068649272, + "candidate": 707671544, + "change_percent": -33.77887745381817 + }, + { + "metric": "nonheap_used_peak_sampled_bytes", + "baseline": 275992368, + "candidate": 257110408, + "change_percent": -6.841479036840614 + }, + { + "metric": "process_rss_last_sampled_bytes", + "baseline": 2595528704, + "candidate": 2094477312, + "change_percent": -19.304405735441254 + }, + { + "metric": "process_rss_peak_sampled_bytes", + "baseline": 2603356160, + "candidate": 2094477312, + "change_percent": -19.54703147494041 + }, + { + "metric": "process_cpu_mean_cores", + "baseline": 2.878553920979765, + "candidate": 2.885562722645641, + "change_percent": 0.2434834246040518 + }, + { + "metric": "gc_time_ms", + "baseline": 72, + "candidate": 93, + "change_percent": 29.166666666666675 + } + ], + "experiment_variable": { + "field": "heap_max_bytes", + "control": 3221225472, + "candidate": 1610612736 + } + }, + "ticks": { + "kind": "ticks", + "mismatches": [ + "heap_max_bytes: 3221225472 vs 1610612736" + ], + "warnings": [ + "World, route, warm-up, shader state and LOD cache must also match; these are not verified by this tool.", + "Tick-manager state is sampled after measured server invocations. Changes entirely between samples, paused intervals and completed world work are not verified.", + "Tick durations exclude scheduler sleep. Observed TPS counts measured invocations, including frozen ticks, and includes recording time spent paused; tick execution capacity is not TPS." + ], + "metrics": [ + { + "metric": "meanMs", + "baseline": 6.301040273333333, + "candidate": 6.8819487946688875, + "change_percent": 9.219247872355618 + }, + { + "metric": "p95Ms", + "baseline": 10.616525, + "candidate": 10.993984, + "change_percent": 3.5553912414843847 + }, + { + "metric": "p99Ms", + "baseline": 12.983533, + "candidate": 13.568333, + "change_percent": 4.504166932066966 + }, + { + "metric": "maxMs", + "baseline": 105.912716, + "candidate": 815.762583, + "change_percent": 670.2215690512553 + }, + { + "metric": "heap_used_end_bytes", + "baseline": 831071096, + "candidate": 490177520, + "change_percent": -41.01858164009593 + }, + { + "metric": "heap_used_peak_sampled_bytes", + "baseline": 1072843576, + "candidate": 705452000, + "change_percent": -34.24465450683745 + }, + { + "metric": "nonheap_used_peak_sampled_bytes", + "baseline": 276006608, + "candidate": 257056624, + "change_percent": -6.86577185137538 + }, + { + "metric": "process_rss_last_sampled_bytes", + "baseline": 2595528704, + "candidate": 2093166592, + "change_percent": -19.354904888002345 + }, + { + "metric": "process_rss_peak_sampled_bytes", + "baseline": 2603356160, + "candidate": 2093166592, + "change_percent": -19.597378792765717 + }, + { + "metric": "process_cpu_mean_cores", + "baseline": 2.878624415356104, + "candidate": 2.885055029187473, + "change_percent": 0.22339190194680114 + }, + { + "metric": "gc_time_ms", + "baseline": 72, + "candidate": 93, + "change_percent": 29.166666666666675 + }, + { + "metric": "observed_ticks_per_second", + "baseline": 19.99912750573064, + "candidate": 20.00524786310611, + "change_percent": 0.030603121929773103 + } + ], + "experiment_variable": { + "field": "heap_max_bytes", + "control": 3221225472, + "candidate": 1610612736 + } + } + }, + { + "pair": 3, + "frames": { + "kind": "frames", + "mismatches": [ + "heap_max_bytes: 3221225472 vs 1610612736" + ], + "warnings": [ + "World, route, warm-up, shader state and LOD cache must also match; these are not verified by this tool." + ], + "metrics": [ + { + "metric": "meanRate", + "baseline": 6.562418767102423, + "candidate": 6.555621654100628, + "change_percent": -0.10357633736920446 + }, + { + "metric": "lowOnePercentRate", + "baseline": 4.3805191368670435, + "candidate": 4.819789867295394, + "change_percent": 10.027823568475892 + }, + { + "metric": "p95Ms", + "baseline": 166.554163, + "candidate": 165.816361, + "change_percent": -0.44298022139499516 + }, + { + "metric": "p99Ms", + "baseline": 204.182013, + "candidate": 196.179025, + "change_percent": -3.9195362424015334 + }, + { + "metric": "maxMs", + "baseline": 275.337158, + "candidate": 234.934386, + "change_percent": -14.673926430227768 + }, + { + "metric": "heap_used_end_bytes", + "baseline": 775600136, + "candidate": 575344472, + "change_percent": -25.819446736146524 + }, + { + "metric": "heap_used_peak_sampled_bytes", + "baseline": 876452296, + "candidate": 687347288, + "change_percent": -21.576189470099806 + }, + { + "metric": "nonheap_used_peak_sampled_bytes", + "baseline": 258679120, + "candidate": 254699328, + "change_percent": -1.5385053111360514 + }, + { + "metric": "process_rss_last_sampled_bytes", + "baseline": 2351783936, + "candidate": 2086072320, + "change_percent": -11.298300491495494 + }, + { + "metric": "process_rss_peak_sampled_bytes", + "baseline": 2351783936, + "candidate": 2086072320, + "change_percent": -11.298300491495494 + }, + { + "metric": "process_cpu_mean_cores", + "baseline": 2.896066330659813, + "candidate": 2.8910454754762043, + "change_percent": -0.17336810039377815 + }, + { + "metric": "gc_time_ms", + "baseline": 71, + "candidate": 105, + "change_percent": 47.887323943661976 + } + ], + "experiment_variable": { + "field": "heap_max_bytes", + "control": 3221225472, + "candidate": 1610612736 + } + }, + "ticks": { + "kind": "ticks", + "mismatches": [ + "heap_max_bytes: 3221225472 vs 1610612736" + ], + "warnings": [ + "World, route, warm-up, shader state and LOD cache must also match; these are not verified by this tool.", + "Tick-manager state is sampled after measured server invocations. Changes entirely between samples, paused intervals and completed world work are not verified.", + "Tick durations exclude scheduler sleep. Observed TPS counts measured invocations, including frozen ticks, and includes recording time spent paused; tick execution capacity is not TPS." + ], + "metrics": [ + { + "metric": "meanMs", + "baseline": 6.601056462307372, + "candidate": 6.677182864639733, + "change_percent": 1.1532457382700922 + }, + { + "metric": "p95Ms", + "baseline": 10.930844, + "candidate": 10.953284, + "change_percent": 0.20529064361360927 + }, + { + "metric": "p99Ms", + "baseline": 14.00976, + "candidate": 14.067298, + "change_percent": 0.41069939813387357 + }, + { + "metric": "maxMs", + "baseline": 100.24067, + "candidate": 156.284835, + "change_percent": 55.909607347995575 + }, + { + "metric": "heap_used_end_bytes", + "baseline": 773502984, + "candidate": 573247320, + "change_percent": -25.88944944522671 + }, + { + "metric": "heap_used_peak_sampled_bytes", + "baseline": 876452296, + "candidate": 683314328, + "change_percent": -22.036335449339727 + }, + { + "metric": "nonheap_used_peak_sampled_bytes", + "baseline": 258672504, + "candidate": 254683128, + "change_percent": -1.5422497321168738 + }, + { + "metric": "process_rss_last_sampled_bytes", + "baseline": 2348769280, + "candidate": 2085285888, + "change_percent": -11.217934185515233 + }, + { + "metric": "process_rss_peak_sampled_bytes", + "baseline": 2348769280, + "candidate": 2085285888, + "change_percent": -11.217934185515233 + }, + { + "metric": "process_cpu_mean_cores", + "baseline": 2.8956850610236664, + "candidate": 2.890425699583794, + "change_percent": -0.18162753645636354 + }, + { + "metric": "gc_time_ms", + "baseline": 71, + "candidate": 105, + "change_percent": 47.887323943661976 + }, + { + "metric": "observed_ticks_per_second", + "baseline": 20.000977622962004, + "candidate": 20.006088687193895, + "change_percent": 0.025554072047073717 + } + ], + "experiment_variable": { + "field": "heap_max_bytes", + "control": 3221225472, + "candidate": 1610612736 + } + } + } + ], + "summary_of_paired_percent_changes": { + "frames.meanRate": { + "paired_percent_changes": [ + 0.9046415927073781, + -0.6302439730794918, + -0.10357633736920446 + ], + "minimum": -0.6302439730794918, + "maximum": 0.9046415927073781, + "arithmetic_mean": 0.056940427419560624, + "median": -0.10357633736920446 + }, + "frames.lowOnePercentRate": { + "paired_percent_changes": [ + -0.06274065163239806, + -5.08246028868421, + 10.027823568475892 + ], + "minimum": -5.08246028868421, + "maximum": 10.027823568475892, + "arithmetic_mean": 1.6275408760530945, + "median": -0.06274065163239806 + }, + "frames.p95Ms": { + "paired_percent_changes": [ + 4.4434812286529235, + 4.840399585187449, + -0.44298022139499516 + ], + "minimum": -0.44298022139499516, + "maximum": 4.840399585187449, + "arithmetic_mean": 2.946966864148459, + "median": 4.4434812286529235 + }, + "frames.process_rss_peak_sampled_bytes": { + "paired_percent_changes": [ + -1.8550339250737569, + -19.54703147494041, + -11.298300491495494 + ], + "minimum": -19.54703147494041, + "maximum": -1.8550339250737569, + "arithmetic_mean": -10.900121963836554, + "median": -11.298300491495494 + }, + "frames.process_cpu_mean_cores": { + "paired_percent_changes": [ + -5.1013217011929735, + 0.2434834246040518, + -0.17336810039377815 + ], + "minimum": -5.1013217011929735, + "maximum": 0.2434834246040518, + "arithmetic_mean": -1.6770687923275667, + "median": -0.17336810039377815 + }, + "frames.gc_time_ms": { + "paired_percent_changes": [ + 70.52631578947368, + 29.166666666666675, + 47.887323943661976 + ], + "minimum": 29.166666666666675, + "maximum": 70.52631578947368, + "arithmetic_mean": 49.193435466600775, + "median": 47.887323943661976 + }, + "ticks.meanMs": { + "paired_percent_changes": [ + -7.249064957924933, + 9.219247872355618, + 1.1532457382700922 + ], + "minimum": -7.249064957924933, + "maximum": 9.219247872355618, + "arithmetic_mean": 1.0411428842335926, + "median": 1.1532457382700922 + }, + "ticks.observed_ticks_per_second": { + "paired_percent_changes": [ + -2.646953424223497e-05, + 0.030603121929773103, + 0.025554072047073717 + ], + "minimum": -2.646953424223497e-05, + "maximum": 0.030603121929773103, + "arithmetic_mean": 0.018710241480868195, + "median": 0.025554072047073717 + } + }, + "limits": [ + "Only one stationary world view on a Linux software renderer; no native GPU or Mac performance measurement.", + "Three pairs, always 3 GiB first; not randomized, no significance or confidence interval claim.", + "Captured heap_max_bytes mismatch is the explicit experiment variable; other captured settings and software identities match.", + "This is one settled view without LOD/shaders, not a proof that a 1.5 GiB heap fits movement, generation, long sessions or all worlds.", + "Separate JVMs reduce process carryover but OS file cache, JIT state, entities and thermal state can still vary.", + "Reported GC time is JVM collector-accounting time, not a JFR stop-the-world pause measurement.", + "RSS is sampled once per second and excludes a complete GPU/unified-memory accounting.", + "Tick-manager state is sampled after measured invocations, not completed-world-work or pause tracing.", + "Do not pool these core-only heap experiments with vanilla/core comparisons.", + "The fixture camera enforcement and private clock/weather rules are not included in playable packs.", + "Matching settings and saved poses do not prove identical pixels, entity activity or exhaustive vanilla equivalence." + ] +} diff --git a/docs/heap-budget.md b/docs/heap-budget.md new file mode 100644 index 000000000..abe9b5cf2 --- /dev/null +++ b/docs/heap-budget.md @@ -0,0 +1,70 @@ +# Heap budget experiment + +Halving the maximum Java heap from 3 GiB to 1.5 GiB does not halve total process +RAM in this workload. Three repeated core-profile pairs show nearly unchanged +average FPS and variable sampled RSS reductions, with more GC accounting time +in every smaller-heap run. Playable memory recommendations remain unchanged. + +## Matched experiment + +These runs use the exact published 0.20.0 mod and the same private camera fixture +as the [repeated core comparison](core-performance.md). Both sides use the core +stack, 12 full-detail / 12 simulation chunks, 1280×800, FOV 70, uncapped FPS, +OpenGL, no LOD/shaders, G1 and compact headers. Only maximum heap differs. The +initial heap is 512 MiB in both sides. Every run uses a fresh process and the same +initial world copy, warms for 180 seconds and records for 120 seconds. Each pair +runs 3 GiB first, followed by 1.5 GiB. + +The host is an i7-7500U with 2 physical cores / 4 logical processors and about +30.2 GiB total RAM, using Linux llvmpipe software rendering. This is not a test +under low system-memory pressure. Private copies use Peaceful difficulty and +fixed noon/weather advancement rules. The camera is stationary and every +original experimental controller is disabled. Those fixture rules are absent +from playable packs. + +## Results + +| Pair | 3 GiB FPS | 1.5 GiB FPS | 3 GiB peak RSS | 1.5 GiB peak RSS | 3 GiB p95 frame | 1.5 GiB p95 frame | GC accounting | +| --- | ---: | ---: | ---: | ---: | ---: | ---: | ---: | +| 1 | 6.4549 | 6.5133 | 2,080.07 MiB | 2,041.48 MiB | 166.26 ms | 173.65 ms | 95 → 162 ms | +| 2 | 6.5528 | 6.5115 | 2,482.75 MiB | 1,997.45 MiB | 166.18 ms | 174.22 ms | 72 → 93 ms | +| 3 | 6.5624 | 6.5556 | 2,242.84 MiB | 1,989.43 MiB | 166.55 ms | 165.82 ms | 71 → 105 ms | + +Paired average-FPS changes are +0.90%, −0.63%, −0.10%. Their descriptive +arithmetic mean is +0.06%; this does not establish an FPS improvement. Peak +sampled RSS is 1.86%, 19.55% and 11.30% lower, illustrating substantial process +variation. A smaller configured heap limit is not a total resident-memory cap. +The smaller-heap captures still use roughly 1.94–1.99 GiB of sampled process RSS. + +p95 frame intervals are 4.44% and 4.84% worse in the first two pairs and 0.44% +better in the third. Slowest-1%-average FPS changes are −0.06%, −5.08%, +10.03%. +CPU changes are −5.10%, +0.24%, −0.17%, without a consistent absolute reduction. +GC accounting time increases 29–71%; these MXBean totals are not measured +stop-the-world pause durations. Tick execution means change −7.25%, +9.22%, ++1.15%, while observed invocation throughput stays near 20 TPS in every run. + +## Validation and limits + +All six clients save and exit with code zero. Frame/tick CSV counts and mean +durations match their JSONs, with zero exclusions or dropped samples. Captured +settings, Java/collector/header configuration and loaded mod identities match +apart from the intentional heap maximum. Sampled tick-manager state remains +normal at 20 configured TPS, without freeze, step, sprint or rate changes. Saved +camera, position, clock and weather rules match across runs. + +All three actual frame/tick JSON+CSV pairs pass desktop/mobile viewer checks, +including duration traces and the visible intentional heap mismatch. The +[selected observations](../benchmarks/heap-budget-2026-10-04/live-observations.json) +retain all six runs, paired metrics, configuration, software identity and private +capture/fixture hashes. Raw worlds, CSVs and complete logs remain private. + +These are sampled peaks during settled recordings, not whole-session startup +peaks or complete GPU/unified-memory accounting. Three fixed-order pairs in one +world cannot establish capacity for exploration, generation, long sessions, +shaders, distant terrain, all hardware or 50 dedicated-server players. JIT, OS +cache, entities and thermal effects can still vary. Do not pool this experiment +with vanilla/core comparisons or infer physical M2 results from it. + +The 16 GB Mac starter retains its 6 GiB recommendation for balanced distant +terrain. See the [Mac test procedure](mac-first-test.md) and +[memory measurement limits](process-memory.md) when measuring another budget. diff --git a/docs/process-memory.md b/docs/process-memory.md index 2ae5fc34d..64ff7aab3 100644 --- a/docs/process-memory.md +++ b/docs/process-memory.md @@ -42,6 +42,11 @@ collectors these can include cycle duration and overlapping phases; it is not a direct stop-the-world pause measurement. The viewer calls it collection time. Use [JFR pause events](profiling.md) when investigating GC-induced stalls. +The [three-pair heap experiment](heap-budget.md) compares 3 GiB and 1.5 GiB +maximum heaps with the same core stack. It records variable RSS savings, nearly +unchanged average FPS and increased GC accounting; playable defaults remain +unchanged. + The native-read test exercises the real library, overlapping recordings, background execution, idle cancellation and unavailable-reader behavior on the build platform. This validates measurement availability, not an FPS or