AOneBlock#

AOneBlockは、IJAminecraftの人気サバイバルマップ「OneBlock」をBentoBox向けにアレンジしたものです。プレイヤーは魔法の1ブロックの上でサバイバルを繰り広げます。

作成・メンテナンス: tastybento

Useful links

宇宙に浮かぶ1つのブロック。それだけです。さあ、どうする？

インストール#

BentoBoxをインストールし、データフォルダを生成するためサーバーを少なくとも1回起動します。
このjarファイルをBentoBoxプラグインのaddonsフォルダに配置します。
サーバーを再起動します。
アドオンがワールドとデータフォルダを作成し、フォルダ内にconfig.ymlとphasesフォルダ内の設定ファイルが生成されます。
サーバーを停止します。
config.ymlと.ymlの設定ファイルを希望通りに編集します。
ワールドの生成に関わる設定を変更した場合は、初回起動で作成されたワールドフォルダを削除します。
サーバーを再起動します。

設定#

メインのconfig.ymlファイルには、ゲームモードアドオンのセットアップに関する基本情報が含まれています。

phasesにはAOneBlockワールドに存在するフェーズに関するすべての情報が含まれています。

panelsではプレイヤーがアクセスできる一部のパネルをカスタマイズできます。

config.yml#

アドオンが正常にインストールされると、config.ymlファイルが作成されます。このファイルのすべての設定にはコメントが付いています。詳細はファイルをご確認ください。最新の設定ファイルはこちら: config.yml

フェーズ設定ファイル#

フェーズを設定するための設定ファイルはphasesフォルダにあります。

各フェーズには2つのファイルがあります — ブロックとモブを含むファイルと、チェストを含むファイルです。

ファイルの最初の数字は、そのフェーズに到達するために採掘が必要なブロック数です。これがフェーズのキー番号です。

nameiconfixedBlockshologramsbiomestart-commandsend-commandsend-commands-first-timerequirementsblocksmobsカスタムブロック

説明

フェーズの表示名です。プレイヤーがフェーズを確認しようとするすべての場所でこの名前が表示されます。

説明

フェーズのアイコンはphasesパネルでのみ使用されます。

アイコンはBentoBox ItemParserを使用して作成されます。

説明

fixedBlocksセクションでは、フェーズ内の特定の番号のブロックを採掘したときに出現するブロックを固定できます。書式はインデックス番号（0始まり）の後にBukkit Materialを続けます。フェーズのブロック総数を超えるインデックスは機能しません。

使用可能な値はこちら: Materials

サポートブロックが不要なブロック（松明、レール、植物など）の使用をお勧めします。

例

    0: GRASS_BLOCK
    1: GRASS_BLOCK
    2: GRASS_BLOCK
    50: SPONGE

CHEST_WITH_X 記法

fixedBlocks のエントリに CHEST_WITH_X 記法を使用して、特定のアイテムがあらかじめ入ったチェストを設置できます。例：CHEST_WITH_WATER_BUCKET。アイテムは有効な Bukkit マテリアル名である必要があります。

説明

AOneBlockはこれらの行を表示するためにネイティブホログラムを使用します。フェーズが開始される前に表示される最初の行はaoneblockロケールファイルにあります。

fixedBlocksと同様に、hologramsも表示タイミングの数字から始まり、表示テキストが続きます。

例

    0: "&aFirst block is grass!"
    1: "&aSecond block is grass!"
    2: "&cWhat if there will be no next block?"
    3: "&aGood Luck!"

説明

biomeは実験的なオプションです。ただし、「魔法」のブロックの位置のバイオームのみを変更します。島全体のバイオームを変更するオプションを持つBiomesアドオンの使用をお勧めします。バイオーム変更をトリガーするフェーズ開始コマンドで実行できます。

説明

start-commandsセクションでは、プレイヤーがこのフェーズを開始したときにトリガーされるコマンドを定義できます。

コマンドはコンソールとして実行されます。ただし、コマンドの先頭に[SUDO]が付いている場合は、コマンドをトリガーしたプレイヤーとして実行されます。

コマンド文字列内のこれらのプレースホルダーは適切な値に置き換えられます:

