Release 1.1.0

ChunkBlock 1.1.0

Claiming chunks is now a deliberate, two-step act that a stray swing cannot trigger, and islands can decide for themselves who is allowed to spend their level credit. This release also carries a data-loss fix ported from AOneBlock — and with it, a new minimum BentoBox version.

Highlights

• 🔺 ⚙️ 🔡 Claims are confirmed before they are paid for — hitting the border used to spend the island's levels on the very first swing, so one stray click near the frontier cost a chunk's worth of credit with no way back. Now the first hit outlines the target chunk and quotes its price, and only a second hit made while sneaking pays for it. A hit that could not claim anyway — no credit, beyond the protection range, not adjacent — skips the preview and behaves exactly as before. [PR #17]
• ⚙️ 🔡 Islands choose who may claim — expansion was hard-coded to the island owner, and a teammate who hit the border got no message at all, which read as a broken mechanic rather than a permission. Who may spend credit is now the CHUNKBLOCK_CLAIM_CHUNKS island setting, so an island can open expansion to sub-owners, members, trusted or coop from the normal settings GUI. It defaults to owner rank, so nothing changes until an island says otherwise. Teammates below the rank are now told why. Part of #6 [PR #19]
• 🔺 ⚙️ Island progress survives a server restart — a player could break 30 blocks, the server would restart while they were online, and they would come back with those blocks un-broken, every time. ChunkBlock is a Pladdon, so the server disables it before BentoBox: the shutdown save was queued rather than written, and older cores discarded that queue silently. The shutdown save is now written directly, and the periodic checkpoint is configurable (island.save-every, default 10, was a hardcoded 50). Ported from AOneBlock#550. [PR #18]

🔺 ChunkBlock now requires BentoBox 3.22.0 or newer. The shutdown fix uses saveObjectNow(), which is 3.22.0 API, so addon.yml api-version moved from 3.13.0 to 3.22.0. This is deliberate rather than cosmetic: on an older core the addon would otherwise load and then throw NoSuchMethodError at shutdown, which is worse than the bug being fixed. With the bump, BentoBox refuses to load it and tells you to update. Update BentoBox before updating ChunkBlock.

⚙️ Config note: new keys chunkblock.claim.require-confirmation (default true), chunkblock.claim.confirmation-timeout (default 15 seconds), and island.save-every (default 10). CHUNKBLOCK_CLAIM_CHUNKS: 1000 is added to default-island-flags. Existing config files gain the new keys with defaults on first load.

🔺 Claim confirmation is on by default, which changes how claiming feels on an existing server mid-season. If you would rather keep the old one-hit claim, set chunkblock.claim.require-confirmation: false.

🔡 Locale note: new keys chunkblock.chunks.claim-confirm and protection.flags.CHUNKBLOCK_CLAIM_CHUNKS.* (name, description, hint). Non-English locales will show the raw key until translated; regenerate or update customized locale files.

Compatibility

✔️ BentoBox API 3.22.0+
✔️ Minecraft 1.21+
✔️ Java 21

Upgrading

1. Take backups of your server, for safety.
2. Stop the server.
3. Update BentoBox to 3.22.0 or newer first — ChunkBlock will not load on an older core.
4. Replace the ChunkBlock jar in plugins/BentoBox/addons/ and delete the old one.
5. Start the server.
6. Optionally set chunkblock.claim.require-confirmation: false if you prefer the old one-hit claim, and adjust island.save-every if you want a tighter or looser checkpoint.
7. If you customized your locale files, add the new keys listed above.

How claiming works now

1. Walk into the border — you get the usual claim hint.
2. Hit the border — the target chunk is outlined in yellow and you are quoted the price, including the credit you will have left.
3. Sneak and hit the same chunk again within 15 seconds — the credit is spent and the chunk opens up.

Aiming at a different chunk re-quotes instead of confirming, an expired quote re-quotes, and logging out drops it. Sneaking is what separates the confirming gesture from an ordinary swing: normal mining cadence lands a second hit about a quarter of a second after the first, which would otherwise confirm on its own.

Legend

• 🔡 — locale files may need to be regenerated or updated.
• ⚙️ — config options have been removed, renamed, or added.
• 🔺 — special attention needed.

What's Changed

• 🔺 ⚙️ 🔡 Confirm chunk claims before spending level credit by @tastybento in #17
• 🔺 ⚙️ fix: do not lose island progress when the server restarts by @tastybento in #18
• ⚙️ 🔡 Let islands choose who may claim chunks by @tastybento in #19
• ci: build on JDK 25 so BentoBox 3.22.0 class files can be read by @tastybento in #18
• Remove AOneBlock's CurseForge id from the publish workflow by @tastybento

Full Changelog: 1.0.1...1.1.0

Release 1.0.1

ChunkBlock 1.0.1

Patch release fixing all bugs reported against 1.0.0, plus two compatibility problems that showed up when running ChunkBlock alongside other gamemodes.

Highlights

• Mining near the border no longer spams claim messages — the border-claim detection ignored the block you actually clicked and passed through walls, so mining a generator within a few blocks of a locked chunk nagged "You need X more level(s) of credit" on every swing. Claims now only trigger when you genuinely aim at the border, and failure feedback is rate-limited. Fixes #14
• Respawns can no longer strand players on a stranger's island — a respawn that landed in a locked chunk of an old or abandoned island used to relocate the player within that island and generate a landing block. Players who don't belong to the island are now sent to their own island home instead. Fixes #13
• 🔡 Phases GUI respects the setcount permission — "Click to change" is no longer offered to players without chunkblock.island.setcount, and the GUI title now says ChunkBlock Phases. Fixes #11
• 🔺 ⚙️ Own flag IDs, no more AOneBlock collision — the boss bar, action bar, and start-safety flags are now CHUNKBLOCK_BOSSBAR, CHUNKBLOCK_ACTIONBAR, and CHUNKBLOCK_START_SAFETY. Previously they shared AOneBlock's flag IDs; BentoBox rejects duplicate flag registrations, so on servers running both gamemodes whichever addon loaded second silently lost its flags and those features broke.
• 🔺 ⚙️ Default commands changed from /cb to /ch — CaveBlock already uses /cb and /cbadmin, so ChunkBlock's defaults are now ch chunkblock (player) and chadmin chunkblockadmin cha (admin). Servers keep whatever aliases are already in their config.yml; only fresh installs get the new defaults.
• Clean shutdown when Level is missing — ChunkBlock requires the Level addon (island levels are the currency for claiming chunks). If Level is not on the server, ChunkBlock now disables itself with a clear message instead of leaving half-registered listeners that spammed errors on every join and move.

🔺 Upgrade note: if you changed the boss bar, action bar, or start-safety world settings from their defaults, re-apply them once after upgrading — the flag rename means the old ONEBLOCK_*/START_SAFETY values are no longer read.

🔡 Locale note: locale files gained renamed keys (protection.flags.CHUNKBLOCK_*, phases GUI titles). Regenerate or update customized locale files.

Compatibility

✔️ BentoBox API 3.13.0+
✔️ Minecraft 1.21+
✔️ Java 21

Upgrading

1. Replace the ChunkBlock jar in plugins/BentoBox/addons/ and restart.
2. If you customized the boss bar / action bar / start-safety world settings, re-apply them (see upgrade note above).
3. If your players relied on /cb, either keep your existing config.yml aliases (nothing changes) or adopt the new /ch default.

Legend

• 🔡 — locale files may need to be regenerated or updated.
• ⚙️ — config options have been removed, renamed, or added.
• 🔺 — special attention needed.

What's Changed

• Stop mining near the border from triggering claim attempts (fixes #14) by @tastybento
• Send non-members home instead of ejecting them within a stranger's island (fixes #13) by @tastybento
• 🔡 Only offer 'Click to change' in the phases GUI to players who can use it (fixes #11) by @tastybento
• 🔺 ⚙️ Give ChunkBlock its own flag IDs and harden the flag listeners by @tastybento
• 🔺 ⚙️ Change default command aliases cb/cbadmin to ch/chadmin by @tastybento
• Disable ChunkBlock cleanly when the Level addon is missing by @tastybento
• Make every BossBarListener handler inert when the addon never enabled by @tastybento
• ci: pin publish-platforms workflow by @tastybento in #15

Full Changelog: 1.0.0...1.0.1

Release 1.0.0

ChunkBlock 1.0.0 — the first release! 🎉

You start on a magic block, confined to a single chunk. Everything beyond the border is a
forbidden zone. Mine, build, and raise your island level — then spend those levels at
the border: walk up to the wall, hit it, and the chunk on the other side opens up.
Expand in any direction you choose, chunk by chunk, up to your island's protection range.

ChunkBlock combines the proven OneBlock loop (the magic-block engine and all 18 phases
from AOneBlock — community phase packs work verbatim) with a brand-new territory game.

Highlights

• Claim chunks by hitting the border — island levels are spendable credit
  (levels-per-chunk per claim, default 1). The island owner aims at the wall and
  punches (or right-clicks) to open the next chunk. Any direction, their choice.
• Territory has consequences — every claim is recorded in order. If the island level
  drops below what has been spent, the most recently claimed chunks re-lock, newest
  first. Builds inside are untouched and come back when the levels are regained.
  Prefer a gentler game? relock-on-level-loss: false enables ratchet mode.
• A border you truly can't cross — walking, sprint-jumping, elytra, riptide
  tridents, ender pearls (refunded!), chorus fruit, mounts, boats and flight are all
  gated at any height, from the void to above the build limit. Pistons, liquids,
  dispensers, tree growth, spreading and explosions can't reach across either, and
  dropped items bounce back instead of being lost.
• A frontier you can see — a per-player particle curtain marks locked chunk faces
  (optional client-side barrier blocks), with celebration effects and sounds when
  credit is earned and chunks are claimed. The world itself is never modified.
• /cb chunks — a colored chat map of your territory showing what you own, what you
  can claim next, and your level credit.
• Safe by design — players caught in a re-locking chunk are moved to the nearest
  unlocked spot with flight preserved and no fall damage; nobody is ever stranded or
  blind-teleported.

For admins

• Runs happily alongside AOneBlock and other gamemodes — separate world
  (chunkblock_world), commands (/cb, /cbadmin), permissions (chunkblock.*) and
  database table.
• The Level addon is required — island level is the one and only chunk currency.
• The Border addon is compatible: it shows the island's protection limit; ChunkBlock
  draws the chunk frontier inside it.
• Islands are automatically placed so the magic block sits at the center of a chunk;
  island distance snaps to a multiple of 8 to keep the grid chunk-aligned.
• Staff bypass is chunkblock.mod.bypasschunks (not granted to ops by default —
  grant it explicitly) with /cbadmin bypass to toggle, and
  /cbadmin chunks <player> [reset] for support.
• Placeholders (chunkblock_island_chunks, chunkblock_island_chunk_credit, ...), a
  unlocked-chunks request handler, and ChunkUnlockEvent/ChunkRelockEvent are
  available for scoreboards and other plugins.
• The nether and end are disabled by default; if enabled they get their own center
  chunk and the same claim rules.

Compatibility

• ✔️ BentoBox 3.15.0 or later
• ✔️ Level addon (required)
• ✔️ Paper Minecraft 1.21.x
• ✔️ Java 21

Installation

1. Install BentoBox and the
   Level addon.
2. Drop the ChunkBlock jar into plugins/BentoBox/addons and restart the server.
3. Fun happens.

Full Changelog: https://github.com/BentoBoxWorld/ChunkBlock/commits/1.0.0