コンテンツにスキップ

Warps#

Warps はプレイヤーがアイランドに個人ワープサインを追加できるようにします。

作成・メンテナンス: tastybento

インストール#

  1. Warps アドオンの jar を BentoBox プラグインの addons フォルダに配置します
  2. サーバーを再起動します
  3. アドオンはデータフォルダを作成し、その中に config.yml が作成されます
  4. config.yml を希望通りに編集します
  5. 変更した場合はサーバーを再起動します

設定#

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/ を削除してください。

Release v1.18.0

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/ を削除してサーバーを再起動してください。カスタムロケールファイルの & カラーコードはレンダリングされなくなります。

Release v1.19.0

翻訳#

翻訳の改善にご協力ください

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>

説明

プレイヤーが新しいワープサインを作成した後に発火するイベントです。

クラスへのリンク: WarpInitiateEvent

変数

  • UUID player - ワープサインを作成したプレイヤーの ID。
  • Location warpLoc - ワープサインの場所。

コード例

@EventHandler(priority = EventPriority.MONITOR)
public void onWarpInitiate(WarpInitiateEvent event) {
    UUID player = event.getPlayer();
    Location warpLoc = event.getWarpLoc();
}

説明

ワープサインが削除された後に発火するイベントです。

クラスへのリンク: WarpRemoveEvent

変数

  • 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();
}

最終更新日: 2026年4月13日 13:14:53