What's new
Every phase now ends with a boss fight. When the last block of a phase is mined, the magic block seals itself and a boss rises on top of it. The next phase doesn't start until the boss is dead. Each of the 20 shipped phases has its own boss, from The Colossus (a giant) at the end of Plains to the Warden at the end of Deep Dark.
Phase finales were requested in ChunkBlock #4 to give phases a proper ending and more to play for. This release also fixes the my_island placeholders for team members.
✨ Highlights
⚔️ 🔡 ⚙️ Phase finales
[PR #54]
- The warning: over the last 20 blocks of a phase a heartbeat plays and rises in pitch, and a bell tolls five blocks from the end. The phase bar shows the boss's name once it is waiting.
- The fight: the boss spawns on the magic block with a raid horn and a lightning flash. The magic block can't be mined until the boss is dead, and the phase bar steps aside for the boss's own health bar.
- Fair to the island: only players (melee, projectiles and pets) can hurt the boss. The boss and its minions can't break, burn or blow up blocks, and the boss is pulled back if it leaves the island or wanders into a locked chunk.
- Knock-off rules: players can still be knocked off. A boss knocked into the void comes back to the magic block, unless the phase file sets
void-respawn: false, in which case the void kills it and that counts as a win. - Losing: if everyone dies or leaves, the boss retreats after about ten seconds. Hitting the magic block summons it again. Each lost fight makes the next attempt 10% easier, down to half health.
- Teams: boss health grows by 50% for each extra player on the island, up to four players.
- Rewards: each boss has item drops, plus
commandsthat run on every win andfirst-time-commandsthat run only the first time an island beats it.
A few of the shipped bosses:
| Phase | Boss |
|---|---|
| Plains | The Colossus (giant) |
| Underground | The Broodmother (spider) |
| Ocean | The Drowned King |
| Jungle | The Temple Guardian (iron golem) |
| Plenty | The Harvest Beast (ravager) |
| Deep Dark | The Warden |
| Jagged Peaks | The Gale (breeze) |
| Sulfur Caves | Brimstone (blaze) |
Boss health, damage and rewards are first settings and will be tuned as people play. Feedback is welcome.
🛠️ Making your own
A finale is a finale: section in a phase file. 0_plains.yml documents every option: boss, name, health, scale, damage, speed, void-respawn, warning, minions, drops, commands and first-time-commands. A phase with no finale: section ends the way it always has.
For developers, PhaseFinaleStartEvent (cancellable; cancelling it skips the fight) and PhaseFinaleEndEvent are fired around each fight.
🐛 Fixes
my_islandplaceholders now work for team members (PR #53). A team member who owns no island of their own got0,0%andUnknownfrom everymy_island_*placeholder, including the chunk territory ones. They now fall back to the team island.- The magic block is kept when no phase covers the block count (PR #54). This could happen if a goto pointed at a block number with no phase. It used to throw an error; now ChunkBlock logs it and cancels the break.
⚙️ Compatibility
✔️ BentoBox API 3.22.0+ ✔️ Minecraft 1.21+ (Paper) ✔️ Java 21
🔺 Updating: important notes
🔺 Existing servers don't get bosses automatically. Your phase files belong to your server and an upgrade never overwrites them, so they have no finale: sections. To add the bosses, copy the finale: section from each shipped phase file into your own file in plugins/BentoBox/addons/ChunkBlock/phases/ and restart. New installs have them from the start.
⚙️ New config option island.phase-finales (default true). Set it to false to turn all finales off. It is added to config.yml automatically.
🔡 Five new messages under chunkblock.finale in en-US.yml. Delete plugins/BentoBox/locales/ChunkBlock/en-US.yml to regenerate it, or add the keys by hand if you have customised it. The other languages are not translated yet and show the English text.
Finales are skipped on Peaceful difficulty, because the boss could not spawn. The giant bosses use Paper's mob goal API to move and attack.
📥 How to update
- Take backups of your server, for safety
- Stop the server
- Drop the new jar into your addons folder and delete the old one
- Start the server
- You should be good to go!
Legend
- 🔡 locale files may need to be regenerated or updated
- ⚙️ config options have been removed, renamed, or added
- 🔺 special attention needed
What's Changed
- fix: my_island placeholders fall back to team island for members by @tastybento in https://github.com/BentoBoxWorld/ChunkBlock/pull/53
- 🔺 🔡 ⚙️ Phase finales: a boss ends each phase by @tastybento in https://github.com/BentoBoxWorld/ChunkBlock/pull/54
Full Changelog: https://github.com/BentoBoxWorld/ChunkBlock/compare/1.4.1...1.5.0