アリーナの作成

isEnabled

アリーナが有効かどうかを設定します。

キー	値	デフォルト
`isEnabled`	Boolean	`true`

例

isEnabled: true

arenaName

アリーナの名前を設定します。

キー	値	デフォルト
`arenaName`	String	`Default name`

例

arenaName: Bedrock Arena

corner1

アリーナの最初の角を設定します。

キー	値	デフォルト
`corner1`	Location	なし

例

corner1: my_arena_world,10,50,-10,0,0

位置の形式は world_name,x,y,z,yaw,pitch です。world_name はワールド名、x/y/z は座標、yaw は水平回転（0〜360）、pitch は垂直回転（-90〜90）です。

この画像では corner1 が緑色の羊毛で、corner2 が赤色の羊毛で表されています。この設定により、両者の間の領域がアリーナとして指定され、黄色の羊毛で表されています。

corner2

アリーナの2つ目の角を設定します。corner1 の反対側の角でなければなりません。これら2つの角がアリーナ空間の境界を定義します。

キー	値	デフォルト
`corner2`	Location	なし

例

corner2: my_arena_world,-10,50,10,0,0

startLocation

アリーナのスタート地点を設定します。

キー	値	デフォルト
`startLocation`	Location	なし

例

startLocation: my_arena_world,1,50,1,0,0

exitLocation

アリーナの退出地点を設定します。

キー	値	デフォルト
`exitLocation`	Location	なし

例

exitLocation: my_world,1,50,1,0,0

waveCount

アリーナが持つウェーブの数を設定します。

キー	値	デフォルト
`waveCount`	Integer	`0`

例

waveCount: 10

delayBetweenWaves

ウェーブ間の遅延を秒単位で設定します。

キー	値	デフォルト
`delayBetweenWaves`	Integer	`0`

例

delayBetweenWaves: 5

rawIntermissionWaves

リストで指定したウェーブについて、ウェーブ間の遅延を2倍にします。これらのウェーブでは遅延が delayBetweenWaves * 2 になります。特定のウェーブの間にプレイヤーへ短い休憩を与えたい場合に便利です。

キー	値	デフォルト
`rawIntermissionWaves`	Integer List	なし

例

rawIntermissionWaves:
- '5'
- '10'
- '15'

spawnPoints

アリーナのボスのスポーン地点を設定します。

キー	値	デフォルト
`spawnPoints`	String List [1]	なし

例

spawnPoints:
- name=north:location=my_arena_world,219.5,71,273.5
- name=south:location=my_arena_world,219.5,71,316.5
- name=west:location=my_arena_world,197.5,71,295.5
- name=east:location=my_arena_world,240.5,71,295.5
- name=center:location=my_arena_world,219.5,71,295.5

bossList

アリーナのウェーブ中に出現するボスのリストを設定します。EliteMobs アリーナはアリーナ内での Mythic Mobs のスポーンをサポートしています。

キー	値	デフォルト
`bossList`	String List [2]	なし

例

bossList:
- wave=1:spawnPoint=north:boss=my_boss_wave_1.yml
- wave=1:spawnPoint=south:boss=my_boss_wave_1.yml
- wave=2:spawnPoint=center:boss=my_mythicmobs_boss:mythicmob=true:level=10

この例では、ウェーブ 1 で north のスポーン地点に1体、south のスポーン地点に1体のボスがスポーンします。その後、ウェーブ 2 では、center 地点にレベル 10 の mythic ボスがスポーンします。

level パラメーター（例: level=10）を使って EliteMobs のボスのレベルを強制することもできますが、一貫性のため、レベルは設定ファイルで設定することをおすすめします。level パラメーターはアリーナの難易度をスケールするのに便利です。

rawArenaReward

ウェーブ終了時に与えられる報酬を設定します。

注: ソースコード内では、このフィールドは rawArenaRewards（複数形）として参照されている場合もあります。

キー	値	デフォルト
`rawArenaReward`	汎用 EliteMobs ルートテーブル	なし

