3.7 KiB
Block-instability baselines
Issue #115 uses version-specific bundled averages when an individual Overworld material has a measured count of zero. It does not create a reference dimension.
Defaults
The defaults are averaged from the developer's existing Overworld profiles: 987 chunks for Minecraft 1.21.1 and 1,024 chunks for Minecraft 26.3. Every sampled chunk contributes to the denominator, including chunks without that block. Ore and deepslate variants retain separate averages.
The bundled JSON files are:
- 1.21.1: src/main/resources/assets/rivencraft/instability/default_block_baseline.json
- 26.3: ports/mc263/src/main/resources/assets/rivencraft/instability/default_block_baseline.json
Each records the source sample count and source-export SHA-256. They contain no save path, chunk coordinates, or dependency on the developer's save. Rebuild an average with scripts/generate_block_baseline.py SOURCE_JSON VERSION OUTPUT_JSON.
Scoring
For each watched block:
- A positive measured Overworld count uses its actual count divided by sampled chunks.
- A modded ore with zero measured occurrences uses the combined measured iron_ore and deepslate_iron_ore average. If that combined count is zero, it uses the combined bundled iron average. This takes precedence over any modded ore entry in the bundled JSON.
- Other zero-count materials use their own bundled average, or zero if absent.
The combined bundled iron average is 89.96656534954407 blocks/chunk for 1.21.1 and 76.5361328125 blocks/chunk for 26.3. Installed mods remain optional: unused resource IDs do not register blocks or make a mod required.
The existing readiness requirements remain: at least 401 sampled Age chunks and 500 sampled Overworld chunks. The 5% excess allowance, material weights, difficulty multipliers and score cap are unchanged. The baseline is selected per material, so one absent ore cannot replace all measured Overworld results. Storage blocks and fluids do not receive the modded-ore iron substitution. They use their own measured/default counts.
Existing saved profiles remain usable. The abandoned reference-source flag is no longer written or read. Existing Ages use this calculation without rebinding.
Validation
The former reference-world generation probes stalled on both versions and were stopped without retry. That implementation and its temporary fixture were removed. Their logs remain under build/verification/baseline115/.
The replacement is checked without starting a server: regenerate/compare the bundled averages and exercise the production shared Java policy with each version's actual resource. Production builds check both Minecraft integrations.
Player checks:
- In a void/skyblock or flat Overworld, enter an Age with valuable generated blocks. Allow the Age and Overworld profiles to reach the existing thresholds. Confirm excess materials produce block instability rather than every missing Overworld ore being compared against zero.
- A modded ore absent from the Overworld should use iron, even if the modded ore has an entry in the bundled defaults.
- In a normal Overworld, measured positive counts should still take priority.
- Reopen the save and verify profiles and scores persist normally.
Inside the Age, use /rivencraft age instability on 1.21.1 or /rivencraft_port instability status on 26.3 to inspect readiness and scoring; instability scores remain absent from the book GUI. The player reported in-game acceptance on both versions before publication. This is manual acceptance, not a passing result from the abandoned reference-world probes.
Offline verification: both source-average audits passed; the production shared Java policy passed 14 checks per version. Both production builds passed.