Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Avatar for BentoboxWorld

One Block, One Chunk

Report ChunkBlock?

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 chunks shows 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 ledger shows 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

  1. Install BentoBox and the Level addon (required, because island level is the unlock currency).
  2. Drop the ChunkBlock jar into the plugins/BentoBox/addons folder 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 costs levels-per-chunk levels (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: false in 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; returns count, max, ring, spent, credit, and chunks, the claim-ordered offset list).
  • Events ChunkUnlockEvent and ChunkRelockEvent fire once per chunk transition.
  • Events PhaseFinaleStartEvent (cancellable) and PhaseFinaleEndEvent fire 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

Information

Category
Games
Published
August 17, 2026
License
19Downloads
0Stars
Addon

Pinned Versions

Members

2