Release 2.0.0

Release Highlights

• 🐛 Top Ten panel now works — A long-standing bug caused the /oneblock topblock panel to show only empty green placeholders with no player heads or stats. This is now fixed.
• 🔺 Platform upgrade — Now requires Paper 1.21.x, Java 21, BentoBox 3.14.0, and AOneBlock 1.18.0. Spigot is no longer supported.
• ✨ intopten permission — Admins and testers can now be excluded from the top ten by removing the new aoneblock.intopten permission (granted to all players by default).
• 🔡 22 new locales — Added translations for cs, de, es, fr, hr, hu, id, it, ja, ko, lv, nl, pl, pt, pt-BR, ro, ru, tr, uk, vi, zh-CN, zh-HK.

Compatibility

✔️ BentoBox API 3.14.0+
✔️ AOneBlock 1.18.0+
✔️ Paper Minecraft 1.21.x
✔️ Java 21

Upgrading

1. Back up your server before updating.
2. Stop the server.
3. Replace the TopBlock jar with this one.
4. Delete the old addons/TopBlock/panels/top_panel.yml so the updated panel file is extracted. (Your layout customisations will need to be re-applied.)
5. Restart the server.
6. You should be good to go!

🔺 Requires Paper: Spigot is no longer supported. If you are running Spigot, switch to Paper before updating this addon.

🔺 Requires Java 21: Servers still on Java 17 must upgrade their Java runtime before using this version.

🔡 Locale note: If you have custom locale overrides, new keys have been added. Run /bentobox reload after updating so BentoBox can merge the new keys into your existing locale files.

Legend

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

---

Bug Fixes

🐛 Top Ten Panel Showing No Heads or Stats

