Warps#
Warps はプレイヤーがアイランドに個人ワープサインを追加できるようにします。
作成・メンテナンス: tastybento
Useful links
インストール#
- Warps アドオンの jar を BentoBox プラグインの addons フォルダに配置します
- サーバーを再起動します
- アドオンはデータフォルダを作成し、その中に config.yml が作成されます
- config.yml を希望通りに編集します
- 変更した場合はサーバーを再起動します
設定#
config.yml#
アドオンが正常にインストールされると、config.yml ファイルが作成されます。このファイルのすべてのオプションにはコメントが付いています。詳細はファイルを確認してください。 最新の設定ファイルはこちらで確認できます: config.yml
ワープ制限とは何ですか?
これはワープサインの作成を、少なくとも特定のアイランドレベルを持つプレイヤーに制限します。Level アドオンが必要で、デフォルトレベルは 10 です。
ウェルカムテキストとは何ですか?
これはプレイヤーがワープサインを作成するために看板に書く必要があるテキストです(例: [Welcome])。大文字小文字を区別しません!
このテキストは一番上の行に記述する必要があります。
無効化されたゲームモードとは何ですか?
このリストには Warps アドオンが動作しないゲームモードが保存されます。
アドオンを無効にするには、- で始まる新しい行にその名前を記述します。例:
disabled-gamemodes:
- BSkyBlock
ロアフォーマットとは何ですか?
ロアフォーマットは看板の説明行のデフォルトカラーを変更できます。説明行は GUI で使用されます。
説明行は [welcome] テキストより下の看板の行です。
他のワールドでの許可とは何をするのですか?
これにより、非 BentoBox のワールドを含む任意のワールドにワープサインを設置できます。
プレイヤーは使用するために welcomewarpsigns.warp 権限が必要です。
show-warps-on-map とは何ですか?
true に設定すると、ワープサインの場所がウェブマッププラグイン(Dynmap、BlueMap)にマーカーとして表示されます。
互換性のあるマッププラグインと BentoBox マップフックが必要です。各ワープサインは [Welcome] の下の看板行のテキストを持つポイントマーカーとして表示されます。
デフォルト: true
warp と warps とは何ですか?
コマンド warp はテレポートするプレイヤーの <player> が必要ですが、warps はプレイヤーを選択できるメニューを開きます。
allow in other worlds を有効にした場合はメインコマンド /warp になります。
BentoBox の各ゲームモードでは /[player_cmd] warp のままです。
カスタマイズ可能な GUI#
BentoBox 1.17 API ではカスタマイズ可能な GUI を実装できる機能が導入されました。このアドオンはこの機能を使用する最初のアドオンの 1 つです。できるだけシンプルなカスタマイズを目指しましたが、一部の機能には説明が必要です。 BentoBox カスタム GUI の詳細はこちらをご覧ください: Custom GUI's
GUI をカスタマイズするにはどうすればいいですか?
アドオン GUI をカスタマイズするにはバージョン 1.12 が必要です。これが最初に実装されたバージョンです。アドオンは /plugins/BentoBox/addons/Warps の下に panels という名前のディレクトリを作成します。
PREVIOUS|NEXT ボタンタイプとは何ですか?
PREVIOUS および NEXT ボタンタイプは、GUI にスペースよりも多くのアイランドがある場合に自動ページングを作成します。 これらのタイプにはデータの下に追加パラメーターがあります:
indexing- ボタンにページ番号を表示するかどうかを示します。
例:
icon: tipped_arrow[potion_contents={custom_color:11546150}]
title: warps.gui.buttons.previous.name
description: warps.gui.buttons.previous.description
data:
type: PREVIOUS
indexing: true
action:
left:
action: PREVIOUS
tooltip: warps.gui.tips.click-to-previous
RANDOM ボタンタイプとは何ですか?
このボタンはプレイヤーがランダムなワープにテレポートできます。 2 つ以上のワープがある場合にのみ利用可能です。
例:
icon: DROPPER
title: warps.gui.buttons.random.name
description: warps.gui.buttons.random.description
data:
type: RANDOM
actions:
warp:
click-type: left
tooltip: warps.gui.tips.click-to-warp
WARP ボタンタイプとは何ですか?
WARP ボタンはワープオブジェクトの動的エントリを作成します。
タイトル、説明、アイコンを指定すると看板とデータベースデータに基づく動的生成が上書きされます。デフォルトではこれらの値はデータベースエントリから生成されます。
PLAYER_HEAD アイコンはオーナーのプレイヤーヘッドに置き換えられます。ただし、現時点では異なるプレイヤーヘッドを指定するオプションはありません。
例:
warp_button:
icon: PLAYER_HEAD
title: warps.gui.buttons.warp.name
description: warps.gui.buttons.warp.description
data:
type: WARP
actions:
warp:
click-type: left
tooltip: warps.gui.tips.click-to-warp
コマンド#
ヒント
[player_command] は実行中のゲームモードによって異なるコマンドです。 ゲームモードの config.yml ファイルにはこれらの値を変更するオプションがあります。 例えば BSkyBlock では、デフォルトの [player_command] は island です。 このアドオンではアドオンの config.yml でプレイヤーコマンドのエイリアスを変更できることに注意してください。
/[player_command] warp <player>: 対象の看板にプレイヤーをワープします。/[player_command] warps: 利用可能なすべてのワープサインを表示する GUI を開きます。
権限#
ヒント
[gamemode] は実行中のゲームモードによって異なるプレフィックスです。 プレフィックスはゲームモード名の小文字です。例えば BSkyBlock を使用している場合、プレフィックスは bskyblock です。 同様に AcidIsland を使用している場合、プレフィックスは acidisland です。
[gamemode].island.warp- プレイヤーが/[player_command] warpと/[player_command] warpsコマンドを使用できます。デフォルトで有効。[gamemode].island.addwarp- プレイヤーがワープサインを作成できます。デフォルトで有効。welcomewarpsigns.warp- プレイヤーが/warpと/warpsコマンドを使用できます。デフォルトで無効。allow-in-other-worldsが必要。welcomewarpsigns.addwarp- プレイヤーがワープサインを作成できます。デフォルトで無効。allow-in-other-worldsが必要。
何か不足していますか?
このアドオンの addon.yml ファイルで権限の完全なリストを確認できます。
もし本当に不足しているものがあれば、お知らせください!
よくある質問#
機能 X を追加してもらえますか?
こちらのリストに追加してください。
バグを発見しました。どこに報告すればいいですか?
こちらのリストに追加してください。
変更履歴#
v1.18.0 の新機能
リリース日: 2026-04-05
- ウェブマップのサポート(Dynmap / BlueMap)。
show-warps-on-mapオプションが有効(デフォルト: true)な場合、ワープサインがウェブマップにポイントマーカーとして表示されるようになりました。BentoBox 互換のマッププラグインが必要です。 - 新しい
show-warps-on-map設定オプション(上記の設定を参照)。 - ロシア語ロケールが MiniMessage 形式に更新され、完全なキーカバレッジが追加されました。
- 追加のロケールファイルが追加・更新され、BentoBox フォーマットと一致するようになりました。
- BentoBox API 3.12.0 以降が必要です。
新しいフォーマットでロケールファイルを再生成するには BentoBox/addons/Warps/locales/ を削除してください。
v1.19.0 の新機能 — ロケール移行が必要
リリース日: 2026-04-11
- すべてのロケールファイルが MiniMessage に移行されました。 BentoBox 3.14 との一貫性のため、すべてのロケールファイルがレガシーの
&カラーコードから MiniMessage タグに変換されました。 - BentoBox API 3.14.0 以降が必要です。
- Warps は Paper 1.21.11 専用にビルドされるようになりました(Spigot API は廃止)。
BentoBox 3.14.0 が必要です。 Warps をアップグレードする前に BentoBox を更新してください。
ロケールファイルを再生成してください — BentoBox/locales/Warps/ を削除してサーバーを再起動してください。カスタムロケールファイルの & カラーコードはレンダリングされなくなります。
翻訳#
翻訳の改善にご協力ください
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-TW | 100% |
| 中国語(香港) | zh-HK | 100% |
| 日本語 | ja | 100% |
| 韓国語 | ko | 100% |
API#
イベント#
BentoBox 1.17 API ではクラスローダーの問題を解決した機能が実装されました。イベントを直接使用したいプラグインは、これを利用できます。
プロジェクトに Warps を依存関係として追加するだけです。Maven を使用できます:
<dependency>
<groupId>world.bentobox</groupId>
<artifactId>warps</artifactId>
<version>1.11.2</version>
<scope>provided</scope>
</dependency>
変数
UUID player- ワープサインを作成したプレイヤーの ID。Location warpLoc- ワープサインの場所。
コード例
@EventHandler(priority = EventPriority.MONITOR)
public void onWarpInitiate(WarpInitiateEvent event) {
UUID player = event.getPlayer();
Location warpLoc = event.getWarpLoc();
}
変数
UUID owner- ワープサインを所有しているプレイヤーの ID。UUID remover- ワープサインを削除したプレイヤーの ID。Location warpLoc- ワープサインの場所。
コード例
@EventHandler(priority = EventPriority.MONITOR)
public void onWarpRemove(WarpRemoveEvent event) {
UUID owner = event.getOwner();
UUID remover = event.getRemover();
Location warpLoc = event.getWarpLocation();
}