TopBlock#
AOneBlock 専用のアイランドレベルを計算する BentoBox 用アドオンです。ランクは採掘されたマジックブロックの数（カウント）によって決まります。
作成・メンテナンス: tastybento
Useful links
インストール#
- TopBlock アドオンの jar を BentoBox プラグインの addons フォルダに配置します
- サーバーを再起動します
- アドオンはデータフォルダを作成し、その中に config.yml が作成されます
- config.yml を希望通りに編集します
- 変更した場合はサーバーを再起動します
設定#
TopBlock アドオンには 2 つの全般的な設定があります:
- config.yml ファイルにはアドオンのデフォルト設定が含まれます。
- /panels/ にはプレイヤー GUI を管理するファイルが含まれます。
config.yml#
設定ファイルにはアドオンの主要な機能が含まれます。
最新の config.yml はこちらで確認できます。
このセクションではアドオンの全般的な設定を定義します。
refresh-time
トップ 10 が更新される頻度（分単位）。最小は 1 分、デフォルトは 5 分です。 更新のたびにデータベースからすべてのアイランドを読み込む必要があるため、頻繁に実行しないでください。
デフォルト: 5
shorthand
アイランドレベル数値を短縮表示できます。
大きなレベル値を切り捨て表示します。例: 10,345 → 10k
デフォルト: false
カスタマイズ可能な GUI#
BentoBox 1.17 API ではカスタマイズ可能な GUI を実装できる機能が導入されました。できるだけシンプルなカスタマイズを目指しましたが、一部の機能には説明が必要です。 BentoBox カスタム GUI の詳細はこちらをご覧ください: Custom GUI's
GUI をカスタマイズするにはどうすればいいですか？
アドオンは /plugins/bentobox/addons/topblock の下に panels という名前のディレクトリを作成します。
現在カスタマイズ可能な GUI:
- トップパネル:
top_panel- トップ 10 のアイランドを表示します。
TOP ボタンタイプとは何ですか？
このボタンは top_panel で利用可能です。アイランドトップの X 位のアイランドを表示します。
icon はデフォルトで適切なプレイヤースキンの PLAYER_HEAD になります。有効にすると指定したマテリアルに置き換えられます。
データフィールドの index では、現在のスポットに表示するトップ 10 の順位を指定できます。
トップパネルには追加アドオンが必要な 2 つのアクションがあります:
warp- Warps アドオンが必要です。プレイヤーのアイランドにワープサインが存在する場合のみ表示されます。visit- Visit アドオンが必要です。プレイヤーのアイランドへの訪問が許可されている場合のみ表示されます。
Fallback では、トップスポットにプレイヤーがいない場合のバックグラウンドアイコンを変更できます。
例:
#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
VIEW ボタンタイプとは何ですか？
このボタンは top_panel で利用可能です。閲覧者のアイランドの TopBlock 値を表示します。
icon はデフォルトで適切なプレイヤースキンの PLAYER_HEAD になります。有効にすると指定したマテリアルに置き換えられます。
view アクションはプレイヤーのアイランドの詳細メニューを表示します。
例:
#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
コマンド#
ヒント
[player_command] と [admin_command] は実行中のゲームモードによって異なるコマンドです。 ゲームモードの config.yml ファイルにはこれらの値を変更するオプションがあります。 例えば BSkyBlock では、デフォルトの [player_command] は island、デフォルトの [admin_command] は bsbadmin です。
/[player_command] topblock: トップパネルにアクセスします。aoneblock.island.topblock権限が必要です。
権限#
aoneblock.island.topblock- (デフォルト:true) - プレイヤーが/[player_command] topコマンドを使用できます。aoneblock.intopten- (デフォルト:true) - プレイヤーのアイランドがトップテンに表示されるかどうかを制御します。管理者やテスターからこの権限を削除するとランキングから除外されます。
何か不足していますか？
このアドオンの addon.yml ファイルで権限の完全なリストを確認できます。
もし本当に不足しているものがあれば、お知らせください！
プレースホルダー#
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 |
よくある質問#
機能 X を追加してもらえますか？
こちらのリストに追加してください。
変更履歴#
v2.0.0 の新機能 — プラットフォームアップグレードが必要
リリース日： 2026-04-26
- 🐛 トップテンパネルが修正されました。 長年のバグにより、トップテンパネルに空の緑色のプレースホルダーしか表示されていませんでした。イベントハンドラーが
privateだったため Bukkit に無視されていましたが、修正済み — プレイヤーのスキンと統計が正しく表示されます。 - ✨
aoneblock.intopten権限。 この権限（デフォルトで全プレイヤーに付与）を削除することで、管理者やテスターをトップテンから除外できます。 - 🔡 22 の新しいロケール — 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。
- 🔺 Paper 1.21.x、Java 21、BentoBox 3.14.0+、AOneBlock 1.18.0+ が必要になりました。Spigot はサポートされなくなりました。
🔺 再起動前に addons/TopBlock/panels/top_panel.yml を削除して、更新されたパネルテンプレートが展開されるようにしてください。その後、カスタムレイアウトを再適用してください。
🔡 更新後に /bentobox reload を実行して、BentoBox が新しいロケールキーを既存のファイルにマージできるようにしてください。
翻訳#
翻訳の改善にご協力ください
BentoBoxとその拡張機能のほとんどの翻訳はAIの助けを借りて 生成されているため、作業の大部分はすでに完了しています — ただしAIは完璧ではありません。コミュニティに本当に必要なのは、 エラーの報告と修正です。
- 誤りや不自然な表現を見つけた場合は、 bentobox.world（GitHubオーガニゼーションへの ショートリンク）からissueまたはPRを開くか、 Discordでご連絡ください。
- 新しい言語を追加したい場合は、該当リポジトリの
src/main/resources/locales/に新しいロケールファイルを追加する PRを開くか、Discordでご相談ください。
| 言語 | 言語コード | 進捗 |
|---|---|---|
| 英語（アメリカ） | en-US | 100%（デフォルト） |
| イタリア語 | it | 100% |
| インドネシア語 | id | 100% |
| ウクライナ語 | uk | 100% |
| オランダ語 | nl | 100% |
| クロアチア語 | hr | 100% |
| スペイン語 | es | 100% |
| チェコ語 | cs | 100% |
| トルコ語 | tr | 100% |
| ドイツ語 | de | 100% |
| ハンガリー語 | hu | 100% |
| フランス語 | fr | 100% |
| ベトナム語 | vi | 100% |
| ポルトガル語 | pt | 100% |
| ポルトガル語（ブラジル） | pt-BR | 100% |
| ポーランド語 | pl | 100% |
| ラトビア語 | lv | 100% |
| ルーマニア語 | ro | 100% |
| ロシア語 | ru | 100% |
| 中国語（中国） | zh-CN | 100% |
| 中国語（香港） | zh-HK | 100% |
| 日本語 | ja | 100% |
| 韓国語 | ko | 100% |
API#
Maven 依存関係#
TopBlock は他のプラグイン向けの API を提供しています。
注意
Maven POM.xml に TopBlock の依存関係を追加します:
<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>
TopBlock の JavaDocs はこちらで確認できます。