例

rawArenaReward:
- filename=enchanted_book_damage_all.yml:wave=5:chance=0.25
- filename=elite_scrap_tiny.yml:wave=1:chance=0.5:amount=5
- currencyAmount=3:wave=3
- level=5:filename=summon_merchant_scroll.yml:wave=5
- filename=magmaguys_toothpick.yml:itemlevel=10:wave=10:chance=0.95

minimumPlayerCount

アリーナが開始される前に必要な最小プレイヤー数を設定します。

キー	値	デフォルト
`minimumPlayerCount`	Integer	`1`

例

minimumPlayerCount: 1

maximumPlayerCount

アリーナが受け入れられる最大プレイヤー数を設定します。

キー	値	デフォルト
`maximumPlayerCount`	Integer	`0`

例

maximumPlayerCount: 100

arenaMessages

ウェーブ間に流れるメッセージを設定します。

キー	値	デフォルト
`arenaMessages`	特殊 [3]	なし

例

arenaMessages:
- wave=1:message="&a[Arena Announcer] &fTime for wave one!"
- wave=2:message="&a[Arena Announcer] &fWow, wave two already."

cylindricalArena

アリーナが円柱形を使用するかどうかを設定します（デフォルトは直方体）。

キー	値	デフォルト
`cylindricalArena`	Boolean	`false`

例

cylindricalArena: false

permission

アリーナを使用するために必要な権限を設定します。

キー	値	デフォルト
`permission`	String	なし

例

permission: mypermission.arena

teleportLocation

アリーナの NPC とやり取りした後にプレイヤーがテレポートされる場所を設定します。この設定は通常、アリーナチャレンジを開始したり、他のプレイヤーがアリーナを通過し終えるのを待ったりできる、アリーナ専用のロビー的なエリアにプレイヤーをテレポートさせるために使用されます。

キー	値	デフォルト
`teleportLocation`	Location	なし

例

teleportLocation: my_arena_world,10,50,10,0,0

特殊 [1]

スポーン地点: 次の形式を使用します: name=pointName:location=world_name,x,y,z。

特殊 [2]

ボスリスト: 次の形式を使用します: wave=x:spawnPoint=Y:boss=bossfilename.yml。

特殊 [3]

アリーナメッセージ: 次の形式を使用します: wave=X:message=ここにメッセージ。

アリーナ設定の例

isEnabled: true
arenaName: Example Arena
corner1: my_arena_world,0,0,0,0,0
corner2: my_arena_world,50,50,50,0,0
startLocation: my_arena_world,25,0,25,0,0
exitLocation: my_minecraft_world,234,44,245,0,0
waveCount: 5
delayBetweenWaves: 5
spawnPoints:
  - name=north:location=my_arena_world,40.5,0,0
  - name=south:location=my_arena_world,10.5,0,0
  - name=west:location=my_arena_world,0,0,40.5
  - name=east:location=my_arena_world,0,0,10.5
  - name=center:location=my_arena_world,25.5,0,25.5
bossList:
  - wave=1:spawnPoint=north:boss=example_arena_wave_1_mob.yml
  - wave=1:spawnPoint=center:boss=example_arena_wave_1_mob.yml
  - wave=1:spawnPoint=south:boss=example_arena_wave_1_mob.yml
  - wave=2:spawnPoint=center:boss=example_arena_wave_2_mob.yml
  - wave=3:spawnPoint=east:boss=example_arena_wave_3_mob.yml
  - wave=3:spawnPoint=west:boss=example_arena_wave_3_mob.yml
  - wave=4:spawnPoint=center:boss=example_arena_wave_4_mob.yml
  - wave=4:spawnPoint=center:boss=example_arena_wave_4_mob.yml
  - wave=5:spawnPoint=center:boss=example_arena_wave_5_mob.yml
  - wave=5:spawnPoint=south:boss=example_arena_wave_5_mob.yml
  - wave=5:spawnPoint=west:boss=example_arena_wave_5_mob.yml
