ChunkBlock – One Block, One Chunk
⚔️ Now with Bosses!
New in 1.5: every phase ends with a boss fight. Mine the last block of a phase and the magic block seals itself while a boss rises on top of it. Beat The Colossus, The Broodmother, The Drowned King and 17 more to move on, all inside the chunks you have earned.
Bosses are optional. Turn them all off with one line in
config.yml, or remove them phase by phase. Servers that are upgrading keep playing exactly as before until an admin adds the bosses.
Look, if you had one block, one chunk
Everything you ever wanted, in one block
Would you mine it, or would you slip and fall?
About
ChunkBlock is a riff on OneBlock where you get just one block and just one chunk of space too. You start on a single magic block, confined to a single chunk. Everything beyond it is a forbidden zone that you cannot enter.
Mine the magic block, build, and raise your island level: levels are chunk currency. When you have credit, walk up to the border and hit it, and the chunk on the other side opens up. Expand in whatever direction you like, up to your island's protection range. Lose levels (deaths, removing blocks) and your most recently claimed chunks lock again. Your builds stay, but you can't reach them until you earn the levels back.
- The classic OneBlock loop: 20 phases, 15,500 blocks, mobs and treasure chests.
- A boss at the end of every phase, fought in whatever space you have managed to claim.
- Territory that grows the way you choose. Punch the border to claim the next chunk.
- A particle curtain shows the frontier, and claiming a chunk is celebrated in style.
- A clickable chunk map.
/ch chunksshows your territory and what you can claim next, and it scrolls for big islands. - Rings, trophies and titles. Complete a whole ring of chunks around your island for server-configurable rewards, earn trophies, and show a title on your boss bar.
- A team ledger.
/ch ledgershows who mined what and who claimed what.
Related: AOneBlock – the original one-block game mode, with no chunk limits.
⚔️ Phase bosses
- You get a warning. Over the last 20 blocks of a phase a heartbeat plays and rises in pitch. A bell tolls five blocks from the end.
- The block is sealed. The boss spawns on the magic block, which can't be mined until the boss is dead.
- The boss stays in your chunks. It is pulled back if it leaves the island or wanders into a locked chunk, so it can never hide where you can't follow.
- Your island is safe. Only players can hurt the boss, and bosses can't break, burn or blow up your builds.
- Losing isn't the end. If everyone dies or leaves, the boss retreats. Hit the magic block to try again. Each lost fight makes the next attempt 10% easier, down to half health. Remember that deaths can cost levels, and levels are territory!
- Teams get a tougher boss. Boss health grows by 50% for each extra player on the island, up to four players.
- Rewards. Every boss drops loot, and admins can run commands on each win or on an island's first win.
| Phase | Boss | Phase | Boss |
|---|---|---|---|
| Plains | The Colossus | Desolation | The Last Titan |
| Underground | The Broodmother | Deep Dark | The Warden |
| Winter | The Frostbitten | The End | The Void Walker |
| Ocean | The Drowned King | Lush Caves | The Mossback |
| Jungle | The Temple Guardian | Dripstone Caves | The Burrower |
| Swamp | The Bog Witch | Mangrove Swamp | The Mire Lurker |
| Dungeon | The Jailer | Meadow | The Summoner |
| Desert | The Pharaoh | Cherry Grove | The Petal Phantom |
| The Nether | The Warlord | Jagged Peaks | The Gale |
| Plenty | The Harvest Beast | Sulfur Caves | Brimstone |
Don't want bosses? Set island.phase-finales: false in config.yml and phases end the way they always have. You can also delete the finale: section from any single phase file.
Upgrading from an older version? Your phase files are never overwritten, so nothing changes until you copy the finale: sections from the shipped phase files into your own.
Installation
- Install BentoBox and the Level addon (required, because island level is the unlock currency).
- Drop the ChunkBlock jar into the
plugins/BentoBox/addonsfolder and restart.
ChunkBlock runs happily alongside AOneBlock and other game modes, with separate worlds, commands and permissions.
Commands
The player command is /ch (alias /chunkblock) and the admin command is /chadmin (aliases /chunkblockadmin, /cha). Beyond the standard BentoBox island commands:
| Command | Description |
|---|---|
/ch chunks |
Your chunk count, spendable credit and a clickable map of your territory |
/ch count |
Magic block count and phase |
/ch phases |
All the phases and where you are |
/ch ledger [days] |
Each team member's blocks mined, chunks claimed and rings completed |
/ch title |
Show or hide your island's trophy title; /ch title list shows earned trophies |
/ch bossbar, /ch actionbar |
Turn the phase progress display on or off |
/ch respawnblock |
Bring the magic block back if it has gone missing |
/chadmin chunks <player> [reset] |
Inspect a player's chunks and credit, or re-lock them back to the start |
/chadmin bypass |
Toggle chunk-lock enforcement for yourself (needs chunkblock.mod.bypasschunks) |
/chadmin phases |
Enable, disable and reorder phases |
How claiming works
- A fresh island (level 0) has exactly one chunk: the one with the magic block.
- Island levels are spendable credit:
credit = island level − levels already spent. One chunk costslevels-per-chunklevels (default 1). - The island owner expands by walking to the border and hitting it. The first hit previews the chunk and its cost; sneak and hit again to confirm. The chunk opens if it touches your territory, fits inside the island protection range, and you have the credit. Any direction, your choice.
- The protection range sets the size limit. With the default range of 168 an island can grow to 21×21 chunks (441 in all).
- Every claim is recorded in order. If the island level drops below what you have spent, chunks re-lock in exact reverse claim order: last claimed, first lost. Set
relock-on-level-loss: falsein the config for "ratchet mode", where territory never shrinks. Note that Level's death penalty settings therefore directly affect territory. - Players never get stuck. Anyone standing in a chunk that re-locks is moved safely to the nearest unlocked spot.
Compatibility notes
- Level is a hard dependency.
- Border works fine: it shows the island's overall protection limit. The chunk frontier inside it is drawn by ChunkBlock's own particle curtain.
- Likes, Warps, Challenges, TopBlock, Greenhouses, Biomes and friends work as usual (within unlocked chunks).
- The nether and end are disabled by default. If enabled, each dimension gets its own center chunk and the same claim rules, driven by the same island level.
- The moderator bypass permission is
chunkblock.mod.bypasschunks. It is not given to ops by default: grant it explicitly so staff play by the same rules until they opt in. - The Sulfur Caves phase needs Minecraft 26.2. Older servers skip it automatically.
Placeholders
In addition to the phase placeholders from the magic-block engine (chunkblock_my_island_phase, chunkblock_my_island_count, ...):
| Placeholder | Value |
|---|---|
chunkblock_island_chunks |
Unlocked chunk count |
chunkblock_island_max_chunks |
Maximum claimable chunks |
chunkblock_island_chunk_credit |
Level credit available to spend |
chunkblock_island_next_chunk_level |
Total island level needed to afford the next chunk |
chunkblock_island_ring |
Ring number of the outermost claimed chunk |
chunkblock_island_rings_complete |
Number of rings fully claimed |
chunkblock_island_next_ring_remaining |
Chunks still to claim in the next ring |
chunkblock_island_title |
The island's active trophy title |
chunkblock_island_trophies |
Number of trophies the island has earned |
For developers
- Request handler
unlocked-chunks(submit"player"→ UUID; returnscount,max,ring,spent,credit, andchunks, the claim-ordered offset list). - Events
ChunkUnlockEventandChunkRelockEventfire once per chunk transition. - Events
PhaseFinaleStartEvent(cancellable) andPhaseFinaleEndEventfire around each boss fight. - Phase files are format-compatible with AOneBlock's, so community phase packs work as they are.
FAQ
Q: What phases are there?
A: The same progression as AOneBlock, 20 phases in all: Plains, Underground, Winter, Ocean, Jungle, Swamp, Dungeon, Desert, The Nether, Plenty, Desolation, Deep Dark, The End, Lush Caves, Dripstone Caves, Mangrove Swamp, Meadow, Cherry Grove, Jagged Peaks and Sulfur Caves.
Q: A boss has appeared and I can't mine my block!
A: The magic block is sealed until the boss is defeated. Only players can hurt it. If it is too much, retreat. The boss leaves after a few seconds with nobody around, and it is a little weaker each time you lose.
Q: Can I play without bosses?
A: Yes, if your server admin turns them off. Admins: set island.phase-finales: false in config.yml.
Q: Why can't I walk past the glowing red wall?
A: That chunk is still locked! If you're the island owner and have level credit, hit the wall to claim the chunk. Check /ch chunks to see your credit and what's claimable.
Q: I lost levels and my farm is behind the wall now. Is it gone?
A: No. Nothing in a re-locked chunk is touched. Regain the levels and claim it back; re-locking always takes your newest chunks first. (Admins can turn re-locking off entirely with relock-on-level-loss: false.)
Q: Why do I keep falling and dying?
A: There are tricks to surviving, but it can be difficult! Build yourself some space so you don't fall, and remember that deaths can cost levels, and levels are territory.
Support
- Questions or need help? Join the Discord support server.
- Found a bug or have an idea? Open an issue on GitHub.
Pinned Versions
- R1.21.5–26.2
Pages
Members
2Owner
Admin