ChunkBlock#

One magic block. One chunk. A wall you cannot walk through.

ChunkBlock takes the OneBlock loop everyone knows — mine the magic block, it comes back as something else, phases roll past — and puts a hard border 16 blocks away. Everything outside your starting chunk is a forbidden zone: you cannot walk, fly, glide, pearl, ride or dig your way into it. The only way out is to get richer.

Island levels are the currency. Build up your level, walk to the wall, and hit it in the direction you want to grow. The chunk on the other side opens up and the border moves out one step. Lose levels and the wall comes back in — newest chunks first — and your farm is behind it until you earn them back.

Created and maintained by tastybento. The magic-block engine comes from AOneBlock, so phase files are interchangeable; the chunk gating is original to ChunkBlock.

Why players get hooked#

• 🔒 A border you genuinely cannot cross. Walking, sprint-jumping, elytra, riptide tridents, ender pearls (refunded), chorus fruit, horses, boats, minecarts and creative flight are all gated — at every height, from the void to above the build limit. There is no fly-over corridor and no dig-under.
• 💰 Levels are territory. Not a shop, not a rank, not a timer. The thing your players already optimise — island level — is the thing that buys space. Every block placed is a down payment on the next chunk.
• 👊 Expansion is a physical gesture. No GUI, no /buy chunk. The owner stands at the wall, punches it, and the world opens up with a sound and a green sweep of particles. They choose the direction, so no two islands grow the same shape.
• ⚠️ Loss has teeth — without being cruel. Level drops re-lock the most recently claimed chunks in exact reverse order. Nothing inside is touched: the builds, the chests, the mobs are all still there when the levels come back. Prefer a gentler game? One config line makes territory a ratchet that never shrinks.
• 🗺️ You can see the frontier. A per-player particle curtain marks every locked face near you (optionally with client-side barrier blocks), and /ch chunks prints a coloured map of what you own, what you can claim next, and what it costs.
• 🧱 Nothing leaks across. Pistons, flowing liquids, dispensers, tree growth, fire and grass spread, explosions and natural mob spawns all stop at the line, and dropped items bounce back rather than being lost to the forbidden zone.
• ⛏️ The full OneBlock game underneath. 20 themed phases, 15,500 blocks of content, weighted block and mob pools, rarity chests, holograms, boss bar and action bar progress — all of it, in a box that grows.

How a session feels#

You spawn on a grass block in the middle of nowhere with a red wall in every direction. Mine. Mine again. Cobble, dirt, a chicken that immediately walks off the edge. Somewhere around the fiftieth block the chat says you have credit, so you turn to face the sunrise side, punch the wall, and it falls away — twice the world you had a second ago, and now you can actually build a wheat farm without knocking your own tower over.

Fifty levels later your island is a 3×3 block of chunks and you are picking directions deliberately: the ocean phase is coming, and you want the room for it on the east side where the drop is. Then you die badly in the Dungeon phase, lose a chunk's worth of levels, and the newest chunk snaps shut with your furnace bank inside it. It is not gone. It is just behind the wall until you get those levels back.

Setup#

1. Install BentoBox and run the server once so its folders exist.
2. Install the Level addon into plugins/BentoBox/addons/.
3. Drop the ChunkBlock jar into plugins/BentoBox/addons/ and restart.
4. ChunkBlock creates chunkblock_world, a data folder, a config.yml, a phases folder and phases_index.yml.
5. Stop the server, edit config.yml to taste, and delete any world it created if your changes affect generation.
6. Restart.

ChunkBlock runs happily beside AOneBlock, CaveBlock and the rest — its own world, commands (/ch, /chadmin), permissions (chunkblock.*), flags and database table.

Compatibility#

Configuration#

config.yml is the standard BentoBox game-mode file plus one ChunkBlock-only block. Every option is commented in the file itself; the latest copy lives at config.yml.

The chunk settings#

