Skip to content

docs: ChunkBlock game mode section and TopBlock ChunkBlock support - #89

Merged
tastybento merged 2 commits into
masterfrom
docs/topblock-chunkblock-support
Aug 8, 2026
Merged

docs: ChunkBlock game mode section and TopBlock ChunkBlock support#89
tastybento merged 2 commits into
masterfrom
docs/topblock-chunkblock-support

Conversation

@tastybento

Copy link
Copy Markdown
Member

Documents ChunkBlock and the TopBlock support that goes with it.

This branch carries two commits:

1. docs(ChunkBlock): add the ChunkBlock game mode section@tastybento

Six new pages under Game Modes (overview, Claiming Chunks, Phases, Commands, Permissions, Placeholders), the nav entry, and the chunkblock placeholder rows.

2. docs(TopBlock): document ChunkBlock support in v2.1.0

TopBlock 2.1.0 (BentoBoxWorld/TopBlock#14) is no longer AOneBlock-only — it hooks AOneBlock, ChunkBlock, or both, and each game mode gets a completely separate top ten, topblock command, and placeholder set.

  • Intro rewritten — TopBlock is a magic-block leaderboard for both game modes, with links to each.
  • Installation — a note that TopBlock needs at least one of the two game modes, disables itself if neither is found, and hooks whichever it finds at startup (so adding a game mode later needs a restart).
  • Configuration — settings are global across hooked game modes (there is no per-game-mode config), and refresh-time now reads every island of every hooked game mode, which is worth knowing if you run both.
  • Commands — the topblock subcommand is registered on each game mode's player command and opens the panel for the world it was run in.
  • Permissions — documents the new chunkblock.island.topblock and chunkblock.intopten, plus a FAQ on how intopten actually behaves, since both points surprise admins: it is only checked while the island owner is online (offline owners are always listed, because Bukkit can't evaluate permissions for offline players), and only the owner's permission counts, not team members'.
  • Placeholders — adds the six %chunkblock_island_*_top_<number>% rows to data/placeholders.csv and notes that the two prefixes never mix.
  • Changelog — new v2.1.0 entry.

Notes

  • ⚠️ TopBlock 2.1.0 has not been released yet — it is merged to develop but not tagged, so the Release v2.1.0 link in the changelog will 404 until the release goes out. Worth holding this merge until then, or merging now and letting the link resolve on release.
  • mkdocs build is clean; the only warnings are translations() GitHub 403 rate-limit messages, which are environmental.

🤖 Generated with Claude Code

https://claude.ai/code/session_01UtAC44orba7UkTpFwHEw22

tastybento and others added 2 commits August 7, 2026 22:24
Six pages under Game Modes: the overview pitch, Claiming Chunks (the full
guide to the level-as-currency territory game - credit model, the
hit-the-border claim gesture, LIFO re-locking, the border enforcement,
visuals, limits and admin tools), Phases (what ships, the phase index and
the order editor, deferring the shared field reference to the AOneBlock
guide since the formats are identical), Commands, Permissions and
Placeholders.

Also adds the nav entry and the chunkblock placeholder rows in
data/placeholders.csv. Command and permission tables are generated from
the addon's own addon.yml and locale, so they match the shipped 1.0.1
build.

Cross-links from Comparison.md, GameModes.md and the homepage are
deliberately NOT in this PR - they follow once the section itself is
settled, and those files currently carry unrelated pending edits.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Taa2snoHkvtcZ6e5rAHDQS
TopBlock 2.1.0 hooks AOneBlock, ChunkBlock, or both, keeping a separate
top ten, command and placeholder set per game mode.

- Rewrite the intro: TopBlock is no longer AOneBlock-only, and link both
  supported game modes.
- Add an installation note that TopBlock needs at least one of the two
  game modes and hooks whichever it finds at startup.
- Note that config settings are global across hooked game modes, and that
  refresh-time reads every island of every hooked game mode.
- Explain that the topblock subcommand is registered per game mode and
  opens the panel for the world it was run in.
- Document the new chunkblock.island.topblock and chunkblock.intopten
  permissions, plus a FAQ covering how intopten actually behaves: it is
  only checked while the owner is online, and only for the island owner.
- Add the six chunkblock_island_*_top_<number> placeholders to
  placeholders.csv and explain that the sets never mix.
- Add the v2.1.0 changelog entry.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01UtAC44orba7UkTpFwHEw22
@tastybento
tastybento merged commit 6c861e6 into master Aug 8, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant