Minecraft 26.3 brings the Dappled Forest biome, and AOneBlock 1.28.0 adds it as a new phase. Players who finish Sulfur Caves now get an autumn forest of poplar trees before looping back to Plains. The phase is full of poplar logs, yellow, orange and red poplar leaves, leaf litter and red shrubs, with wool stairs in every colour mixed in. Its chests hold cushions, straw beds, spears and other 26.3 items.

Servers that are already running AOneBlock get the new phase automatically. Until now, phases shipped in a later version never reached a server that already had a phases_index.yml. The index now remembers which shipped phases it has seen, so future phases will arrive the same way. Phases that an admin removed stay removed.

This release also fixes a crash in the block-break handler when no phase covers the current block count, and updates the death-setting comments in config.yml for Level 2.29.0.

• When it happens: after Sulfur Caves, for 500 blocks. The loop back to Plains moves from block 15500 to 16000.
• Blocks: poplar logs, yellow, orange and red poplar leaves (made persistent, so they don't decay), leaf litter, red shrub, grass, dirt and stone. All 16 colours of the new wool stairs are included, so every wool stair is a random colour.
• Mobs: based on the biome's natural spawns: sheep, pigs, chickens, cows, rabbits and foxes, plus the usual overworld hostile mobs. Passive mobs are weighted up so the phase isn't mostly hostile.
• Chests: six chests with poplar saplings, shelf mushrooms, leaf litter, cushions in many colours, straw beds, a copper axe, a spyglass, an iron spear, a poplar chest boat and diamonds.
• Minecraft 26.3 only. The biome and its blocks don't exist before 26.3. On older servers the phase is skipped and takes up no blocks, just as Sulfur Caves is on servers older than 26.2.

A server's phases_index.yml belongs to that server: it holds the admin's phase order, lengths and enabled flags, so an upgrade never replaces it. The downside was that phases shipped in later versions never appeared on a server that already had an index.

• The index now has a shippedPhases list, recording every phase this server has been offered from the addon jar.
• On startup, a shipped phase is added if it isn't in the index and has never been offered. It goes straight after the phase that comes before it in the shipped order, even if the admin has moved that phase. Its phase and chest files are copied into the phases folder.
• If you delete a phase's entry and files, it doesn't come back, because it's already in shippedPhases. To just turn a phase off, disabling it in /oba phases still works as before.

• Block-break handler no longer throws an NPE when no phase covers the block count (PR #564). This could happen if a goto pointed below the first phase or phase files failed to load. Now AOneBlock logs an error with the island and block number, and cancels the break so the magic block isn't lost.

PR #562. Level 2.29.0 tracks deaths per island itself. The comments on the deaths settings in config.yml now explain which settings still affect island levels:

• counted is still the on/off switch.
• max now caps deaths per island member.
• team-join-reset and reset-on-new-* only affect BentoBox's own death counter.

Only comments changed. No keys or defaults were altered, so existing configs are unaffected.

✔️ BentoBox API 3.22.0+ ✔️ Minecraft 26.x, or 1.21.5+. The Sulfur Caves phase needs 26.2+ and the Dappled Forest phase needs 26.3+. ✔️ Java 25 server, required by BentoBox 3.22.0

🔺 Dappled Forest is added to your phase order on the first start. You'll see Phase index: added new phase Dappled Forest in the log. The phase goes after Sulfur Caves, and its files are copied into your phases folder. If you don't want it, disable it in /oba phases. Your existing phase order, lengths and enabled flags are not changed.

🔺 phases_index.yml gets a new shippedPhases list. It's written automatically on the first start. Leave it in place: it's how AOneBlock knows which phases you've removed on purpose.

On servers older than 26.3, Dappled Forest is added to the index but skipped when phases load, so it has no effect until you update Minecraft.

1. Take backups of your server, for safety
2. Stop the server
3. Drop the new jar into your addons folder and delete the old one
4. Start the server
5. You should be good to go!

• ⚙️ configuration-related section
• 🔺 special attention needed

• ⚙️ docs: clarify which deaths settings affect Level 2.29.0 island levels by @tastybento in https://github.com/BentoBoxWorld/AOneBlock/pull/562
• fix: handle missing phase in processPhase without NPE by @tastybento in https://github.com/BentoBoxWorld/AOneBlock/pull/564
• 🔺 feat: add Dappled Forest phase (MC 26.3) and add new shipped phases on upgrade by @tastybento in https://github.com/BentoBoxWorld/AOneBlock/commit/2259bd5
• feat: add wool stairs and cushions to the Dappled Forest phase by @tastybento in https://github.com/BentoBoxWorld/AOneBlock/commit/163a0b3

Full Changelog: https://github.com/BentoBoxWorld/AOneBlock/compare/1.27.1...1.28.0