[PR #12]

The BentoBoxReadyEvent handler in TopBlockManager was declared private, which caused Bukkit to silently skip it at registration time. This meant the periodic data-refresh task never started, leaving the top-ten list permanently empty. The panel only ever rendered fallback green-pane items — no player head, no block count, no lifetime count. The handler is now public, matching the BentoBox convention, and the panel renders correctly.

---

New Features

✨ aoneblock.intopten Permission

[PR #12]

A new permission aoneblock.intopten (default: true) controls whether a player's island appears in the top ten. All players receive it automatically, so existing servers are unaffected. To hide an admin or tester, remove the permission from that player while they are online — their island will be excluded from the next refresh. Offline island owners are always included (offline permission checks are unreliable).

---

Other Improvements

• 🔺 Updated to Paper 1.21.11 API, Java 21, BentoBox 3.14.0, and AOneBlock 1.18.0. Spigot dependency removed. [PR #12]
• 🔡 Added translations for 22 languages: cs, de, es, fr, hr, hu, id, it, ja, ko, lv, nl, pl, pt, pt-BR, ro, ru, tr, uk, vi, zh-CN, zh-HK.
• Test suite migrated from JUnit 4 + PowerMock (broken since Java 17) to JUnit 5 + MockBukkit, covering 22 test cases. [PR #12]
• GitHub Actions CI upgraded to Java 21 (temurin distribution, actions v4). [PR #12]
• TopBlockPladdon now caches the addon instance (Pladdon contract). Fixed double-quote typo in plugin.yml api-version. [PR #12]
• Removed unused ConversationUtils class and dead WARP/VISIT/VIEW commented-out code in TopLevelPanel. [PR #12]

---

What's Changed

• 🐛🔺 Modernise to BentoBox 3.14.0 / Paper / Java 21 and fix top ten panel by @tastybento in #12
• 🔡 Add Russian locale (MiniMessage format) by @app/copilot-swe-agent in #11
• 🔡 Add translations for 21 languages by @tastybento in 4653110

Full Changelog: 1.1.0...2.0.0

Release 1.1.0

Introduction

This release is for MC 1.21.x and tested on 1.21.3. If you are using an earlier version of MC then you'll need an earlier version of this addon.

General info

Top Ten for AOneBlock. This addon for BentoBox is specific to AOneBlock and uses the number of magic blocks mined, the count, to set the top ten rank.

Compatibility

✔️ AOneBlock 1.12.3
✔️ BentoBox API 3.0.0
✔️ Minecraft 1.21.3
✔️ Java 17

How to use

1. Place the level addon jar in the addons folder of the BentoBox plugin. Make sure you have AOneBlock installed too!
2. Restart the server
3. The addon will create a data folder and inside the folder will be a config.yml
4. Edit the config.yml how you want.
5. Restart the server if you make a change

Updating

1. Stop server
2. Copy this addon over the last one
3. Restart

Commands

/ob topblock - this shows the Top Ten

Permissions

Permissions are given automatically to players as listed below. If your permissions plugin strips permissions then you may have to allocate these manually. Note that if a player doesn't have the intopten permission, they will not be listed in the top ten.

permissions:    
  'aoneblock.intopten':
    description: Player is in the top ten.
    default: true
  'aoneblock.island.topblock':
    description: Player can use TopBlock command
    default: true

Placeholders

%aoneblock_island_player_name_top_RANK% where RANK is 1 to 10 - Island owner's name
%aoneblock_island_member_names_top_RANK% where RANK is 1 to 10 - Name of island team members
%aoneblock_island_phase_name_top_RANK% where RANK is 1 to 10 - Name of the phase they have reached
%aoneblock_island_phase_number_top_RANK% where RANK is 1 to 10 - Phase number, e.g. Plains is 1, Underground is 2, etc.
%aoneblock_island_count_top_RANK% where RANK is 1 to 10 - Block Count of magic blocks mined this round
%aoneblock_island_lifetime_top_RANK% where RANK is 1 to 10 - Lifetime count of magic blocks mined

What's Changed

• MC 1 21 3 update and codemc by @tastybento in #9
• Release 1.1.0 by @tastybento in #5

Full Changelog: 1.0.1...1.1.0

Release 1.0.1

Introduction

This release fixes an issue where placeholders were not updated unless the server was restarted. Some notes on placeholders and the Top Ten:

• The Top Ten is updated every 5 minutes - this can be adjusted in config.yml
• Player's counts are only saved every 50 blocks mined or when they log off.

General info

Top Ten for AOneBlock. This addon for BentoBox is specific to AOneBlock and uses the number of magic blocks mined, the count, to set the top ten rank.

Compatibility

✔️ AOneBlock 1.12.3
✔️ BentoBox API 1.23.0
✔️ Minecraft 1.19.4
✔️ Java 17

How to use

1. Place the level addon jar in the addons folder of the BentoBox plugin. Make sure you have AOneBlock installed too!
2. Restart the server
3. The addon will create a data folder and inside the folder will be a config.yml
4. Edit the config.yml how you want.
5. Restart the server if you make a change

Updating

1. Stop server
2. Copy this addon over the last one
3. Restart

Commands

/ob topblock - this shows the Top Ten

Permissions

Permissions are given automatically to players as listed below. If your permissions plugin strips permissions then you may have to allocate these manually. Note that if a player doesn't have the intopten permission, they will not be listed in the top ten.

permissions:    
  'aoneblock.intopten':
    description: Player is in the top ten.
    default: true
  'aoneblock.island.topblock':
    description: Player can use TopBlock command
    default: true

Placeholders

%aoneblock_island_player_name_top_RANK% where RANK is 1 to 10 - Island owner's name
%aoneblock_island_member_names_top_RANK% where RANK is 1 to 10 - Name of island team members
%aoneblock_island_phase_name_top_RANK% where RANK is 1 to 10 - Name of the phase they have reached
%aoneblock_island_phase_number_top_RANK% where RANK is 1 to 10 - Phase number, e.g. Plains is 1, Underground is 2, etc.
%aoneblock_island_count_top_RANK% where RANK is 1 to 10 - Block Count of magic blocks mined this round
%aoneblock_island_lifetime_top_RANK% where RANK is 1 to 10 - Lifetime count of magic blocks mined

What's Changed

• Fix for placeholders by @tastybento in #4

Full Changelog: 1.0.0...1.0.1

Release 1.0.0

Introduction

Top Ten for AOneBlock. This addon for BentoBox is specific to AOneBlock and uses the number of magic blocks mined, the count, to set the top ten rank.

Compatibility

✔️ AOneBlock 1.12.3
✔️ BentoBox API 1.23.0
✔️ Minecraft 1.19.4
✔️ Java 17

How to use

1. Place the level addon jar in the addons folder of the BentoBox plugin. Make sure you have AOneBlock installed too!
2. Restart the server
3. The addon will create a data folder and inside the folder will be a config.yml
4. Edit the config.yml how you want.
5. Restart the server if you make a change

Commands

/ob topblock - this shows the Top Ten

Permissions

Permissions are given automatically to players as listed below. If your permissions plugin strips permissions then you may have to allocate these manually. Note that if a player doesn't have the intopten permission, they will not be listed in the top ten.

permissions:    
  'aoneblock.intopten':
    description: Player is in the top ten.
    default: true
  'aoneblock.island.topblock':
    description: Player can use TopBlock command
    default: true

Placeholders

%aoneblock_island_player_name_top_RANK% where RANK is 1 to 10 - Island owner's name
%aoneblock_island_member_names_top_RANK% where RANK is 1 to 10 - Name of island team members
%aoneblock_island_phase_name_top_RANK% where RANK is 1 to 10 - Name of the phase they have reached
%aoneblock_island_phase_number_top_RANK% where RANK is 1 to 10 - Phase number, e.g. Plains is 1, Underground is 2, etc.
%aoneblock_island_count_top_RANK% where RANK is 1 to 10 - Block Count of magic blocks mined this round
%aoneblock_island_lifetime_top_RANK% where RANK is 1 to 10 - Lifetime count of magic blocks mined

What's Changed

• Return to plugin.yml by @BONNe in #1
• Release 1.0.0 by @tastybento in #2

New Contributors

• @BONNe made their first contribution in #1
• @tastybento made their first contribution in #2

Full Changelog: 0.0.1...1.0.0

Initial Release 0.0.1

Introduction

Top Ten for AOneBlock. This addon for BentoBox is specific to AOneBlock and uses the number of magic blocks mined, the count, to set the top ten rank.

Compatibility

✔️ AOneBlock 1.12.3
✔️ BentoBox API 1.20.0
✔️ Minecraft 1.19
✔️ Java 17

How to use

1. Place the level addon jar in the addons folder of the BentoBox plugin. Make sure you have AOneBlock installed too!
2. Restart the server
3. The addon will create a data folder and inside the folder will be a config.yml
4. Edit the config.yml how you want.
5. Restart the server if you make a change

Commands

/ob topblock - this shows the Top Ten

Permissions

Permissions are given automatically to players as listed below. If your permissions plugin strips permissions then you may have to allocate these manually. Note that if a player doesn't have the intopten permission, they will not be listed in the top ten.

permissions:    
  'aoneblock.intopten':
    description: Player is in the top ten.
    default: true
  'aoneblock.island.topblock':
    description: Player can use TopBlock command
    default: true

Placeholders

%aoneblock_island_player_name_top_RANK% where RANK is 1 to 10 - Island owner's name
%aoneblock_island_member_names_top_RANK% where RANK is 1 to 10 - Name of island team members
%aoneblock_island_phase_name_top_RANK% where RANK is 1 to 10 - Name of the phase they have reached
%aoneblock_island_phase_number_top_RANK% where RANK is 1 to 10 - Phase number, e.g. Plains is 1, Underground is 2, etc.
%aoneblock_island_count_top_RANK% where RANK is 1 to 10 - Block Count of magic blocks mined this round
%aoneblock_island_lifetime_top_RANK% where RANK is 1 to 10 - Lifetime count of magic blocks mined

Full Changelog: https://github.com/BentoBoxWorld/TopBlock/commits/0.0.1