chunkblock:
  # How many island levels one chunk costs to claim. Minimum 1.
  levels-per-chunk: 1
  # Maximum number of chunks an island can claim, including the center chunk.
  # 441 is a full 21 x 21 chunk square. -1 means "whatever the protection range holds".
  max-chunks: 441
  # Losing levels below what has been spent re-locks chunks, newest first.
  # false = 'ratchet mode': chunks never re-lock once claimed.
  relock-on-level-loss: true
  # Move players out of a chunk that re-locks under their feet.
  eject-players-on-relock: true
  # Cancel natural mob spawning inside locked chunks.
  deny-mob-spawns-in-locked: true
  # Bounce dropped items back at the border instead of losing them.
  bounce-back-items: true
  border:
    # Per-player particle curtain on locked chunk faces.
    show-particles: true
    particle-color:
      ==: Color
      ALPHA: 255
      RED: 255
      GREEN: 0
      BLUE: 0
    # Also send client-side barrier blocks. Purely visual; the world is never modified.
    client-side-barrier-blocks: false

World settings that matter more than usual#

Phases#

The magic block, the phase files and phases_index.yml behave exactly as they do in AOneBlock — the formats are byte-for-byte compatible, so community phase packs drop straight in.

Customizable GUIs#

ChunkBlock uses the BentoBox templated-panel API for its phases GUI. On first run it creates a panels folder under plugins/BentoBox/addons/ChunkBlock containing phases_panel.yml. See Customizable GUIs for the mechanics; the PREVIOUS, NEXT and PHASE button types work as described in the AOneBlock documentation.

Commands#

Complete ChunkBlock command list

Permissions#

Complete ChunkBlock permission list

Flags#

ChunkBlock registers its own flag IDs so it can run alongside AOneBlock without either addon losing its flags to a duplicate registration.

Placeholders#

Alongside the phase placeholders inherited from the magic-block engine, ChunkBlock adds five territory placeholders:

Complete ChunkBlock placeholder list

FAQ#

Translations#

API#

ChunkBlock stores its data in its own database table, ChunkBlockIslands, and exposes its territory state through events, a request handler and the addon class.

Add it to your project as a provided dependency:

<dependency>
    <groupId>world.bentobox</groupId>
    <artifactId>chunkblock</artifactId>
    <version>1.0.1</version>
    <scope>provided</scope>
</dependency>

Data object#

public void accessChunkBlockData(@NonNull Island island) {
    BentoBox.getInstance().getAddonsManager().<ChunkBlock>getAddonByName("ChunkBlock")
        .ifPresent(chunkBlock -> {
            OneBlockIslands data = chunkBlock.getOneBlocksIsland(island);
            int chunks = data.getUnlockedChunkCount();
            List<String> claimOrder = data.getUnlockedChunks();

            ChunkManager cm = chunkBlock.getChunkManager();
            long credit = cm.getCredit(island);
            long spent = cm.getSpentLevels(island);
            int max = cm.getMaxChunks(island);
            boolean here = cm.isUnlocked(island, someLocation);
        });
}

Events#

ChunkBlock fires the AOneBlock magic-block events (BlockClearEvent, MagicBlockEntityEvent, MagicBlockEvent, MagicBlockPhaseEvent — see the AOneBlock API section, same fields, in the world.bentobox.chunkblock.events package) plus two of its own.

@EventHandler(priority = EventPriority.MONITOR)
public void onChunkUnlock(ChunkUnlockEvent event) {
    Island island = event.getIsland();
    Vector offset = event.getChunkOffset();
    int index = event.getUnlockIndex();
}

@EventHandler(priority = EventPriority.MONITOR)
public void onChunkRelock(ChunkRelockEvent event) {
    Island island = event.getIsland();
    Vector offset = event.getChunkOffset();
    int index = event.getUnlockIndex();
}

Request handlers#

Plugins that do not want a compile-time dependency can use the Addon Request API. ChunkBlock registers island-stats and location-stats from the magic-block engine, plus:

Map<String, Object> request = Map.of("player", player.getUniqueId());
@SuppressWarnings("unchecked")
Map<String, Object> result = (Map<String, Object>) new AddonRequestBuilder()
        .addonName("ChunkBlock")
        .label("unlocked-chunks")
        .addMetaData(request)
        .request();
int chunks = (int) result.getOrDefault("count", 0);

Changelog#