Skip to content

Tier 4: boss zombies, buildables, perma-perks, easter-egg quest framework#170

Open
ikbenignace wants to merge 30 commits into
TheTurkeyDev:masterfrom
ikbenignace:feat/bo2-tier4
Open

Tier 4: boss zombies, buildables, perma-perks, easter-egg quest framework#170
ikbenignace wants to merge 30 commits into
TheTurkeyDev:masterfrom
ikbenignace:feat/bo2-tier4

Conversation

@ikbenignace

@ikbenignace ikbenignace commented Jun 26, 2026

Copy link
Copy Markdown
Contributor

Tier 4 — big systems (final tier)

Last tier of the BO2 fidelity effort: the large/foundational systems. Each is a contained, config-driven, documented system; approximations are flagged in-code.

Stacking: builds on #169 (Tier 3) → #168 → #167 → #166 → #165/#164. Merge in order; diff reduces to just the Tier 4 commits once parents land.

What's in this PR

  • Boss zombies — new BOSS round type (config bossRoundEveryX, default off). George Romero (tanky glowing zombie, drops Max Ammo + random perk on death) and Brutus (armored brute that temporarily disables a hit player's perk). Alternate by boss-round index; boss rounds take precedence over dog rounds.
  • Buildables — parts→assembly-station framework (Buildable + BuildableManager + BuildableSign), persisted per arena. Concrete buildable: a Zombie Shield (buy parts at the station, assemble, then it absorbs zombie melee for N hits).
  • Perma-perks — progression persisted in playerdata.json: lifetime revives unlock Perma Jugg (lite) and Perma Quick Revive (lite), auto-applied on game entry.
  • Easter-egg quest framework — generic per-arena multi-step objective engine (Quest/QuestStep/QuestManager + QuestSign) with INTERACT and REACH_ROUND triggers and a completion reward. Map-specific eggs are authored via arenas.json + quest signs.

Testing

Pure logic extracted into testable statics and covered by the JUnit harness (133 tests green, JDK 21 / target 17): boss-round cadence + boss health, buildable completion, perma-perk unlock gate, quest step-matching + advance flow. These are large Bukkit-glue systems — compile-verified throughout; in-game playtest strongly recommended before merge, especially bosses (custom AI), buildables (item/shield handling), and the quest engine (arena authoring).

Approximation notes (documented in-code)

  • George is killable here (canonically electric-stun-only) so boss rounds can end.
  • Brutus perk-disable is a reversible remove+re-grant, not a greyed icon.
  • Quest progress is per-game (only the definition persists); single linear track.

🤖 Generated with Claude Code

Ignace Mella and others added 30 commits June 26, 2026 14:19
@claude
Backport unfinished fixes from PR TheTurkeyDev#155 (shift-to-repair, …
ac29b7a 
…spawn selection, thread-safety)

Cherry-picks/finishes three items from skbeh's PR TheTurkeyDev#155 that were not yet on
master:

