AdvCmds
AdvCmds は、Minecraft サーバーのコマンド機能を拡張するユーティリティです。
通常の Minecraft コマンドと組み合わせて、複数コマンドの連続実行、条件分岐、遅延実行、繰り返し、変数、計算、イベント検知、高度なエンティティ選択などを利用できます。
主な機能
/chain — コマンドを連続実行
複数のコマンドを1つにまとめて、順番に実行します。
/chain >say 1< >say 2< >say 3<
この場合、
say 1
say 2
say 3
の順番で実行されます。
--check を付けると、各コマンドが成功した場合のみ次へ進みます。
/chain --check >コマンド1< >コマンド2< >コマンド3<
/if_run — 条件分岐
指定したコマンドが成功するかどうかによって、実行するコマンドを変更できます。
/if_run <判定するコマンド> << then >成功時のコマンド< else >失敗時のコマンド<
たとえば、条件を満たしたプレイヤーにだけ別の処理を行う、といった使い方ができます。
/sleep_run — 遅延実行
指定した tick 数だけ待ってからコマンドを実行します。
/sleep_run <ticks> <command>
例:
/sleep_run 100 say 5秒経過しました
20 ticks ≒ 1秒なので、通常であれば100 ticksで約5秒です。
/for — 繰り返し
指定回数だけコマンドを繰り返します。
/for <変数名> <回数> <command>
ループ中の番号は、
%{変数名}%
で取得できます。
例:
/for i 5 say %{i}%
結果:
0
1
2
3
4
/variables — 変数
値を保存して、別のコマンドから利用できます。
設定:
/variables set <context> <name> <value>
取得:
/variables get <context> <name>
保存した値は、
%{var::<context>::<name>}%
というプレースホルダーでも利用できます。
/placeholder_run — プレースホルダーを展開して実行
AdvCmds のプレースホルダーを処理してから、結果をコマンドとして実行します。
/placeholder_run <command>
変数や計算結果などをコマンドへ埋め込みたい場合に利用できます。
プレースホルダー
変数
%{var::<context>::<name>}%
NBT取得
%{nbt::<target>::<path>}%
指定対象のNBTから値を取得します。
PlaceholderAPI
%{papi::<placeholder>}%
PlaceholderAPIが導入されている場合、そのプレースホルダーを取得できます。
コマンド結果
%{cmd::><command><}%
コマンドの出力結果を値として利用できます。
計算
%{calc:<式>}%
式を評価して結果へ置き換えます。
/comparison — 式の判定
計算式や比較式を評価します。
/comparison <式>
結果が真なら、
[AdvCMD] Comparison True
偽なら、
[AdvCMD] Comparison False
と表示されます。
/cmd_blocks — コマンドブロック機能
複数のコマンドを名前付きで保存し、後からまとめて実行できます。
作成:
/cmd_blocks create <context> <block>
行を追加:
/cmd_blocks line <context> <block> <行番号> <command>
行番号変更:
/cmd_blocks line_change <context> <block> <変更前> <変更後>
実行:
/cmd_blocks run <context> <block>
行番号順に保存されたコマンドが実行されます。
イベント機能
/event_listener
Minecraft内でイベントが発生したとき、自動的にコマンドを実行できます。
/event_listener create <context> <name> <world> <event> <command>
削除:
/event_listener delete <context> <name>
対応している代表的なイベント:
world.block.break
world.block.place
world.entity.kill
world.entity.spawn
さらに、
java::<イベントクラス>
を指定することで、Bukkit/Paperのイベントクラスを直接指定することもできます。
イベント発生時には専用プレースホルダーも利用できます。
ブロック破壊の場合:
%{block_pos}%
%{block_id}%
%{breaker}%
%{event_id}%
ブロック設置の場合:
%{block_pos}%
%{block_id}%
%{placer}%
%{event_id}%
エンティティ死亡の場合:
%{entity_id}%
%{entity_pos}%
%{killer}%
%{event_id}%
エンティティスポーンの場合:
%{entity_id}%
%{entity_pos}%
%{spawner}%
%{event_id}%
/event_cancel
現在処理しているイベントをキャンセルします。
/event_cancel <event_id>
イベントリスナー内で取得できる、
%{event_id}%
と組み合わせて使用できます。
高度なセレクター
AdvCmdsでは、通常のMinecraftセレクターより複雑な条件を扱えます。
Inventory Selector
所持アイテムを条件にエンティティを選択できます。
基本形式:
@e[inventory={item=<アイテム>,pcs=<個数>}]
たとえば、特定のアイテムを持っている対象だけを選択できます。
pcs は範囲指定にも対応しています。
pcs=1..10
pcs=5..
pcs=..10
対象スロットとして、
target=inventory
target=hotbar
target=!hotbar
も指定できます。
拡張セレクター
/extend_selector を使うことで、複数条件を論理演算で組み合わせられます。
/extend_selector <command>
セレクター形式:
{@entities(...)}
{@players(...)}
{@all(...)}
{@nearest(...)}
条件では、
and
or
xor
not
が利用できます。
例:
{@players(type=player and not tag=test)}
括弧による条件のグループ化にも対応しています。
{@entities((type=zombie or type=skeleton) and not tag=ignore)}
一致した対象ごとにコマンドが展開・実行されます。
Count Placeholder
セレクターに一致した対象数を取得できます。
%{count:<selector>}%
通常のセレクターだけでなく、AdvCmdsの拡張セレクターにも対応しています。
そのため、条件に一致するプレイヤーやエンティティの数を、そのまま別のコマンドで利用できます。
PlaceholderAPI連携
PlaceholderAPIが導入されている場合、AdvCmds側から独自プレースホルダーを登録できます。
作成:
/papi_addon create %<placeholder>%
値設定:
/papi_addon set_value %<placeholder>% <value>
作成したプレースホルダーはPlaceholderAPI経由で利用できます。
※ PlaceholderAPIは必須ではありません。
ログ抑制
/log_suppress <command>
または
/log_supress <command>
で、コマンド実行時のコンソール出力を取得・抑制しながら処理できます。
権限
AdvCmdsの各コマンドを使用するには、
advcmd.use
権限、またはOP権限が必要です。
依存関係
AdvCmdsでは以下を使用しています。
-
better-parse 0.4.4 -
PlaceholderAPI 2.11.5(任意)
better-parseは主に拡張セレクターの条件式解析に使用されています。
まとめ
AdvCmdsを導入すると、Minecraftのコマンドに以下のような機能を追加できます。
-
コマンドの連続実行
-
成功・失敗による条件分岐
-
遅延実行
-
forループ
-
変数の保存
-
プレースホルダー
-
数式・比較式
-
コマンドセットの保存と実行
-
ブロック破壊などのイベント検知
-
イベントのキャンセル
-
所持アイテムを利用したセレクター
-
AND / OR / NOT / XOR対応の拡張セレクター
-
セレクターに一致する対象数の取得
-
PlaceholderAPIとの連携
単純なコマンド補助だけでなく、コマンドだけで小規模なスクリプトのような処理を構築できるようにする拡張機能です。