rawArenaReward:
  - currencyAmount=5:wave=1
  - currencyAmount=10:wave=2
  - currencyAmount=15:wave=3
  - currencyAmount=20:wave=4
  - currencyAmount=25:wave=5
  - filename=magmaguys_toothpick.yml:itemlevel=5:wave=5:chance=0.5
minimumPlayerCount: 1
maximumPlayerCount: 3
arenaMessages:
  - wave=1:message=&d[Arena NPC] &fWow! Wave 1!
  - wave=2:message=&d[Arena NPC] &fAmazing it is wave 2!
  - wave=3:message=&d[Arena NPC] &fWave 3 is now on!
  - wave=4:message=&d[Arena NPC] &fWave 4 already!
  - wave=5:message=&d[Arena NPC] &fWell it is all over after this one.
cylindricalArena: false
permission: arena.mypermission

例の解説

この例を上から順に見ていき、このアリーナ設定が何をするのかを説明しましょう。

まず、アリーナは isEnabled で有効になっており、arenaName 設定によって Example Arena という名前であることが分かります。この名前は、プレイヤーがアリーナに参加できるようにするアリーナ NPC（アリーナ NPC の作り方については後ほど説明します）とやり取りしたときに表示されます。corner1 と corner2 はアリーナのサイズを定義します。これらの角は、アリーナとして使う予定のエリアにおいて、互いに反対側にある必要があります。

startLocation は、プレイヤーがアリーナに参加したときにスポーンする場所です。この例では、ワールド my_arena_world のアリーナの中央になります。exitLocation は、プレイヤーがアリーナに失敗するか終了した後にテレポートされる場所です。この場合は、ワールド my_minecraft_world と例の座標になります。

waveCount は単純に、アリーナが続くウェーブの数を設定します。この場合は 5 ウェーブになります。プレイヤーが 5 ウェーブすべてを生き延びれば、アリーナを生き残ったことになります。delayBetweenWaves は、次のウェーブが始まるまでの秒数を設定します。この例では、プレイヤーは次のウェーブが始まるまでに 5 秒の準備時間があります。

spawnPoints は、MOB をスポーンさせられる場所を設定します。好きなだけ作ることができ、好きな名前を付けられます。この例では、5 つのスポーン地点を作り、north、south、center、east、west と名付けることにしました。

bossList は、どのボスをどのウェーブのどの場所にスポーンさせるかを定義する場所です。この例では、ウェーブ 1 で、north、center、south と名付けたスポーン地点から 3 体のボスがスポーンします。3 体すべて同じボスファイルを使うように設定していますが、それぞれに異なるボスファイルを使うこともできました。

rawArenaReward は、プレイヤーがウェーブを生き延びる／突破した後に配られる報酬を設定します。この例で分かるように、ウェーブ 1 を突破するとプレイヤーは 5 エリートコインを受け取ります。残りのウェーブを生き延びてウェーブ 5 を突破すると、25 エリートコインと、50% の確率でレベル 5 の MagmaGuy's Toothpick を受け取ります。

minimumPlayerCount は、アリーナが開始される前に必要な最小プレイヤー数を設定します。この例ではこの設定が 1 になっているため、アリーナを開始するにはプレイヤー 1 人だけで十分です。maximumPlayerCount は、アリーナに参加できる最大プレイヤー数を設定します。この例ではこの設定が 3 になっているため、4 人以上のプレイヤーがアリーナに参加しようとすると、プレイヤーが 3 人以下になるまでアリーナは開始されません。

arenaMessages は、定義したウェーブの開始時にチャットに表示されるフレーバーテキストを追加できます。この例では、各ウェーブの開始時に短いメッセージを表示することにしました。また、各メッセージの先頭に NPC の名前を含めることで、そのテキストがアナウンサー（アリーナマスター）によって語られるセリフであるかのような演出にしています。