[island] - 島の名前
[owner] - 島のオーナーの名前
[player] - コマンドをトリガーするブロックを破壊したプレイヤーの名前
[phase] - このフェーズの名前
[blocks] - 破壊されたブロック数
[level] - 島のレベル（Levelsアドオンが必要）
[bank-balance] - 島の銀行残高（Bankアドオンが必要）
[eco-balance] - プレイヤーの経済残高（VaultとEconomyプラグインが必要）

例

    start-commands:
    - 'give [player] WOODEN_AXE 1'
    - 'broadcast [player] just started OneBlock!'
    - 'obadmin biomes set [player] aoneblock_fields ISLAND!'

説明

end-commandsセクションでは、プレイヤーがこのフェーズを完了したときにトリガーされるコマンドを定義できます。

コマンドはコンソールとして実行されます。ただし、コマンドの先頭に[SUDO]が付いている場合は、コマンドをトリガーしたプレイヤーとして実行されます。

コマンド文字列内のこれらのプレースホルダーは適切な値に置き換えられます:

[island] - 島の名前
[owner] - 島のオーナーの名前
[player] - コマンドをトリガーするブロックを破壊したプレイヤーの名前
[phase] - このフェーズの名前
[blocks] - 破壊されたブロック数
[level] - 島のレベル（Levelsアドオンが必要）
[bank-balance] - 島の銀行残高（Bankアドオンが必要）
[eco-balance] - プレイヤーの経済残高（VaultとEconomyプラグインが必要）

例

    end-commands:
    - '[SUDO]say Just finished [phase]'

説明

end-commands-first-timeセクションでは、プレイヤーがこのフェーズを初めて完了したときのみトリガーされるコマンドを定義できます。2回目以降の完了では実行されません。

コマンドはコンソールとして実行されます。ただし、コマンドの先頭に[SUDO]が付いている場合は、コマンドをトリガーしたプレイヤーとして実行されます。

コマンド文字列内のこれらのプレースホルダーは適切な値に置き換えられます:

[island] - 島の名前
[owner] - 島のオーナーの名前
[player] - コマンドをトリガーするブロックを破壊したプレイヤーの名前
[phase] - このフェーズの名前
[blocks] - 破壊されたブロック数
[level] - 島のレベル（Levelsアドオンが必要）
[bank-balance] - 島の銀行残高（Bankアドオンが必要）
[eco-balance] - プレイヤーの経済残高（VaultとEconomyプラグインが必要）

例

    end-commands-first-time:
    - 'broadcast &c&l[!] &b[player] &fhas completed the &d&n[phase]&f phase for the first time.'

説明

requirementsセクションでは、指定した要件が満たされるまで次のフェーズへのアクセスを制限できます。現在、5つの要件フィールドがあります:

economy-balance - プレイヤーの最低経済残高（VaultとEconomyプラグインが必要）
bank-balance - 島の最低銀行残高（Bankアドオンが必要）
level - 島のレベル（Levelsアドオンが必要）
permission - パーミッション文字列
cooldown - フェーズが最後に開始されてから必要な最低秒数（フェーズの急速な切り替えを防ぐ）

例

    requirements:
      bank-balance: 10000
      level: 10
      permission: ready.for.battle
      cooldown: 60

説明

blocksセクションには、Bukkit Materialと相対確率のリストが含まれています。

使用可能な値はこちら: Materials

すべての確率値はフェーズ全体で合計され、ブロックが配置される確率は相対確率を全確率の合計で割った値です。

例

    blocks:
      GRASS_BLOCK: 2
      STONE: 3

この例では草ブロックがスポーンする確率は40%、石は60%です。(2 / (2+3))と(3 / (2+3))

説明

mobセクションには、スポーン可能なモブとブロックと共にその相対確率のリストが含まれています。このリストには生存可能でスポーン可能なエンティティのみを記載できます。EntityTypes

例

    mobs:
      COW: 150
      SPIDER: 75

説明

バージョン1.11以降、カスタムブロックを指定できるようになりました（@HSGamerのご協力に感謝します）。 blocksとfixed-blocksの両方の場所で設定できます。

blocksセクションでカスタムブロックを定義するには、各要素の前に-を追加する必要があります。また、ブロックはtype、data、probabilityの値で定義する必要があります。サポートされているタイプは次のとおりです:

