Skip to content

Phase finales: a boss ends each phase - #566

Merged
tastybento merged 2 commits into
developfrom
feature/phase-finales
Nov 11, 2026
Merged

tastybento merged 2 commits into
developfrom
feature/phase-finales

Conversation

@tastybento

Copy link
Copy Markdown
Member

What

A phase file can now carry an optional finale: section. Mining the last block of the phase seals the magic block and spawns a boss on top of it. The phase does not change until the boss is dead.

Requested in BentoBoxWorld/ChunkBlock#4; the ChunkBlock port follows this PR.

How it plays

  • Omen: over the last 20 blocks a Warden heartbeat plays on each break, rising in pitch, with a bell toll 5 blocks from the end.
  • Summon: the next hit on the magic block is cancelled and the boss spawns with a raid horn, cosmetic lightning and a red boss bar.
  • Fight: anyone can attack. Only player damage counts (melee, projectiles, pets). Finale mobs cannot change blocks, start fires or burn in daylight.
  • Void: void-respawn: true (default) returns the boss to the magic block. false lets the void kill it, which counts as a win.
  • Losing: if the island has no living players for about 10 seconds the boss retreats; hitting the block summons it again. Each lost fight makes the next attempt 10% easier, down to half health.
  • Scaling and rewards: health grows 50% per extra player on the island, capped at 4. drops fall on every kill; first-time-commands run once per island.
  • A boss removed by a restart or a mob-clearing plugin is never a win. If the boss cannot spawn, or the world is peaceful, the finale is waived so an island is never locked.

Details

  • GIANT has no AI in vanilla, so giant bosses get an attack goal through Paper's mob goal API (GiantAttackGoal).
  • All default phases ship with a finale; 0_plains.yml documents the keys. Existing servers keep their phase files, so admins add finale: sections by hand.
  • island.phase-finales in config.yml turns the feature off.
  • /ob setcount (player and admin) clears a pending or running finale.
  • New events: PhaseFinaleStartEvent (cancelling waives the finale) and PhaseFinaleEndEvent.
  • Only en-US has the four new aoneblock.finale.* messages.

Testing

  • mvn test: 610 tests pass, including new FinaleListenerTest and parser tests that check every shipped phase file's finale.
  • Played the Plains giant fight on a Paper 26.3 test server.
  • Boss stats are first guesses and need play-testing. There is no test that drives a real block break through the gate in BlockListener.

🤖 Generated with Claude Code

tastybento and others added 2 commits November 11, 2026 09:17
A phase file may now carry a finale: section. Mining the last block of
the phase seals the magic block and spawns the boss on it; the phase does
not change until the boss is dead.

- Only player damage hurts the boss, and finale mobs cannot change
  blocks, start fires or burn in daylight.
- void-respawn (default true) returns a boss knocked into the void to
  the magic block; false lets the void kill it as a win.
- The boss retreats if the island empties, and each lost fight makes the
  next attempt 10% easier, down to half health. Health scales with
  players on the island, capped at four.
- The last blocks of the phase are forewarned by a rising heartbeat and
  a bell toll.
- GIANT bosses get an attack goal through Paper's mob goal API.
- All default phases ship with a finale. island.phase-finales turns the
  feature off.
- New events: PhaseFinaleStartEvent (cancellable) and PhaseFinaleEndEvent.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
The block count is already in the next phase while a boss is pending, so
the phase boss bar and action bar showed the next phase at 0 blocks.

- While a boss is pending they now name it and say to hit the magic
  block to face it.
- While the boss is alive they are hidden; the boss has its own bar.
- They refresh as soon as the fight ends instead of on the next break.
- Restore the missing space in the defeated message.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
@tastybento
tastybento merged commit 61e177e into develop Nov 11, 2026
1 check passed
@sonarqubecloud

Copy link
Copy Markdown

@tastybento tastybento mentioned this pull request Nov 13, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant