Advanced Commandsが進化した!

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との連携

単純なコマンド補助だけでなく、コマンドだけで小規模なスクリプトのような処理を構築できるようにする拡張機能です。

image

ちなみにこれ一つのコマンドです

/extend_selector placeholder_run tellraw @a "プレイヤー以外の数: %{count:{@all(not type=player)}}%"

一方バニラだと

/execute as @e[type=!player] run scoreboard players "player以外" add 1

なんだっけ
AdvCmdsに慣れすぎて忘れた

カウントダウンするとき1秒ごとにsayを書かないといけないのってめんどくね

forがあるからsleep_runとforでいける

/chain > for i 15 placeholder_run sleep_run %{calc:%{i}% * 20}% title @a title {"text":"%{calc:15 - %{i}%}%"} < > for i 5 placeholder_run sleep_run %{calc:200 + %{i}% * 20}% execute as @a at @s run playsound minecraft:block.respawn_anchor.charge master @s ~ ~ ~ 1 %{calc:0.8 + %{i}% * 0.1}% < > sleep_run 300 title @a title {"text":"Go!","color":"green","bold":true} < > sleep_run 300 execute as @a at @s run playsound minecraft:entity.player.levelup master @s ~ ~ ~ 1 1 <

こんな感じに

いいね
コマンドの見やすさはまあ…

まあそれがコマンドだから。

tellrawはjsonだから見やすい

そもそも改行できない時点で仕方ないだろ!!

新しい構文作ったら改行できそうじゃね

そもそもコマンドブロックで改行できないからそんなことしたら二度と実行できない

コマンドブロックに書くときは1行で見るときは改行されたらよくない?

コマンドって要するに最初の文字列に割り当てられたハンドラに空白で分割された引数リストが来るだけで、構文定義じゃないんよ
mcfunctionは改行できるけど、改行した時点で別のコマンドとして実行される
見た目だけ改行させるにしても、MODじゃなくてプラグインである以上不可能
もちろんBEとかはoverwrapあるけど、サーバー側は横にどれだけ持てるかを知らないわけで、変に固定空白折れたらある端末ではピッタリで、ある端末では空白が余ってて、ある端末では少なすぎるってことになる。
あと単純に空白をクライアントに提供するってことはコマンドそのものに空白があることになるから色々とめんどくさい。
まあそれよりJE自体コマブロやチャット欄に改行という概念が存在しないから無理

マイクラ側で見えるのは改行じゃなくて
そこからビューアー的なものでだけ改行に見えるといいかなーって

要するにエディタってこと?
それはもうコマンドじゃなくてスクリプト言語では?

コマンドとスクリプトの中間みたいな

まあでもコマンドだからねー
少なくとも素のコマンドよりは読みやすいと思う…うん。