block-data: /setblockコマンドを使用してワールドにブロックを配置します。dataフィールドが必要です
mob: Spawn Entity APIを使用して要求されたエンティティを作成します。mobフィールドが必要で、オプションでunderlying-blockフィールドも使用できます（デフォルト: STONE）
itemsadder: ItemsAdder APIを使用してブロックを作成します。idフィールドが必要です。ItemsAdderプラグインがインストールされている必要があります。
nexo: Nexo APIを使用してブロックを作成します。idフィールドが必要です。Nexoプラグインがインストールされている必要があります。
craftengine: CraftEngine APIを使用してブロックを作成します。idフィールドが必要です。CraftEngineプラグインがインストールされている必要があります。BentoBox 3.15.0+が必要です。

例

    fixedBlocks:
      0:
        type: block-data
        data: minecraft:chest[waterlogged=true]
      1: GRASS_BLOCK
      2: GRASS_BLOCK
    blocks:
      - type: block-data
        data: minecraft:chest[waterlogged=true]
        probability: 10
      - type: block-data
        data: minecraft:chest
        probability: 10
      - type: mob
        mob: ZOMBIE
        underlying-block: STONE
        probability: 5
      - type: itemsadder
        id: mypack:ruby_ore
        probability: 10
      - type: nexo
        id: mypack:custom_block
        probability: 10
      - type: craftengine
        id: mypack:custom_block
        probability: 10
      - DIRT: 10     # 旧構文も引き続き機能します

ItemsAdder、NexoおよびCraftEngine

ItemsAdder、NexoまたはCraftEngineのカスタムブロックを使用するには、サーバーに各プラグインがインストールされている必要があります。 AOneBlockは起動時にこれらのプラグインを自動検出し、適切なブロックハンドラーを登録します。 itemsadder、nexoまたはcraftengineブロックを設定してもプラグインがインストールされていない場合、ブロックはSTONEにフォールバックします。

チェストファイルには、フェーズ番号とchestsセクションのみが含まれています。

chests

説明

blocksセクションにCHESTがリストされている場合、このセクションに従ってランダムに中身が入れられます。好きなだけチェストを定義できます。最初の数字はチェストの固有番号です。次にチェストの内容物が続き、スロット番号とアイテムスタックの内容が含まれます。最後に、COMMON、UNCOMMON、RARE、EPICのいずれかのレアリティが設定されます。確率はハードコードされており、それぞれ62%、25%、9%、4%です。

チェストを設定する最善の方法はゲーム内で行うことです。必要な内容物でチェストを満たし、チェストを見ながら/[admin_cmd] setchest <phase> <rarity>コマンドを入力します。<phase>はフェーズ名、rarityはレアリティです。TabキーでオートコンプリートされるオプションをTab補完で確認できます。チェストは自動的にoneblocks.ymlファイルに追加されて使用できるようになります。チェストの削除は現時点ではoneblocks.ymlファイルを編集してアドオンをリロードする必要があります。

チェストのアイテムを編集する際は、Materialが正しいBukkit Materialであり、正しくスペルされていることを確認してください。

カスタマイズ可能なGUI#

BentoBox 1.17 APIではカスタマイズ可能なGUIを実装する機能が導入されました。このアドオンはこの機能を最初に使用したアドオンの1つです。カスタマイズをできるだけシンプルにするよう努めましたが、一部の機能には説明が必要です。 BentoBoxのカスタムGUIの仕組みについての詳細はこちら: カスタムGUI

GUIをカスタマイズするにはどうすればよいですか？

アドオンのGUIをカスタマイズするにはバージョン1.10が必要です。これが最初にGUIを実装したバージョンです。アドオンは/plugins/BentoBox/addons/AOneBlockの下にpanelsという名前のディレクトリを作成します。

PREVIOUS|NEXTボタンタイプとは何ですか？

PREVIOUSとNEXTボタンタイプは、GUIに収まりきれない島が多い場合の自動ページングを作成できます。これらのタイプにはdataの下に追加パラメーターがあります:

indexing - ボタンにページ番号を表示するかどうかを示します。

例:

    icon: tipped_arrow[potion_contents={custom_color:11546150}]
    title: aoneblock.gui.buttons.previous.name
    description: aoneblock.gui.buttons.previous.description
    data:
      type: PREVIOUS
      indexing: true
    actions:
      previous:
        click-type: LEFT
        tooltip: aoneblock.gui.tips.click-to-previous

PHASEボタンタイプとは何ですか？

