Minecraftのコマンド、ルートテーブル、などデータパックについてのネタを集めたwikiです。
- 一つのデータパックとして配布するには小さすぎる物やモジュール化が面倒な物だが、ゼロから毎回作るのは微妙にめんどくさいというものを、メモ代わりとして置いておくためのリポジトリです。仕組みを理解してもらえたら、コピペや改造でお好きに利用してください。メモ程度なので説明不足な点や煩雑な書き方になっている部分もあるかもしれませんが悪しからず。また、それぞれ初期設定などのコマンドで重複している点もあるので、多用する場合は適当に変更することをオススメします。
- 作成は基本的に最新バージョン/最新スナップショットでやっているのでほとんど最新用になります。アップデートに関しては必要があれば随時行うと思いますが、過去verへの対応は各自で行うようお願いします。よほど低いバージョンでなければ応用できるはずです。
- ある程度データパックの構造や使い方を把握している方向けになるので、どのファイルをどこに置けばいいか等は説明していません。ご了承ください。暇があれば解説するかもしれません。
- バグや改善案などがあれば好きなだけissueを立ててもらって構いません(あと英単語とか)。時間があれば対処します。
github wikiに、ここで掲載している物も含めいろいろと技術的な解説を載せています。
検知や探査といったゲーム制作などで便利そうなコマンドのメモです。
▲動作の様子
プレイヤーがエンティティを殴った時の進捗(player_hurt_entity)や右クリックしたときの進捗(player_interacted_with_entity)によって実行されるファンクションから対象のエンティティを探すコマンドの例。execute on attacker/on targetの利用により簡潔にできるようになった。
モブ攻撃/interaction左クリック/interaction右クリックの3つで可能。
- モブ以外の攻撃先/左クリック先検知と、interaction以外(村人や額縁など)の右クリック先の探査はできない。
- 薙ぎ払い攻撃をしたときに、どの敵が直接攻撃された敵で、どの敵が薙ぎ払いに巻き込まれた敵かを区別することなどはできない。
- execute onの判定は数秒残るようなので、一度プレイヤーに殴られたモブが、プレイヤーが別のモブを殴るときと同時に別の方法でダメージを受けたとき(落下など)は誤作動を起こす可能性がある。あんまり起きないとは思うけど。
entity_association01をdata/直下などに入れ初期設定:init.mcfunctionを実行したら、あとは適当にモブを殴ったりinteractionを右/左クリックしたりするとエンティティの位置でパーティクルが出る。
attack_mob.mcfunction,attack_interaction.mcfunction,interact_interaction.mcfunctionの中をいじれば実行コマンドを変えられる。
(2023/02/23):追加
▲動作の様子
プレイヤーがエンティティを殴った時の進捗(player_hurt_entity)や右クリックしたときの進捗(player_interacted_with_entity)によって実行されるファンクションから対象のエンティティを探すコマンドの例。idを二分探査してエンティティを見つける。前項のやり方では検知できないエンティティなどの右クリ検知がかなり正確に可能。
モブとinteractionへの攻撃/アクション可能エンティティ(村人,額縁,アマスタ,interaction等)への左クリックの2つで可能。
- 各進捗が反応しないエンティティは探査できない。
- 薙ぎ払い攻撃をしたときに直接攻撃された敵→巻き込まれた敵の順で実行される
- 仕組み上誤検知は起こらない
- コマンド実行数がやや多め
- id付与をあらかじめしなくてはいけない
Chen氏の改良案をもとにrequirments周りを改良してます。ありがとにゃん。 ありがとうございます！
事前に二進数化したidが付与されたエンティティを、ビット毎に用意されたcriteriaで解除状況と比較して探査を行う。
entity_association02フォルダをdata/直下などに入れ、初期設定:init.mcfunctionを実行しid付与:id.mcfunctionを対象にしたいエンティティを実行者にして実行する。
attack.mcfunction,interaction.mcfunctionの中をいじれば実行コマンドを変えられる。階層やフォルダ名を変えると変更点が多くなるので注意。
▼id付与ファンクションの実行例
execute as @e[type=!player,distance=..10] run function entity_association02:id
(2023/02/23):追加
▲動作の様子
角をすり抜けない視線先ブロック探査。直線状に探査点を増やすやり方だとどうしてもすり抜けてしまった角をすり抜けないように探査できる。functionループで探査することは変わらないが、視線上だけではない計8方向に手を伸ばしてチェックすることで角抜けがなくなる。また粗い探査→ブロックがありそうだったら細かい探査というやり方ができるので、コマンド数を削減できる。しかしブロックの判定が0.01m程大きくなるので、どちらを使うかは用途次第。
block_exploration01フォルダをdata/直下などに入れ、初期設定:init.mcfunctionを実行したら常時実行:root.mcfunctionを視線探査の起点にしたいエンティティを実行者として常時実行する。
point.mcfunctionの中身が探査終了点で実行されるので、好きなように書き換えて使用可能。
▼常時実行ファンクションの実行例
execute as @p at @s run function block_exploration01:root
(2023/02/26):追加
(2023/03/05):番号を変更
▲動作の様子(青いパーティクルがプレイヤーが見ている面)
かなり正確になった視線先ブロック探査。基本的なループの原理は前項と同じだが、3エンティティを追加し、functionループ中の探査点角度に依存した探査点の増加と、視線がどのブロック面内を見ているかどうかの判定をexecute幾何学などを利用して行っている。これらによってかなり正確になり、前項にあった当たり判定の増加のような挙動はほぼなくなる。ただ、エンティティ3体を使用しており前項よりは負荷がわずかに高いので、なにを使うかは用途次第。
block_exploration02フォルダをdata/直下などに入れ、初期設定:init.mcfunctionを実行したら常時実行:root.mcfunctionを視線探査の起点にしたいエンティティを実行者として常時実行する。
point.mcfunctionの中身が探査終了点で実行されるので、好きなように書き換えて使用可能。
▼常時実行ファンクションの実行例
execute as @p at @s run function block_exploration02:root
(2023/03/05):追加
▲動作の様子
誤差の少ない視線先エンティティ探査。直線状に探査点を増やすやり方だとすり抜けてしまったり、execute幾何学を使うやり方だと形状によってうまく探査できないが、四角形の判定を用いてfunctionループ探査をすることで誤差を少なくして探査できる。こちらも判定は0.01m程大きくなるので、どちらを使うかは用途次第。functionループなので、前項のブロック探査と組み合わせることが可能(後述)。
entity_explorationフォルダをdata/直下などに入れ、初期設定:init.mcfunctionを実行したら常時実行:root.mcfunctionを視線探査の起点にしたいエンティティを実行者として常時実行する。
targets.mcfunctionの中身が探査終了点で実行されるので、好きなように書き換えて使用可能。対象になるエンティティにはtargetsというタグが付与(複数になる可能あり)され、そのfunction内で参照可能。
▼常時実行ファンクションの実行例
execute as @p at @s run function entity_exploration:root
(2023/02/26):追加
(2023/03/05):番号を変更
▲動作の様子
前項2つのブロック探査とエンティティ探査を組み合わせたコマンド。これによって、ブロックが手前にあったらエンティティが探査されないような、より直感的なシステムが作成可能。
explorationフォルダをdata/直下などに入れ、初期設定:init.mcfunctionを実行したら常時実行:root.mcfunctionを視線探査の起点にしたいエンティティを実行者として常時実行する。
targets.mcfunctionの中身がエンティティ探査終了点で実行され、point.mcfunctionの中身がブロック探査終了点で実行されるので、好きなように書き換えて使用可能。対象になるエンティティにはtargetsというタグが付与(複数になる可能あり)され、そのfunction内で参照可能。
▼常時実行ファンクションの実行例
execute as @p at @s run function exploration:root
(2023/02/26):追加
(2023/03/05):番号を変更
▲動作の様子(billboard:fixed)
text_displayで作ったディスプレイと、それを利用したディスプレイシステムの一例。
billboard:fixとbillboard:centerの二つのモードで利用可能。
とりあえず視点算出とホバーイベントの実装のみ。
クリックイベントや演出の強化は実装予定。
二分探査でディスプレイ面とプレイヤーの視線との交点を探査し、ベクトルと回転行列の概念を用いて面上における視点の座標を計算する。軽量化を心がけてはいるけどやや重いかも。
ボタンの位置と座標を用いて各種イベントを実行できる。
display/内の3つのファンクションをデータパック内の好きな位置に置き、以下の手順で実行する。
- 初期設定 :
init.mcfunctionを実行してスコア等を設定。 - ディスプレイ設置 :
set_fixed.mcfunctionかset_center.mcfunctionを好きな位置と向きで実行するとその位置と向きで設置される。 - 常時実行 :
tick.mcfunctionを、ディスプレイの基準エンティティ(tag=display_00)を実行者として常時実行させる。
▼設置用ファンクションの実行例
function ****:****/display/initexecute positioned ~ ~1 ~ rotated ~45 ~10 run function ****:****/display/setexecute as @e[tag=display_00] if entity @p[distance=..10] run function ****:****/display/tick
(2023/02/21):追加
計算関連っぽいコマンドなどをまとめています。
▲動作の様子
花や竹などは1ブロック内のどの位置に設置されるかというのがx座標とz座標をもとにした疑似乱数によって決まっています。ソースコードを覗くとその計算式を見る事ができるので(intsucさんが見つけ出してくれました。感謝。twitter)、それをもとにマイクラ上で計算するfunction。複雑な計算ではないが排他的論理和の計算だけちょっと面倒かもしれない。
flower_positionフォルダをdata/直下などに入れ、初期設定:init.mcfunctionを実行したら常時実行:get.mcfunctionを調べたい座標で実行する。応用時は適時中を書き換えてもらった方がいい。
(2023/03/28):追加
(2023/03/30):コマンド数の削減
ブロックディスプレイ等で作れる装飾品の一例です。
▲イス1の写真
block_displayで作成した、コロコロ付きの丸椅子。
設置用ファンクションchair01_put.mcfunctionをデータパック内の好きな位置に置き、好きな位置と角度から実行すればその位置と角度で召喚される。原点は下面の**。
▼設置用ファンクションの実行例
execute positioned ~ ~ ~ rotated ~ 0 run function ****:****/chair01_put
(2023/02/21):追加
▲窓枠1の写真 (左が設置前/右が設置後)
block_displayで作成した、木でできた窓枠とその周辺。
設置用ファンクションwindow01_put.mcfunctionをデータパック内の好きな位置に置き、好きな位置と角度から実行すればその位置と角度で召喚される。原点は窓下面の**。
▼設置用ファンクションの実行例
execute positioned ~ ~1.5 ~3.5 rotated ~ 0 run function ****:****/window01_put
(2023/02/21):追加
コマンドを利用して作るデータパック
1.20.2で追加されたマクロを利用して作成した、エンティティ毎にストレージで好きなデータを保存できる個別ストレージ。リストに対して[$(index)]のようにアクセスしてデータをコピーしてくる方法で、データの量によってはコピーのコストが大きくなるため注意。
初期設定 :
09_examples/EntityStorageにあるEntityStorageをdatapacks直下に入れるか、EntityStorage/data/entity_storageフォルダを好きなデータパックのdata/直下に入れ、entity_storage:zzz/initを実行する。
登録 :
entity_storage:registを実行すると、実行者にidとしてスコアボードestS.idにidが与えられ、個別ストレージの方にもデータの格納先が準備される。
entity_storage:unregist {id:<id>}を実行すると該当idのデータを削除する。
データのコピー、変更 :
個別データはentity_storage: data[<id>]に格納され、以下のマクロに適切な変数を渡せばコピーやマージができる。
▼entity_storage:copy
$data modify $(type) $(target) $(path) set from storage entity_storage: data[$(id)].$(from)▼entity_storage:merge
$data modify storage entity_storage: data[$(id)].$(to) merge value ($(data))個別ストレージからデータを取り出したり変更したりするときに利用できる。
初期値として、該当エンティティの文字列uuid(str_uuid)と名前(score_name)が保存されている。(後者はガベージコレクタで利用する)
ガベージコレクタ :
scheduleコマンドにより一定時間の間隔でエンティティの存在をスコアを用いた方法で1体ずつ確認し、削除されていた場合はデータなどを消すという機能がある。entity_storage: gc_durationで走査tickの間隔を設定できる(デフォルトは2000tick,100秒)。1回につき1体分しか確認しないので割とゆっくり行われる。
▼ファンクションの実行例
# 個別データ/idの登録
execute as <entity> run function entity_storage:regist
# データのコピー
function entity_storage:copy {id:"0",type:"storage",target:"namespace:",path:"hoge",from:"fuga"}
# データのマージ
function entity_storage:merge {id:"0",to:"fuga",data:{a:1b,str:"hoge"}}
# ガベージコレクタの設定変更
data modify storage entity_storage: gc_duration set value 200(2023/09/16):誤字修正
(2023/09/15):シンプルな形に変更
(2023/09/14):ミス/誤字を修正
(2023/09/13):追加