* Shift-to-repair barriers (resolves TheTurkeyDev#97): new BarrierRepairListener lets a
  player repair a nearby barrier by holding sneak, alongside the existing
  sign-break repair. Reimplements the PR's listener with a corrected detection
  box - the PR left a "// TODO: incorrect subtract" on its asymmetric bounding
  box; this uses a symmetric cuboid centred on the repair sign.
* Rewrite SpawnManager.getNearestPoints: replaces the manual insertion-sort
  over a parallel POSITIVE_INFINITY distance list with a
  stream/distanceSquared/limit. Extracted to a package-private static for
  testing.
* Thread-safety: activeActions and isEditingASign are now ConcurrentHashMap.
  AsyncPlayerChatEvent reads them off the async chat thread while the main
  thread mutates them.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@claude
Migrate to Minecraft 26.2 and fix door/sign crash
a750242 
Migrate from the 20 per-version NMS modules (topping out at an untested
1.21.5) to a single build that runs on Minecraft 26.2 (Java 25 server):

- Build against spigot-api 26.2, targeting Java 17 bytecode (26.2's API is
  Java 17; Java 25 is only needed to run the server). Drop the unused
  server jar and add jsr305 (26.2 no longer ships javax.annotation).
- Replace the 20 NMS support modules with one pure-Bukkit NMSUtil_Modern
  (Lidded + Player#sendBlockDamage). Keep the INMSUtil seam and version
  dispatch so older versions can be re-added later as a module + a case.
- Fix enum/registry renames surfaced by compiling against 26.2:
  Attribute.GENERIC_* -> *, PotionEffectType.SLOW -> SLOWNESS,
  Particle REDSTONE/SPELL_WITCH/CRIT_MAGIC/SMOKE_NORMAL/FIREWORKS_SPARK ->
  DUST/WITCH/ENCHANTED_HIT/SMOKE/FIREWORK, EntityType.FIREWORK ->
  FIREWORK_ROCKET, GameRule.DO_DAYLIGHT_CYCLE -> ADVANCE_TIME.
- Route config-driven Sound/Material lookups through a new Compat helper
  (graceful fallback + warning instead of crashing on a stale name).
- Bump plugin.yml api-version to 1.21.

Fix a ClassCastException that corrupted game state:

Door.closeDoor cast a block to Sign without checking. A wall sign mounted
on a door block pops off when the door opens (block -> air), so closeDoor
threw inside endGame and aborted the entire game-end cleanup, leaving the
player "still in game" with broken teleport-back and rejoin state.

- Door.closeDoor: guard the cast and recreate the sign if it popped off.
- Game.endGame: isolate each door's close so one failure cannot abort the
  rest of the cleanup.
- Guard the remaining unguarded (Sign) casts in SignManager (runs on a
  repeating task) and PlayerChatListener.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Merge branch 'feat/pr155-backport' into feat/bo2-fidelity
829fd60
@claude
Tier 0a + config foundation for BO2 fidelity
8fe02af 
- 0a: two-phase zombie HP curve (linear to r9, x1.1 compounding after) in
  RoundSpawner.zombieHealth(), wired into both spawners. TDD'd.
- Config foundation: expose every BO2 tunable in config.yml + ConfigSetup
  (board scaling, attack cooldown, kill bonuses, perk rewire multipliers,
  knife round, dog scaling, power-up cap/refresh, PaP re-pack, teleporter).
- Default tweaks: zombieDamage 9->10 (2-hit down), healTime 5->2.5.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@claude
Tier 0k: teleporter cooldown, charge-up delay, pad zombie kill, sound
7c94155 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Tier 0b+0g: player-scaled board/round counts + dog scaling + last-dog…
0f98e20 
… Max Ammo
@claude
Tier 0c+0d+0f: stacking per-zombie damage, kill-type point bonuses, f…
a7394e5 
…lat knife

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@claude
Tier 0e+0h+0i: Speed Cola/Double Tap rewire, per-gun fire_delay+reloa…
945646f 
…d, roster+kits

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@claude
Tier 0j: power-up cap, timer refresh on re-pickup, PaP re-pack ammo r…
e846071 
…efill

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@claude
Tier 0L: teleport stuck zombies to a reachable spawn
321507c 
Zombies that make no progress for zombieStuckSeconds (default 6) are
teleported to the door-open spawn point nearest the targeted player so
they can resume pathing. Fixes the common "1 zombie left wedged on
geometry" round hang. Pure accumulator SpawnManager.updateStuckTicks is
TDD-covered; both thresholds are config-exposed.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@claude
Tier 1: Deadshot mechanic, Bonus Points + Random Perk power-ups, gren…
fcab332 
…ade cap

- Deadshot Daiquiri: perk-gated extra headshot damage multiplier (config).
- Bonus Points power-up: flat points to every player (config, double-points aware).
- Random Perk Bottle power-up: grants a random perk via the Wunderfizz path.
- Grenade/equipment buy-to-cap now config-driven (maxGrenades).
- Fix pre-existing Nuke bug: points were awarded to the picker, not each player.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@claude
Tier 2: crawler variant + last-zombie hold behavior + insta-kill exem…
e7d763f 
…ption

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@claude
Tier 2: Death Machine + Bonfire Sale power-ups
1d8d30f 
- Death Machine: temporary minigun for deathMachineDurationSeconds, saves and
  restores the displaced weapon/slot on expiry.
- Bonfire Sale: Fire Sale + global temporary Pack-a-Punch cost override
  (bonfirePaPCost, default 1000) via Game.effectivePaPCost; reset on game reset.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@claude
Tier 2: Vulture Aid perk (zombie kill drops ammo/points)
a62b233 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Tier 2: buyable timed kill-zone Traps (Trap + TrapManager + TrapSign)
ea7768b
@claude
Tier 2: Thundergun + Wunderwaffe DG-2 wonder weapons with custom fire…
955b2be 
… effects

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@claude
Tier 2: teleporter-gated Pack-a-Punch (timed PaP-room access)
c2973fd 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@claude
Tier 3: persistent player-data layer + Bank + Fridge
8756740 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@claude
Tier 3: Tombstone Soda (preserve perks across down/respawn)
7f30ad6 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@claude
Tier 3: solo Quick Revive self-revive (limited uses)
2694a3e 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@claude
Tier 3: Who's Who solo ghost self-revive (simplified)
8b28e9b 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@claude
Tier 4: boss zombies (George Romero + Brutus) on boss rounds
171b045 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@claude
Tier 4: buildables framework (parts -> assembly station) + concrete b…
4cb5d04 
…uildable

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@claude
Tier 4: persistent perma-perks (progression-earned passive bonuses)
462515c 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@claude
Tier 4: easter-egg quest framework (per-arena multi-step objective en…
9abe209 
…gine)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@claude
Tier 4: add perma-perks master enable toggle (config.permaPerks.enabled)
0c296ee 
Server owners can fully disable perma-perks: when false no revive progress is
tracked and no perma-perk effect is applied at game entry.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@claude
Fix door rebuild losing block metadata (fences/orientation/sign facing)
a69936f 
Doors stored only Material per block, so closing a door restored fences,
panes, walls and stairs without their connection/shape state (fences rendered
connection arms into air) and recreated price signs as a default wall sign
facing the wrong way. Now the full BlockData is persisted and restored exactly
(no physics, so connections match what was authored), and door signs save +
restore their facing before the [Zombies]/Door text is re-applied. Backward
compatible: legacy saves with only "material" fall back to the old path.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@claude
Fix crawler immobility + add BO2 feature documentation
c283476 
The Tier 2 last-zombie crawler used 0.35x speed + Slowness IV, leaving it
effectively frozen: it tripped the stuck-zombie teleporter and then could not
move at all after teleporting. Crawler now uses a mild speed cut + Slowness I so
it visibly crawls toward players, and crawlers are exempt from the stuck
teleporter (the hold zombie stays where players left it).

Also adds BO2_FEATURES.md documenting every Tier 0-4 feature, its config keys,
and how to disable each.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@claude
Fix barrier rebuild losing block metadata (same fix as doors)
0a2261d 
Barriers stored only Material per window block, so repairing/rebuilding them
lost orientation and fence/pane connection state. Now the full BlockData is
persisted and restored exactly. Backward compatible: legacy saves (or missing
blockdata) capture the live intact block's data on load.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@claude
Fix confusing solo down state (revive prompt with no one to revive)
0014618 
In a solo game the down handler still broadcast the co-op "stand close and
right click to revive" prompt and told the player they "need to be revived",
even though no second player exists. Down messaging now lives in
DownedPlayerManager: solo Quick Revive shows a clear "getting back up in Ns"
self-revive message; the co-op revive prompt only shows when there is actually
another player. Solo with no self-revive still ends the game (Game.playerDowned),
and can be forced off entirely with soloQuickReviveUses: 0.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@ikbenignace