このボタンはプレイヤーがフェーズ名と要件を表示できるようにします。ユーザーがフェーズ変更のアクセス権を持ち、既にそのフェーズに到達している場合は、再度選択してリプレイできます。

icon、title、descriptionはフェーズのプロパティに基づいて動的に生成されます。ただし、手動で変更することもできます。

例:

  # icon: PLAYER_HEAD
  # title: aoneblock.gui.buttons.phase.name
  # description: aoneblock.gui.buttons.phase.description
  data:
    type: PHASE
  actions:
    select:
      click-type: LEFT
      tooltip: aoneblock.gui.tips.click-to-change

コマンド#

Tip

[player_command]と[admin_command]は実行中のゲームモードによって異なるコマンドです。

ゲームモードのconfig.ymlファイルにはこれらの値を変更するオプションがあります。

例えば、AOneBlockでは、デフォルトの[player_command]はob、デフォルトの[admin_command]はobaです。

このアドオンではアドオンのconfig.ymlファイルでプレイヤーコマンドのエイリアスを変更できることに注意してください。

AOneBlock固有のプレイヤーコマンド管理者コマンド

/[player_command] count: 現在のフェーズの進捗をチャットに送信します。
/[player_command] phases: フェーズの表示と選択ができるGUIを開きます。
/[player_command] setcount <number>: <number>をフェーズ開始番号として現在のフェーズを変更できます。
/[player_command] check: 魔法のブロックの周りにパーティクルをスポーンさせるか、何らかの理由でブロックがない場合は再スポーンさせます。
/[player_command] bossbar: フェーズの進捗を表示するボスバーの表示/非表示を切り替えます。（1.21.2以降、configでbossbar: trueが必要）
/[player_command] actionbar: フェーズの進捗を表示するアクションバーの表示/非表示を切り替えます。（1.21.2以降、configでactionbar: trueが必要）

/[admin_command] sanity [<phase>]: フェーズ（または<phase>）のチェストが正しいかどうかのメッセージをコンソールに送信します。
/[admin_command] setcount <player> <number>: <player>の現在のフェーズを<number>（フェーズ開始番号）に変更できます。
/[admin_command] setchest <phase> <rarity>: 見ているチェストを<phase>のチェストセクションに<rarity>で保存します。

デフォルトでは、BentoBox GameModeアドオンにはデフォルトのサブコマンドセットが付属していますが、各アドオンにはさらに多くのサブコマンドがある場合があります。

AOneBlockコマンドの完全一覧

パーミッション#

Tip

AOneBlockアドオンのすべての場所で[gamemode]プレフィックスはaoneblockに置き換える必要があります。

プレイヤーパーミッション管理者パーミッション

aoneblock.count - プレイヤーが'/[player_command] count'コマンドを使用できるようにします。デフォルトで有効。
aoneblock.phases - プレイヤーが'/[player_command] phases'コマンドを使用できるようにします。デフォルトで無効。
aoneblock.island.setcount - プレイヤーが'/[player_command] setcount'コマンドを使用できるようにします。デフォルトで無効。
aoneblock.respawn-block - プレイヤーが'/[player_command] check'コマンドを使用できるようにします。デフォルトで有効。
aoneblock.island.bossbar - プレイヤーが'/[player_command] bossbar'コマンドを使用できるようにします。デフォルトで有効。（configでbossbar: trueが必要）
aoneblock.island.actionbar - プレイヤーが'/[player_command] actionbar'コマンドを使用できるようにします。デフォルトで有効。（configでactionbar: trueが必要）

aoneblock.admin.sanity - プレイヤーが'/[admin_command] sanity'コマンドを使用できるようにします。デフォルトOP。
aoneblock.admin.setchest - プレイヤーが'/[admin_command] setchest'コマンドを使用できるようにします。デフォルトOP。
aoneblock.admin.setcount - プレイヤーが'/[admin_command] setcount'コマンドを使用できるようにします。デフォルトOP。

デフォルトでは、BentoBox GameModeアドオンにはデフォルトのサブパーミッションセットが付属していますが、各アドオンにはさらに多くのサブパーミッションがある場合があります。

AOneBlockパーミッションの完全一覧

フラグ#

AOneBlockはゲームプレイの動作を制御するいくつかのカスタムフラグを導入しています:

