Sulfur Caves phase (MC 26.2), version-gated phase index, and phase order GUI

[tastybento]

What this does

Three features building on each other, in three commits:

1. Sulfur Caves phase + version gating (5a987cf)

• New Sulfur Caves phase at the 15000 spot with wiki-accurate mob weights (Sulfur Cube 100, Creeper/Skeleton/Zombie 50 each, Slime 25, Cave Spider 20, Enderman 10, Witch/Zombie Villager 5, ambient Bat 10 — the 315-weight monster table), ~1750 total block weight mixing sulfur/cinnabar with typical underground blocks, and themed chests including the Bounce music disc. The goto loop moves from 15000 to 15500.
• New phases_index.yml: read before any phase file, listing every phase with file, section, name, length, optional enabled and requiredMinecraftVersion. Start blocks are the running sum of lengths, so a skipped phase collapses out of the progression.
• Phases declaring requiredMinecraftVersion: '26.2' are skipped with one info log on older servers without their files ever being parsed — this matters because YamlConfiguration eagerly deserializes ItemStacks during parsing, which threw stack traces for unknown items on older servers.
• Legacy installs get an index generated automatically from their existing files; a malformed index falls back to the old direct folder scan.
• Chest files are read with plain SnakeYAML and each item is built individually — items unknown to the server version (e.g. pink_harness on 1.21.5) are skipped with a log line instead of a stack trace.
• Block/mob entries accept an object form with weight + requiredMinecraftVersion, used for DRIED_GHAST (1.21.6) in The Nether.

2. Length-based phase model (4f7a319)

• New PhaseIndexEntry class; OneBlocksManager keeps the live index (including disabled/version-skipped entries) plus gotoAtEnd, exposing getPhaseIndex()/saveIndex() so tools can reorder entries, save, and reload.
• Loaded phases reference their index entry; saving a phase (e.g. /oba setchest) writes back to its stable file name and section key instead of deriving them from the computed start block.

3. Phase order GUI (a9b71ad)

• New /oba phases admin command (permission aoneblock.admin.phases) opens a panel showing every phase in order with computed start, length, and state.
• Click a phase to pick it up — the rest shrink left. Click a phase to shove it and everything after it right and drop there, or use the drop-at-end slot. Click anywhere else or close the panel to put it back without saving. Right-click toggles a phase on/off. Drops and toggles save the index and reload phases immediately.
• Disabled phases render as gray glass, version-locked ones as barriers; both can still be reordered.

Testing

• 542 tests pass (34 added): version comparison, index generation/migration, gated-phase skipping (proved by planting an invalid-YAML chest file that would error if parsed), disabled-phase collapse, malformed-index fallback, unknown-chest-item skipping, versioned block/mob entries, index reorder round-trip, stable save naming, and the GUI pick-up/drop/toggle logic.
• Manually verified on Paper 26.2 (sulfur phase loads and plays) and Paper 1.21.5 (phase skipped with one info line, no stack traces, island creation works).

🤖 Generated with Claude Code

https://claude.ai/code/session_01VahJUVuDRo5kRSDZKJHHjC