cylindricalArena この設定では、corner1 と corner2 で設定した領域を、直方体ではなく円柱形にするかどうかを切り替えられます。この例ではこれを false に設定しているため、例のアリーナは直方体の形になります。

permission は、プレイヤーがアリーナに参加／開始できるようになるために必要な権限を設定できます。この例では、プレイヤーはアリーナを使用できるようになるために arena.mypermission 権限が必要になります。

アリーナ NPC の作成

isEnabled

NPC が有効かどうかを設定します。

キー	値	デフォルト
`isEnabled`	Boolean	`true`

例

isEnabled: true

name

NPC の表示名を設定します。

キー	値	デフォルト
`name`	String	なし

例

name: "&aGladius"

role

NPC 名の下に表示される役割（role）を設定します。

キー	値	デフォルト
`role`	String	なし

例

role: "&c<Arena Master>"

profession

NPC の Minecraft の職業を設定します。

キー	値	デフォルト
`profession`	Profession	`NITWIT`

例

profession: ARMORER

disguise が使用されている場合は上書きされます。

spawnLocation

NPC のスポーン地点を設定します。

キー	値	デフォルト
`spawnLocation`	Location	なし

例

spawnLocation: my_world,1.5,50,1.5,-108,0

spawnLocations

NPC の追加のスポーン地点を設定します。これにより、1 つの NPC 設定で複数の場所にスポーンさせることができます。

キー	値	デフォルト
`spawnLocations`	String List	なし

例

spawnLocations:
- my_world,1.5,50,1.5,-108,0
- my_world,100.5,50,50.5,0,0

greetings

NPC の挨拶（greeting）ダイアログを設定します。

キー	値	デフォルト
`greetings`	String List	なし

例

greetings:
- Welcome to the Arena!
- The Arena welcomes you!

dialog

プレイヤーが NPC とやり取りしたときのダイアログを設定します。

キー	値	デフォルト
`dialog`	String List	なし

例

dialog:
- Ready for a challenge?
- Face the Arena?

farewell

NPC の別れ（farewell）のダイアログを設定します。プレイヤーが立ち去るときに表示されます。

キー	値	デフォルト
`farewell`	String List	なし

例

farewell:
- Bye.
- Return with your shield, or on it!

文字列が長すぎる場合は、\n を使って文字列を複数行に分割できます。

farewell:
- Bye.
- Return with your\nshield, or on it!

canTalk

NPC がプレイヤーに話しかけられるかどうかを設定します。

キー	値	デフォルト
`canTalk`	Boolean	`true`

例

canTalk: true

activationRadius

NPC が話し始めるべき範囲（半径）を設定します。

キー	値	デフォルト
`activationRadius`	`Double`	`3.0`

例

activationRadius: 3.0

timeout

NPC のタイムアウトを秒単位で設定します。設定すると、NPC は指定した時間の後にデスポーンします。

キー	値	デフォルト
`timeout`	Double	`0`

例

timeout: 60

interactionType

NPC が行うインタラクションのタイプを設定します。

キー	値	デフォルト
`interactionType`	特殊 [4]	`NONE`

例

interactionType: ARENA_MASTER

disguise

カスタム NPC の変装を設定します。

キー	値	デフォルト
`disguise`	Disguise	なし

例

disguise: ZOMBIE

customDisguiseData

LibsDisguises の変装用のカスタム変装データを設定します。これにより、基本的な disguise 設定を超えた詳細な変装のカスタマイズが可能になります。

キー	値	デフォルト
`customDisguiseData`	String	なし

例

customDisguiseData: player MHF_Pig

customModel

NPC に使用するカスタムモデルを設定します。有効なカスタムモデルプラグインがインストールされ、設定されている必要があります。

キー	値	デフォルト
`customModel`	String	なし

例

customModel: my_model

arena

プレイヤーがテレポートされるアリーナを設定します。

キー	値	デフォルト
`arena`	`Filename`	なし

例

arena: my_arena.yml

command