フラグ	タイプ	説明	デフォルト
`START_SAFETY`	ワールド設定	有効にすると、プレイヤーが新しい島を作成した際に短時間移動できなくなり、すぐに落下するのを防ぎます。持続時間はconfigの`starting-safety-duration`で設定されます。	false
`ONEBLOCK_BOSSBAR`	島の設定	プレイヤーにOneBlockフェーズ進捗ボスバーを表示するかどうかを切り替えます。configで`bossbar: true`が設定されている場合のみ利用可能です。	true
`ONEBLOCK_ACTIONBAR`	島の設定	プレイヤーにOneBlockフェーズ進捗アクションバーを表示するかどうかを切り替えます。configで`actionbar: true`が設定されている場合のみ利用可能です。	true
`MAGIC_BLOCK`	保護	魔法のブロックを破壊するために必要な最低島ランクを設定します。デフォルトランクはCoopです。	COOP

プレースホルダー#

AOneBlockアドオンには独自のプレースホルダーがあります。これらのプレースホルダーはAOneBlockが保存しているデータに関連しています。

プレースホルダー	説明	AOneBlockバージョン
%aoneblock_my_island_phase%	自分の島のフェーズ	1.1.2
%aoneblock_my_island_count%	自分の島のブロック数	1.1.2
%aoneblock_visited_island_phase%	現在立っている島のフェーズ	1.1.2
%aoneblock_visited_island_count%	現在立っている島のブロック数	1.1.2
%aoneblock_my_island_next_phase%	自分の島の次のフェーズ	1.1.2
%aoneblock_visited_island_next_phase%	現在立っている島の次のフェーズ	1.1.2
%aoneblock_my_island_blocks_to_next_phase%	次のフェーズまでのブロック数（次のフェーズがない場合は「infinite」）	1.5.2
%aoneblock_visited_island_blocks_to_next_phase%	現在立っている島の次のフェーズまでのブロック数	1.5.2
%aoneblock_my_island_percent_done%	フェーズの完了率	1.5.2
%aoneblock_visited_island_percent_done%	現在立っている島のフェーズの完了率	1.5.2
%aoneblock_my_island_done_scale%	自分の島のフェーズ完了スケール	1.5.2
%aoneblock_visited_island_done_scale%	現在立っている島のフェーズ完了スケール	1.5.2
%aoneblock_my_island_lifetime_count%	自分の島の累計ブロック数	1.10.0
%aoneblock_visited_island_lifetime_count%	現在立っている島の累計ブロック数	1.10.0

デフォルトでは、BentoBox GameModeアドオンにはデフォルトのプレースホルダーセットが付属していますが、各アドオンにはさらに多くのプレースホルダーがある場合があります。

AOneBlockプレースホルダーの完全一覧

よくある質問#

機能Xを追加してもらえますか？

こちらのリストに追加してください。

バグを見つけました。どこに報告すればよいですか？

こちらのリストに追加してください。

どんなフェーズがありますか？

11のフェーズがあります: 平原、地下、冬、海洋、ジャングル、沼地、ダンジョン、砂漠、ネザー、豊穣、荒廃、エンド。

各フェーズにはその舞台に適したブロック、アイテム、モブのセットが含まれています。

11フェーズに合計何ブロックありますか？

現在、11,000ブロックあります！

最後のフェーズの後はどうなりますか？

フェーズが繰り返されます。

なぜ何度も落下して死んでしまうのですか？

生き残るためのコツはありますが、難しいかもしれません！防衛を築く必要があります。

なぜ特定のブロックが他よりも多く出現するのですか？

そういう設定になっています！phasesフォルダの設定ファイルで相対確率を設定できます。

どれが魔法のブロックかわかるにはどうすればよいですか？

叩くと緑のパーティクルが出ます。

魔法のブロックがなくなりました！どうすれば別のを入手できますか？

その場所にブロックを置く必要があります。最悪の場合、自分で死ねばブロックが生成されます。

魔法のブロックが液体です！どうやって採掘しますか？

バケツを使ってください。

どんなモブがスポーンしますか？

各フェーズには異なるモブセットがあります。落下しないよう注意してください！注意深く聞くと、敵対モブが近づく音が聞こえることがあります。

敵対モブがスポーンしても反応する時間がありません！

準備してください。ブロックを採掘するときに注意深く聞くと、スポーン前に敵対モブが近づく音が聞こえます。敵対フェーズにいる場合は、モブを予想して防衛を築いて身を守りましょう。かなり遠くからブロックを採掘できます。

