Gusher

A BentoBox game mode for Paper 26.2+: a void-world island whose economy is a geyser — an event-pulse loot fountain — tended by a bound, nameable sulfur cube pet that modifies, multiplies and catches the loot.

OneBlock's addiction loop, decomposed and rebuilt — with a Tamagotchi bolted onto the slot machine. See GUSHER_SPEC.md for the full design.

The loop

1. Spawn on a sulfur platform over the void; the geyser rumbles beside you.
2. Every 90–240s: a 10s telegraph, then an eruption — you get launched, loot rains down, hazards roll (gas, plume mobs, sulfur spikes).
3. Catch loot mid-air for streaks and bonus rolls.
4. Between eruptions: sacrifice items into the pool to bias the next table, or feed the cube a block — its archetype selects a loot channel (stone→mineral, wood→forestry, wool→husbandry, ice→gems, magma→nether) or a twist (honeycomb→auto-collect stash, soul sand→hazard warding).
5. Eruptions advance phases: Fumarole → Hot Spring → Geyser → Caldera → Supervolcano, each with richer tables and nastier hazards.
6. Feeling lucky? Feed it TNT: 5× jackpot next eruption — unless anything ignites the cube first, in which case it dies in the blast and takes the stash and 24 hours with it.

Commands

• /gush — standard island command set, plus status and stash
• /gushadmin — plus reload, setcount, forceerupt, respawncube

Building

mvn clean package

Requires the local environment described in CLAUDE.md (Paper API 26.2, BentoBox 3.18.1, and — until MockBukkit ships a 26.2 build — the patched MockBukkit jar produced by scripts/build_patched_mockbukkit.py).

Documentation

• GUSHER_SPEC.md — design specification
• docs/API_VERIFICATION.md — verified Paper 26.2 API surface
• docs/IMPLEMENTATION_PLAN.md — architecture
• docs/PROGRESS.md — milestone log
• docs/IN_GAME_TEST_PLAN.md — manual test plan