Complete instability regression slice and ordered modifiers (#73)

docs/LIVE_BLOCK_INSTABILITY.md

@@ -1,4 +1,4 @@
-# Live block-instability profiling (0.5.8.11–0.5.8.15)
+# Live block-instability profiling (0.5.8.11–0.5.8.17)
 
 Mystcraft Legacy measures the abundance of watched blocks in generated chunks,
 compares that abundance with a baseline, and adds only positive excess to the
@@ -26,8 +26,24 @@ Legacy weights are used for its watched blocks: coal/lapis 5, iron 60, emerald
 50. Deepslate variants inherit their ore's weight. Modern/high-value extensions
 include diamond, emerald, gold, iron, raw gold, raw iron and netherite storage
 blocks, plus ancient debris. Netherite blocks cost 8,000 per excess block per
-sampled chunk; ancient debris costs 4,000. Modded blocks are not automatically
-classified as valuable; this avoids charging unknown decorative materials.
+sampled chunk; ancient debris costs 4,000.
+
+Other mods remain optional. When an installed mod registers common-tagged ores
+or storage blocks, recognizable `*_ore` blocks, or source-fluid blocks,
+Rivencraft automatically includes those blocks in live profiling. The source
+fluid weight is 1.25; common mineral names such as tin,
+lead, zinc, silver, uranium, platinum, and iridium have explicit tiers, while
+other tagged ores use 60 and other tagged storage blocks use 120. The optional
+`instability_modded_materials.block_weight_overrides` list accepts a full-block
+`modid:block_id=points` entry to cover a block without common tags or replace
+its inferred weight; zero excludes it. Block entities and non-source fluid
+plants are excluded. Rivencraft never requires any particular content mod.
+
+Profiles written before 0.5.8.17 did not retain all modded material
+counts, so their block sample data resets and is collected again after upgrade.
+The saved Age definition and authored score are not changed. Later config
+changes can rescore materials already captured in the profile; a newly added
+override for a block that was not previously recognized needs fresh samples.
 
 The authored score and provider plan remain saved as the Age's immutable base.
 Only Ages created with instability schema v2 participate; existing v1 Ages
@@ -72,5 +88,7 @@ Do not retry that stalled scenario automatically. In a disposable world:
    receive little or no ore contribution. Check that profiling does not make
    chunk loading noticeably stall, and report any exception or server hang.
 
-Do not use a valued save for this check. The game jar builds, but live chunk
-profiling still needs this player-run validation before issue #73 is closed.
+Do not use a valued save for this check. The player reported an in-game pass
+for the 0.5.8.18 candidate on 2026-10-12. The three detailed scenarios above
+remain useful for future regression runs; the report does not establish that
+each was exercised individually.