モブがスポーンすると防衛が壊されます！なぜですか？

モブはスポーンするための空間を作ります。邪魔なものがあれば壊れて落ちます。それに合わせて建築する必要があります。

チェストはスポーンしますか？

はい。チェストは現在のフェーズのランダムなアイテムで出現します。コモン、アンコモン、レア、エピックのチェストがあります。キラキラしているチェストは良いものです。

このマップでネザーやエンドに到達することはできますか？

バニラのネザーはデフォルトで存在しますが、エンドワールドはありません。

ただし、BentoBoxはカスタマイズ可能で、AOneBlockの設定ファイルでネザー島とエンドワールドを有効にできます。

魔法のブロックはオーバーワールドにのみ存在することに注意してください。

最終的なゴールは何ですか？

あなたが望むものがゴールです！

ホログラムの使い方は？

AOneBlockは1.12.3以前のバージョンでホログラムにHolographic Displaysを使用します。ホログラムセクションを使用するにはこのプラグインをインストールする必要があります！

ただし、バージョン1.13以降とMinecraft 1.19.4以降では、ホログラムに追加のプラグインは不要です。Minecraft Text Entityを使用して表示されます。

Levelsアドオンを使用すべきですか？

あなた次第ですが、使用する場合はプレイヤーが無限のブロックを持っているためレベルが高くなる可能性があることに注意してください。私はLevelsアドオンを使わずLikesアドオンを使用することを好みます。

翻訳#

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

BentoBoxとその拡張機能のほとんどの翻訳はAIの助けを借りて生成されているため、作業の大部分はすでに完了しています — ただしAIは完璧ではありません。コミュニティに本当に必要なのは、 エラーの報告と修正です。

誤りや不自然な表現を見つけた場合は、 bentobox.world（GitHubオーガニゼーションへのショートリンク）からissueまたはPRを開くか、 Discordでご連絡ください。
新しい言語を追加したい場合は、該当リポジトリの src/main/resources/locales/に新しいロケールファイルを追加する PRを開くか、Discordでご相談ください。

言語	言語コード	進捗
英語（アメリカ）	`en-US`	100%（デフォルト）
イタリア語	`it`	100%
インドネシア語	`id`	100%
ウクライナ語	`uk`	100%
クロアチア語	`hr`	100%
スペイン語	`es`	100%
チェコ語	`cs`	100%
トルコ語	`tr`	100%
ドイツ語	`de`	100%
ハンガリー語	`hu`	100%
フランス語	`fr`	100%
ベトナム語	`vi`	100%
ポルトガル語	`pt`	100%
ポーランド語	`pl`	100%
ロシア語	`ru`	100%
中国語（中国）	`zh-CN`	100%
中国語（台湾）	`zh-TW`	100%
日本語	`ja`	100%

API#

BentoBox 1.17 APIではクラスローダーの問題を解決する機能が実装されました。コードに直接アクセスしたいプラグインは、これ以降直接アクセスできるようになりました。

プロジェクトの依存関係としてAOneBlockを追加するだけです。Mavenを使用できます:

<dependency>
    <groupId>world.bentobox</groupId>
    <artifactId>aoneblock</artifactId>
    <version>1.10.0</version>
    <scope>provided</scope>
</dependency>

AOneBlockアドオンは別のデータベーステーブルにデータを保存します。

OneBlockIslands

説明

OneBlockIslandsはフェーズを通じた島の進捗に関するすべての情報を保存します。

ソースコードへのリンク: OneBlockIslands

変数

"uniqueId": 島の固有ID。Island uniqueIdと同じです。
"blockNumber": 現在の破壊済みブロック番号。
"lifetime": 破壊されたブロックの総数。
"phaseName": 現在のフェーズ名。
"hologram": 表示されているホログラムテキスト。

コード例

このデータにアクセスするには、AOneBlockアドオンにアクセスする必要があります。いくつかの方法がありますが、以下の例はどこからでもアクセス可能な汎用的な方法を示しています。