NPC とやり取りしたときに実行されるコマンドを設定します。interactionType を COMMAND に設定する必要があります。

キー	値	デフォルト
`command`	String	なし

例

command: say Hello $player

questFileName

NPC のクエストファイル名を設定します。interactionType を CUSTOM_QUEST_GIVER に設定する必要があります。

キー	値	デフォルト
`questFileName`	String List	なし

例

questFileName:
- my_quest_1.yml
- my_quest_2.yml

noPreviousLocationMessage

interactionType が TELEPORT_BACK に設定されている場合に、NPC がプレイヤーをテレポートさせる前の場所を見つけられなかったときに送信されるメッセージを設定します。

キー	値	デフォルト
`noPreviousLocationMessage`	String	なし

例

noPreviousLocationMessage: '&cCouldn''t find a previous location!'

instanced

NPC をインスタンス化するかどうかを設定します。これはインスタンスダンジョン内の NPC に使用します。

キー	値	デフォルト
`instanced`	Boolean	`false`

例

instanced: false

scale

NPC のスケール（サイズ）を設定します。

キー	値	デフォルト
`scale`	Double	`1.0`

例

scale: 1.0

syncMovement

NPC の移動をサーバーに同期させるかどうかを設定します。

キー	値	デフォルト
`syncMovement`	Boolean	`true`

例

syncMovement: true

アリーナ設定の例

isEnabled: true
name: Example NPC
role: <Arena Master>
profession: ARMORER
spawnLocation: my_minecraft_world,233,44,245,0,0
greetings:
  - Welcome to the Arena!
dialog:
  - Ready to enter the Arena?
farewell:
  - Bye!
canTalk: true
activationRadius: 3.0
interactionType: ARENA_MASTER
disguise: ZOMBIE
arena: example_arena.yml

この例は、ゾンビの変装で my_minecraft_world にスポーンする基本的なアリーナ NPC を示しています。プレイヤーはこの NPC とやり取りして Example Arena に挑戦できます。

特殊 [4]

次は、有効な NPC インタラクションタイプの一覧です。

タイプ	説明
`GUILD_GREETER`	冒険者ギルドメニューを開く
`CHAT`	右クリックで `dialog` を順番に表示する
`CUSTOM_SHOP`	カスタムショップメニューを開く
`PROCEDURALLY_GENERATED_SHOP`	手続き生成ショップを開く
`BAR`	バーメニューを開く
`ARENA`	何もしない。代わりに `ARENA_MASTER` を使用すること。
`QUEST_GIVER`	手続き生成クエストメニューを開く
`CUSTOM_QUEST_GIVER`	`questFileName` で設定した特定のクエスト用のクエストメニューを開く
`NONE`	インタラクションなし
`SELL`	売却メニューを開く
`TELEPORT_BACK`	プレイヤーを、直前にいた elitemobs 以外のワールドの場所へテレポートさせる
`SCRAPPER`	スクラップメニューを開く
`SMELTER`	非推奨 - 機能が削除済み、使用しないこと
`REPAIRMAN`	修理メニューを開く
`ENHANCER`	非推奨 - 機能が削除済み、使用しないこと
`REFINER`	非推奨 - 機能が削除済み、使用しないこと
`UNBINDER`	バインド解除メニューを開く
`ARENA_MASTER`	`arena` で設定したアリーナのアリーナメニューを開く
`COMMAND`	`command` で設定したコマンドを実行する
`ENCHANTER`	エンチャントメニューを開く
`SCROLL_APPLIER`	スクロール適用メニューを開く
`ARROW_SHOP`	矢ショップメニューを開く
`GAMBLING_BLACKJACK`	ブラックジャックのギャンブルゲームを開く
`GAMBLING_COINFLIP`	コインフリップのギャンブルゲームを開く
`GAMBLING_SLOTS`	スロットのギャンブルゲームを開く
`GAMBLING_HIGHERLOWER`	ハイ＆ローのギャンブルゲームを開く