Skip to content

TopBlock#

Add-on for BentoBox to calculate island levels for AOneBlock specifically. Ranks are determined by how many magic blocks have been mined - the count.

Created and maintained by tastybento.

Useful links

Installation#

  1. Place the top block addon jar in the addons folder of the BentoBox plugin
  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

Configuration#

TopBlock addon has 2 general configuration things:

  • config.yml file contains default addon configuration files.
  • /panels/ contains files that manages player GUI's

config.yml#

Config file contains main functions for the addon.

The latest config.yml can be found here.

This section defines a number of overall settings for the add-on.

refresh-time

How often the Top Ten should be refreshed in minutes. Minimum is 1 minute, default is 5. Each refresh requires reading every island from the database, so this should not be done too often.

Default: 5

shorthand

Allows to show shorter island level numbers.

Shows large level values rounded down, e.g., 10,345 -> 10k

Default: false

Customizable GUI's#

BentoBox 1.17 API introduced a function that allows to implement customizable GUI's. We tried to be as simple as possible for customization, however, some features requires explanation. You can find more information how BentoBox custom GUI's works here: Custom GUI's

How can I customize GUI's

Addon will create a new directory under /plugins/bentobox/addons/topblock with a name panels

Currently you can customize GUI's:

  • Top panel: top_panel - allows to see top 10 islands.
What does TOP button type?

This button is available in top_panel. It shows island at the top X by island top.

The icon by default will be PLAYER_HEAD with a proper player skin. Enabling it will replace it with specified material.

index in the data field allows to specify which place of Top 10 should be showed in current spot.

Top panel has 2 implemented actions which funstion requires extra addon:

  • warp - requires Warps addon. Will be shown only if warp sign exists on players island.
  • visit - requires Visit addon. Will be shown only if visiting is allowed on players island.

Fallback allows to change background icon, when there are no player in top spot.

Example: 

    #icon: PLAYER_HEAD
    title: topblock.gui.buttons.island.name
    description: topblock.gui.buttons.island.description
    data:
      type: TOP
      index: 1
    actions:
      warp:
        click-type: LEFT
        tooltip: topblock.gui.tips.click-to-warp
      visit:
        click-type: RIGHT
        tooltip: topblock.gui.tips.right-click-to-visit
    fallback:
      icon: LIME_STAINED_GLASS_PANE
      title: topblock.gui.buttons.island.empty

What does VIEW button type?

This button is available in top_panel. It shows viewer island topblock value.

The icon by default will be PLAYER_HEAD with a proper player skin. Enabling it will replace it with specified material.

The action view allows to see detailed menu of players island.

Example: 

    #icon: PLAYER_HEAD
    title: topblock.gui.buttons.island.name
    description: topblock.gui.buttons.island.description
    data:
      type: VIEW
    actions:
      view:
        click-type: unknown
        tooltip: topblock.gui.tips.click-to-view

Commands#

Tip

[player_command] and [admin_command] are commands that differ depending on the gamemode you are running. The Gamemodes' config.yml file contains options that allows you to modify these values. As an example, on BSkyBlock, the default [player_command] is island, and the default [admin_command] is bsbadmin.

  • /[player_command] topblock: access to the top panel. Requires aoneblock.island.topblock permission.

Permissions#

  • aoneblock.island.topblock - (default: true) - Allows player to use the /[player_command] top command.
  • aoneblock.intopten - (default: true) - Controls whether the player's island appears in the top ten. Remove from an admin or tester to exclude them from the leaderboard.
Something is missing?

You can find the comprehensive list of permissions in the addon.yml file of this addon.
If something is indeed missing from the list below, please let us know!

Placeholders#

Tip

[gamemode] is a prefix that differs depending on the gamemode you are running.

The prefix is the lowercased name of the gamemode, i.e. if you are using BSkyBlock, the prefix is bskyblock.

Properly translated placeholders for each gamemode can be found:

Please read the main Placeholders page.

Placeholder Description TopBlock version
%aoneblock_island_player_name_top_<number>% Island owner's name at the <number> position 1.0.1
%aoneblock_island_member_names_top_<number>% Name of island team members at the <number> position 1.0.1
%aoneblock_island_phase_name_top_<number>% Name of the phase they have reached at the <number> position 1.0.1
%aoneblock_island_phase_number_top_<number>% Phase number (e.g. Plains is 1; Underground is 2) at the <number> position 1.0.1
%aoneblock_island_count_top_<number>% Block Count of magic blocks mined this round at the <number> position 1.0.1
%aoneblock_island_lifetime_top_<number>% Lifetime count of magic blocks mined at the <number> position 1.0.1

FAQ#

Can you add a feature X?

Please add it to the list here.

Changelog#

What's new in v2.0.0 — platform upgrade required

Released: 2026-04-26

  • 🐛 Top Ten panel fixed. A long-standing bug caused the top ten panel to show only empty green placeholders. The event handler was private, causing Bukkit to silently skip it. Now fixed — the panel renders player heads and stats correctly.
  • ✨ aoneblock.intopten permission. Admins and testers can be excluded from the top ten by removing this permission (granted to all players by default).
  • 🔡 22 new locales — 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.
  • 🔺 Now requires Paper 1.21.x, Java 21, BentoBox 3.14.0+, and AOneBlock 1.18.0+. Spigot is no longer supported.

🔺 Delete addons/TopBlock/panels/top_panel.yml before restarting so the updated panel template is extracted. Re-apply any custom layout changes after.

🔡 Run /bentobox reload after updating so BentoBox merges new locale keys into your existing locale files.

Release v2.0.0

Translations#

Help us keep translations accurate

Most BentoBox and addon translations are now generated with the help of AI, so the bulk of the work is already done — but AI is not perfect. What we really need from the community is error reports and corrections.

  • Spotted a mistake or awkward phrasing? Open an issue or a PR on the relevant repository at bentobox.world (a short link to our GitHub org), or tell us on Discord.
  • Want to add a brand-new language? Open a PR adding a new locale file to src/main/resources/locales/ in the relevant repo, or ask on Discord and we'll get you started.
Language Language code Progress
English (United States) en-US 100% (Default)
Chinese, China zh-CN 100%
Chinese, Hong Kong zh-HK 100%
Croatian hr 100%
Czech cs 100%
Dutch nl 100%
French fr 100%
German de 100%
Hungarian hu 100%
Indonesian id 100%
Italian it 100%
Japanese ja 100%
Korean ko 100%
Latvian lv 100%
Polish pl 100%
Portuguese pt 100%
Portuguese, Brazil pt-BR 100%
Romanian ro 100%
Russian ru 100%
Spanish es 100%
Turkish tr 100%
Ukrainian uk 100%
Vietnamese vi 100%

API#

Maven Dependency#

TopBlock provides an API for other plugins.

Note

Add the TopBlock dependency to your Maven POM.xml:

    <repositories>
        <repository>
            <id>codemc-repo</id>
            <url>https://repo.codemc.io/repository/bentoboxworld/</url>
        </repository>
    </repositories>

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

The JavaDocs for TopBlock can be found here.

Last update: April 26, 2026 22:39:08