public void accessToAOneBlockData(@NonNull Island island) {
   BentoBox.getInstance().getAddonsManager().<AOneBlock>getAddonByName("AOneBlock").ifPresent(aOneBlock -> {
        OneBlockIslands oneBlockData = aOneBlock.getOneBlocksIsland(island);           

        String islandUniqueId = oneBlockData.getUniqueId();
        int brokenBlocks = oneBlockData.getBlockNumber();
        long lifetimeBlocks = oneBlockData.getLifetime();
        String phase = oneBlockData.getPhaseName();
        String hologram = oneBlockData.getHologram();
   });
}

イベント#

AOneBlockにはAOneBlock専用のカスタムイベントがあります。ただし、BentoBox GameModeのイベントはAOneBlockでも引き続きトリガーされます。

BlockClearEventMagicBlockEntityEventMagicBlockEventMagicBlockPhaseEvent

説明

このイベントはエンティティがスポーンされる前にトリガーされます。空気または水に置き換えられるブロックのリストが含まれています。

キャンセル可能です。

クラスへのリンク: BlockClearEvent

変数

Entity entity - スポーンされるエンティティ。
List<Block> airBlocks - 空気に置き換えられるブロックのリスト。
List<Block> waterBlocks - 水に置き換えられるブロックのリスト。
boolean cancelled - イベントがキャンセルされているかどうかを示すboolean。

コード例

@EventHandler(priority = EventPriority.MONITOR)
public void onBlockClear(BlockClearEvent event) {
    Entity entity = event.getEntity();
    List<Block> airBlocks = event.getAirBlocks();
    List<Block> waterBlocks = event.getWaterBlocks();

    boolean cancelled = event.isCancelled();
}

説明

このイベントはエンティティがスポーンされた後にトリガーされます。スポーンされたエンティティに関する基本情報のみが含まれています。

クラスへのリンク: MagicBlockEntityEvent

変数

EntityType entityType - スポーンされるentityType。
@NonNull Island island - エンティティが召喚される島。
@Nullable UUID playerUUID - エンティティのスポーンをトリガーしたユーザーID。Nullの可能性あり。
@NonNull Block block - 魔法のブロックの位置。

コード例

@EventHandler(priority = EventPriority.MONITOR)
public void onMagicBlockEntity(MagicBlockEntityEvent event) {
    EntityType entityType = event.getEntityType();

    Island island = event.getIsland();
    UUID playerUUID = event.getPlayerUUID();
    Block block = event.getBlock();
}

説明

このイベントは魔法のブロックが破壊された後にトリガーされます。

クラスへのリンク: MagicBlockEvent

変数

@Nullable ItemStack tool - 魔法のブロックを破壊したツール。
@NotNull Material nextBlockMaterial - 次の魔法のブロックのマテリアル。
@NonNull Island island - ブロックが召喚される島。
@Nullable UUID playerUUID - 魔法のブロックを破壊したユーザーID。Nullの可能性あり。
@NonNull Block block - 魔法のブロックの位置。

コード例

@EventHandler(priority = EventPriority.MONITOR)
public void onMagicBlock(MagicBlockEvent event) {
    ItemStack tool = event.getTool();
    Material nextBlockMaterial = event.getNextBlockMaterial();

    Island island = event.getIsland();
    UUID playerUUID = event.getPlayerUUID();
    Block block = event.getBlock();
}

説明

このイベントは新しいフェーズが開始された後にトリガーされます。

クラスへのリンク: MagicBlockPhaseEvent

変数

String phase - 新しいフェーズの名前。
String oldPhase - 前のフェーズの名前。
int blockNumber - 新しいフェーズが開始するブロック番号。
@NonNull Island island - ブロックが召喚される島。
@Nullable UUID playerUUID - 魔法のブロックを破壊したユーザーID。Nullの可能性あり。
@NonNull Block block - 魔法のブロックの位置。

コード例

@EventHandler(priority = EventPriority.MONITOR)
public void onMagicBlockPhase(MagicBlockPhaseEvent event) {
    String phase = event.getPhase();
    String oldPhase = event.getOldPhase();
    int blockNumber = event.getBlockNumber();

    Island island = event.getIsland();
    UUID playerUUID = event.getPlayerUUID();
    Block block = event.getBlock();
}

変更履歴#

v1.23.0の新機能 — ロケールとconfig更新が必要

リリース日: 2026-04-11

