Upgrades#
Upgrades はプレイヤーにアイランドのアップグレードを購入することで進行の達成感を与えます。保護範囲の拡大、ブロック/エンティティ制限の引き上げ、カスタムコマンド、スポーナーブースト、作物成長ブーストをお金、アイテム、権限、またはアイランドレベルを使用して購入できます。
作成・メンテナンス: tastybento
Warning
Upgrades is currently in Beta.
Keep in mind that you are more likely to encounter bugs and some features might not be stable.
Useful links
警告: バージョン 1.0.0 は完全な書き直しです
Upgrades 1.0.0 は古い設定ファイルベースのシステムを完全なデータベース駆動アーキテクチャに置き換えました。アップグレードの定義、ティア、価格、報酬は現在 BentoBox のデータベースに保存され、すべてゲーム内で管理されます。古い config.yml はもう使用しません — 0.x からアップグレードする場合は 1.0.0 をインストールする前に削除してください。
インストール#
- Upgrades アドオンの jar を BentoBox プラグインの addons フォルダに配置します。
- サーバーを再起動します。
- 初回起動時に 8 つのサンプルアップグレードが自動的にシードされます。
/[admin_command] upgradesを使用してゲーム内でアップグレードをカスタマイズまたは作成します。
仕組み#
アップグレード、ティア、価格、報酬は BentoBox のデータベース（YAML、JSON、MySQL、MongoDB など）に保存されます。編集が必要な大きな設定ファイルはありません。すべてのアップグレードデータはアドオンによって自動的に読み込み、キャッシュ、保存されます。
初回インストール時にシーダーが 8 つのサンプルアップグレードを作成します。サンプルアップグレードを削除すると、次の再起動時に再シードされません。シードを再トリガーするには、アドオンのデータフォルダから .seeded-gamemodes マーカーファイルを削除してください。
ティアとレベル#
各アップグレードは 1 つ以上のティアで構成されています。ティアはレベルの範囲をカバーします。例えば、あるティアがレベル 0〜4 をカバーする場合、その範囲内のアップグレードレベルを持つプレイヤーはそのティアの報酬の対象となります。
- プレイヤーがアップグレードを購入するたびにレベルが 1 上がります。
- 適用される報酬は常にプレイヤーの現在のレベルを含むティアの報酬です。新しいティアの範囲に入ると即座にそのティアの報酬に切り替わります。
- 1 つのティアに複数の価格（すべて支払う必要あり）と複数の報酬（すべて適用）を設定できます。
- 価格と報酬のフォーミュラは変数（フォーミュラ変数 参照）を使用して、レベル、アイランドレベル、またはチームサイズに応じて自動的にスケールできます。
コマンド#
ヒント
[player_command] と [admin_command] は実行中のゲームモードによって異なるコマンドです。
/[player_command] upgrade: アップグレード購入パネルを開きます。
/[admin_command] upgrades: アップグレードとティアの作成、編集、削除ができる管理者 GUI を開きます。
価格タイプ#
各アップグレードティアは以下の価格の任意の組み合わせを必要とします（購入するにはすべての条件を満たす必要があります）:
| タイプ | 説明 |
|---|---|
| Money | Vault エコノミーコスト |
| Items | プレイヤーのインベントリに特定のアイテムが必要 |
| Permissions | プレイヤーが特定の権限ノードを持っている必要がある |
| Island Level | 最小アイランドレベル（Level アドオンが必要） |
報酬タイプ#
各アップグレードティアは以下の報酬の任意の組み合わせを付与できます:
| タイプ | 説明 | 適用タイミング |
|---|---|---|
| Range | アイランド保護範囲を拡大します | 購入時 |
| Block Limits | ブロックタイプのアイランドごとの制限を引き上げます（Limits アドオンが必要） | 購入時 |
| Entity Limits | エンティティタイプの制限を引き上げます（Limits アドオンが必要） | 購入時 |
| Entity Group Limits | エンティティグループの制限を引き上げます（Limits アドオンが必要） | 購入時 |
| Commands | 購入時にコンソールまたはプレイヤーコマンドを実行します | 購入時 |
| Spawner Boost | アイランド上のすべてのスポーナーイベントに追加スポーンを加えます | 常時パッシブ |
| Crop Growth Boost | アイランド上のすべての自然な作物成長イベントに追加成長ティックを加えます | 常時パッシブ |
Commands（コマンド）#
Commands 報酬はプレイヤーがアップグレードを購入したときに 1 つ以上のコマンドを実行します。
- コンソールモード: コマンドはサーバーコンソールとして実行されます（
/give、ランク昇格コマンド、高い権限が必要なコマンドに使用してください）。 - プレイヤーモード: コマンドはアップグレードを購入したプレイヤーとして実行されます（そのプレイヤーの権限に制限されます）。
コマンド文字列では以下のプレースホルダーが使用できます:
[player]— アップグレードを購入したプレイヤーの名前[owner]— アイランドオーナーの名前
Spawner Boost（スポーナーブースト）#
スポーナーブーストはパッシブな常時有効効果です。購入時には何も起こりません。即座に有効になり、アイランドがそのアップグレードレベルを保持している間は常に有効です。
アイランド上のスポーナーが起動するたびに、アドオンはすべての有効なアップグレードティアにわたるアイランドの合計スポーナーブースト値を計算し、同じ場所に同じタイプのモブをその数だけ追加スポーンさせます。
フォーミュラ値はボーナス倍数です:
| フォーミュラ値 | スポーナーイベントごとの効果 |
|---|---|
0.5 | 50% の確率で追加モブ 1 体 |
1.0 | 常に追加モブ 1 体 |
1.5 | 常に追加モブ 1 体 + 50% の確率でさらに 1 体 |
2.0 | 常に追加モブ 2 体 |
スポーナーブースト報酬を含む複数のアップグレードのボーナスは加算されます。すべてのスポーナータイプで機能します。
Crop Growth Boost（作物成長ブースト）#
作物成長ブーストもパッシブな常時有効効果です。作物が自然に成長するとき、アドオンはボーナス値に等しい追加の骨粉成長ティックを適用します。プレイヤーのアップグレードレベルが高いほど、作物の成長が速くなります。
フォーミュラ値はスポーナーブーストと同様に機能します:
| フォーミュラ値 | 自然成長イベントごとの効果 |
|---|---|
0.5 | 50% の確率で追加成長ティック 1 回 |
1.0 | 常に追加成長ティック 1 回 |
2.0 | 常に追加成長ティック 2 回 |
複数のアップグレードのボーナスは加算されます。対応作物: 小麦、ニンジン、ジャガイモ、ビートルート、ネザーウォート、スイートベリーブッシュ、トーチフラワー、ピッチャープラント。
フォーミュラ変数#
価格と報酬の両方のフォーミュラフィールドで以下の変数が使用できます:
[level]— 購入中（または有効）の現在のアップグレードレベル[islandLevel]— アイランドの現在のレベル（Level アドオンから; Level がインストールされていない場合は 0 の可能性あり）[numberPlayer]— アイランドチームのプレイヤー数
これらの変数を使用すると自動的にスケールするフォーミュラを書くことができます。例えば、お金のコスト 500 * [level] やスポーナーボーナス 0.1 * [level] などです。
権限#
権限はアップグレード設定に基づいてアドオンが自動的に付与します。現在の権限リストは addon.yml を確認してください。
API#
UpgradeAPI クラスは他のアドオンがプログラムでアップグレードデータを照会および変更するために公開されています。上記のアドオン説明からリンクされた JavaDocs を参照してください。
変更履歴#
v1.0.0 の新機能 — 完全な書き直し、対応が必要
リリース日: 2026-04-12
- データベース駆動のアップグレードシステム。 すべてのアップグレード、ティア、価格、報酬が BentoBox のデータベースに保存されます — 設定ファイルの編集は不要です。
- 新しい管理者 GUI。
/[admin_command] upgradesはゲーム内で GUI とチャット入力を通じてアップグレードを作成・編集できる完全なゲーム内管理インターフェースを開きます。 - 新しい報酬タイプ: スポーナーブースト（スポーナーレートを乗算）とクロップ成長ブースト（作物成長速度を乗算）。
- テンプレートプレイヤーパネル。 プレイヤーのアップグレードパネルは BentoBox
TemplatedPanelになり、panels/upgrades_panel.ymlで完全にカスタマイズ可能です。 - 他のアドオンからのプログラムアクセス用の完全な
UpgradeAPI。 - 初回インストール時に 8 つのサンプルアップグレードが自動的にシードされます。
- Limits アドオン 1.28 との互換性修正。
🔺 0.x との後方互換性はありません。 インストール前に古い config.yml と既存のアップグレードデータを削除してください。自動移行はありません。
v1.0.1 の新機能
リリース日: 2026-04-12
- シーダーの修正。 サンプルアップグレードは削除後に毎回の再起動で再生成されなくなりました。シーダーはどのゲームモードがシードされたかを永続的な
.seeded-gamemodesマーカーファイルで追跡するようになりました。
v1.0.2 の新機能
リリース日: 2026-04-13
- 永続化の修正。 管理者のアップグレード定義（名前、アイコン、価格、報酬、ティア設定）とプレイヤーの購入レベルがメモリにのみ保存され、サーバー再起動時に失われていました。すべての変更ハンドラーが各変更後すぐにデータベースに保存するようになりました。
翻訳#
翻訳の改善にご協力ください
BentoBoxとその拡張機能のほとんどの翻訳はAIの助けを借りて 生成されているため、作業の大部分はすでに完了しています — ただしAIは完璧ではありません。コミュニティに本当に必要なのは、 エラーの報告と修正です。
- 誤りや不自然な表現を見つけた場合は、 bentobox.world（GitHubオーガニゼーションへの ショートリンク）からissueまたはPRを開くか、 Discordでご連絡ください。
- 新しい言語を追加したい場合は、該当リポジトリの
src/main/resources/locales/に新しいロケールファイルを追加する PRを開くか、Discordでご相談ください。
| 言語 | 言語コード | 進捗 |
|---|---|---|
| 英語（アメリカ） | en-US | 100%（デフォルト） |
| フランス語 | fr | 11% |
| ポーランド語 | pl | 13% |
| 中国語（中国） | zh-CN | 13% |
| 日本語 | ja | 11% |