Nexoカスタムブロックサポート。 AOneBlockはフェーズ定義でのNexoカスタムブロックをサポートするようになりました（既存のItemsAdderサポートに追加）。フェーズのconfigでtype: nexoとidフィールドを使用して定義します。
アクションバーでのHEX / MiniMessageカラーサポート。 /ob actionbarテキストがHEXカラーと完全なMiniMessageフォーマットを正しくレンダリングするようになりました。
🔡 ロシア語ロケールがMiniMessageフォーマットに更新され、文法が修正されました。
アクションバーのロケールと翻訳に関するいくつかのバグ修正。

🔺 Nexoサポートは新しい設定オプションです。 Nexoを使用する場合は、フェーズの.ymlファイルにNexoタイプのブロックエントリを追加してください。

🔡 カスタマイズがある場合はロケールファイルを再生成してください。

リリース v1.23.0

v1.24.0 の新機能 — BentoBox 3.15.0 が必要

リリース日： 2026-04-26

CraftEngine カスタムブロックサポート。 フェーズ定義で type: craftengine を使用して CraftEngine ブロックを生成できるようになりました。BentoBox 3.15.0+ が必要です。
レアリティ別に設定可能なチェストパーティクル。 UNCOMMON/RARE/EPIC チェストの上に表示されるパーティクルの種類と色が config.yml の world.chest-particles で設定可能になりました。NONE に設定すると無効化できます。
CHEST_WITH_X 固定ブロック記法。 フェーズの fixedBlocks で CHEST_WITH_<ITEM> 形式を使用して、そのアイテムが入ったチェストを設置できます（例：CHEST_WITH_WATER_BUCKET）。
OBSIDIAN_SCOOPING がデフォルトでオフに。 新規インストールではこのフラグが false に設定されます。明示的に設定している既存サーバーは影響を受けません。
🔡 アイランドのないプレイヤーのプレースホルダーデフォルト値：%aoneblock_my_island_phase%、%aoneblock_my_island_count%、%aoneblock_my_island_percent_done% が空文字列の代わりに Unknown、0、0% を返すようになりました。

🔺 BentoBox 3.15.0 以降が必要です — このリリースは古い BentoBox バージョンではロードされません。

⚙️ 新しい config セクション world.chest-particles — 設定可能なパーティクルエフェクトを使用したい場合は、最新の config.yml からコピーしてください。

🔡 新しいキーを取得するためにロケールファイルを再生成してください。

リリース v1.24.0

v1.25.0 の新機能

リリース日： 2026-05-03

Plenty フェーズで蜂が住み着いた蜂の巣がドロップ。 Plenty フェーズが、既存のハチミツアイテムと同じ密度で bee_nest（中に 3 匹のミツバチ、honey_level=0）をドロップするようになり、長らく欠けていたハチミツ養蜂のギャップを埋めました。
モブを引いた後のマジックブロックのクライアント再同期。 マジックブロックがモブを引いたとき、サーバーは破壊イベントをキャンセルしましたが、クライアントには通知していなかったため、次のチャンク再同期（通常は再ログイン時）までブロックが透明に見えていました。キャンセル直後に採掘していたプレイヤーへブロック状態が再送されるようになりました。
🐛 CraftEngine 起動順序の修正。 AOneBlock の onEnable が CraftEngine がブロックレジストリを準備する前に走るため、有効な type: craftengine エントリーごとに大量の誤った Bad custom block エラーが出ていました。ブロックパーサーは config 読み込み時に明示的な type: craftengine 宣言を信頼するようになり、ID は配置時に検証されます。
🐛 Config 読み込み時の CraftEngine ブロック ID 検証強化。 空の ID および namespace:key 形式に従わない ID は、設定読み込み時点で拒否されるようになりました。以前は無視されて配置時に失敗していました。
🐛 設定可能なチェストパーティクルが非 DUST タイプでクラッシュしなくなりました。 データタイプが非 Void のパーティクル（ITEM、BLOCK、ENTITY_EFFECT など）は以前 IllegalArgumentException をスローしていました。これらは検出され、警告としてログに記録され、スキップされるようになりました。DUST および void データのパーティクル（FLAME など）は変わらず動作します。

🔺 新しい蜂の巣エントリーが必要な場合は、新しいエントリーを phases/8500_plenty.yml にコピーするか（あるいは phases フォルダーを削除して再生成させる） — カスタマイズされたフェーズファイルはアップグレード時に上書きされません。

Release v1.25.0

最終更新日: 2026年5月9日 23:22:46