Mob行動
Mob行動は、FreeMinecraftModelsがスポーンしていないMob(自然にスポーンしたクリーパー、ニワトリ、襲撃で現れたピリジャーなど)のAIを乗っ取るLuaファイルです。上書きが続く間、そのMobはファイルの指示どおりに動きます。上書きが終わると、Mobは自身のAIを取り戻し、以前と同じように振る舞います。
プラグインには4つの行動が同梱されています。クリーパーはプレイヤーについていき、そのプレイヤーを攻撃した相手に自爆できます。ニワトリはプレイヤーに牙をむけます。ピリジャーは恐れて逃げ出せます。行動は、コマンドまたはLuaスクリプトからMobに付けられ、時間を指定するか、何かが解除するまで続きます。
Mob行動には、FreeMinecraftModels 2.15.0より後のリリースと、Minecraft 1.21.4以降が必要です。
上書きの内容
- Mob自身のゴールとBrainは止まるため、Mobは自分では何もしません。Mobを動かし、向きを変え、攻撃させるのは行動だけです。
- それ以外はすべて残ります。体力、装備、移動速度、名前は変わらず、日光で燃えるのも以前と同じです。
- プレイヤーが128ブロック以内にいなくなると、やはりデスポーンします。ただし、何かによってすでにデスポーンしないようになっていた場合は除きます。最寄りのプレイヤーから32〜128ブロック離れた場所に放置されたMobがしばらくしてランダムにデスポーンする仕組みは、上書き中は働きません。
- 種類ごとの動き方と戦い方はそのままです。クリーパーは膨らんで爆発し、スケルトンは矢を撃ち、ゾンビは殴ります。
- Mobは飼い主を持てます。プレイヤーでも、他の任意の生物エンティティでもかまいません。Mob自身の攻撃は飼い主にダメージを与えません。その打撃、放つ飛び道具、クリーパーの爆風はキャンセルされます。ポーション効果はキャンセルされず、行動が
c.overlay.ownerを通じて飼い主に対して行うこともキャンセルされません。 - 時間が尽きるか、何かが上書きを解除すると、Mobは自身のAIを取り戻します。ゾンビは再びプレイヤーを狩り、ニワトリはうろつきます。
- 上書きは、チャンクのアンロード、サーバーの再起動、
/fmm reloadをまたいでMobに残ります。時間指定のものは、Mobがアンロードされている間も数え続け、その間に時間が尽きていれば消えます。行動のメモリは、Mobが戻ってきたときには空から始まります。 - 上書きは、時間が尽きたとき、Mobが死んだとき、Mobが別のMobに変わったとき(村人がウィッチになる場合など)、または行動が
c.overlay:finish()を呼んだときに、自動的に終わります。
コマンド
すべて権限freeminecraftmodels.mobbehaviors.adminが必要で(オペレーターは持っています)、プレイヤー専用です。
| コマンド | 内容 |
|---|---|
/fmm mobbehavior apply <behaviors> [seconds] [radius] | 照準の先(最大32ブロック先)にいるMobのAIを、指定した行動で上書きし、自分をその飼い主にします。半径を指定すると、代わりに、自分から各軸でそのブロック数以内にいるすべてのMobが対象になります |
/fmm mobbehavior applywild <behaviors> [seconds] [radius] | 同じですが、飼い主はいません |
/fmm mobbehavior clear | 照準の先にいるMobに自身のAIを返します |
/fmm mobbehavior clear all | 読み込まれていて上書きされているすべてのMobに自身のAIを返します。アンロードされたチャンクにいるMobは上書きを保ち、読み込まれたときにそれを再開します |
/fmm mobbehavior list | 読み込まれた行動と、それぞれを実行しているMobの数を一覧表示します |
behaviorsは1つの名前、またはスペースなしでコンマ区切りにした複数の名前です(coward,wanderなど)。secondsは、上書きが続く時間です。省略するか0にすると、解除されるまで続きます。- Mobは飼い主を攻撃することも恐れることもありません。
hostileやcowardを自分自身で試すには、applywildを使ってください。 hostileとcowardは、クリエイティブやスペクテイターモードのプレイヤーを選びません。そのため、サバイバルでテストしてください。クリエイティブのプレイヤーがそのMobを殴った場合は、それでも10秒間は戦う、または逃げる対象になります。
/fmm mobbehavior apply guardian
/fmm mobbehavior applywild hostile 30
/fmm mobbehavior applywild coward,wander 0 12
1つ目は、見ているクリーパーに、あなたについてきて守らせます。2つ目は、ニワトリに30秒間あなたを攻撃させます。3つ目は、12ブロック以内のすべてのMobを、clear allを実行するまであなたから逃げさせます。
同梱の行動
| 名前 | Mobがすること |
|---|---|
guardian | 飼い主の近くにとどまり、飼い主を傷つけた相手、飼い主が傷つけた相手、自分を傷つけた相手と戦う |
hostile | 最も近いプレイヤー、またはtargets設定が指す相手を攻撃する |
coward | 最も近いプレイヤー、またはfears設定が指す相手から逃げる |
wander | ほかに何もMobを動かしていないときに、ぶらぶら歩く |
上書きされたMobは、AIの残りとともに自分のぶらぶら歩きも失っているため、wanderがなければ、ほかの行動がすることのない間は立ち止まっています。coward,wanderのように、リストにwanderを加えてください。リスト内の位置は関係ありません。Mobを動かす行動は、行動のpriorityが決めます。
射撃するMobは、ターゲットがreach以内にいるときは、射撃せずに近接攻撃で殴ります。
速度はMob自身の移動速度に掛かるため、1が通常の歩行です。距離の単位はブロック、時間の単位はティックです。
guardian
飼い主がfollow_distanceだけ離れるとついていき、飼い主からfollow_stopの距離で止まります。まず飼い主を攻撃した相手と戦い、次に自分を攻撃した相手、その次に飼い主のターゲットと戦います。それぞれ、攻撃を受けてから10秒間記憶されます。飼い主がいなければ、自分を守るだけです。
| 設定 | デフォルト | 内容 |
|---|---|---|
follow_distance | 6 | 飼い主がどれだけ離れたら、Mobが追いかけるか |
follow_stop | 3 | どこまで近づくか |
follow_speed | 1.2 | ついていく間の速度 |
chase_speed | 1.3 | 戦う間の速度 |
reach | 2.2 | 打撃を当てるために、どこまで近づくか |
fuse_distance | 3 | クリーパーは、ターゲットからこの距離以内で導火線に火をつける |
fuse_escape | 7 | ターゲットがこの距離まで離れる、または見えなくなると、クリーパーの導火線は消える |
shoot_distance | 12 | 射撃するMobは、ターゲットが見えている間、この距離以内から撃つ |
attack_ticks | 20 | 打撃や射撃の間隔 |
assist | true | 飼い主が傷つけた相手とも戦う |
defend_itself | true | 自分を傷つけた相手とも戦う |
hostile
直近10秒間に自分を傷つけた相手、いなければrange以内にいる最も近いターゲットを攻撃します。新しいターゲットは10ティックごとに探します。飼い主がいれば、飼い主と、その飼い主に仕えるほかのMobは攻撃しません。
| 設定 | デフォルト | 内容 |
|---|---|---|
targets | player | player、hostile、passive、living、またはzombieのようなエンティティタイプ |
range | 16 | ターゲットにどこまで気づくか |
damage | 0 | 打撃が与えるダメージ。0はMob自身の攻撃に任せ、ニワトリのように攻撃を持たない種類では2になる |
chase_speed、reach、fuse_distance、fuse_escape、shoot_distance、attack_ticks | guardianと同じ | guardianと同じ |
coward
恐れるものがrange以内に入ると走り出し、それがsafe_distanceだけ離れると止まります。直近10秒間に自分を傷つけた相手からも、その攻撃者がrange以内にいる間(すでに走っている場合はsafe_distance以内にいる間)は逃げます。走るたびに、脅威から約10ブロック離れる経路を計画します。それだけの長さの逃げ道がない部屋や囲いの中では、奥の壁まで後ずさりします。
| 設定 | デフォルト | 内容 |
|---|---|---|
fears | player | player、hostile、passive、living、またはwolfのようなエンティティタイプ |
range | 10 | 脅威がどこまで近づいたら走り出すか |
safe_distance | 16 | どこまで離れたら走るのをやめるか |
speed | 1.5 | 走る間の速度 |
cornered_distance | 6 | 逃げ道が見つからない場所で、どこまで後ずさろうとするか |
wander
radiusブロック以内の地点を選んでそこまで歩き、その後に休みます。ほかの同梱の行動は、どれもすぐにこの行動からMobを奪います。
| 設定 | デフォルト | 内容 |
|---|---|---|
radius | 8 | ぶらぶら歩きがどこまで行くか |
speed | 1 | ぶらぶら歩く間の速度 |
rest_ticks | 60 | ぶらぶら歩いた後の休憩 |
rest_random_ticks | 120 | 毎回の休憩に加えられる、0からこのティック数マイナス1までのランダムなティック数 |
walk_ticks | 200 | 歩き終えられないぶらぶら歩きは、これだけ経つと終わる |
Luaスクリプトから
FreeMinecraftModelsが実行するすべてのLuaスクリプトで、Mobのエンティティテーブルにはメンバーが3つ追加されます。プレイヤーのテーブルにはありません。
| メンバー | 戻り値 | 説明 |
|---|---|---|
mob:override_ai(behaviors, options?) | true、またはfalseと理由 | MobのAIを上書きします。behaviorsは1つの名前、または名前のリストです。すでに上書きされているMobでは、これが代わりに適用されます |
mob:restore_ai() | bool | Mobに自身のAIを返します。上書きされていた場合はtrue |
mob.ai_overridden | bool | Mobが今、上書きを実行しているかどうか |
optionsはテーブルで、どのキーも任意です。
| キー | 内容 |
|---|---|
owner | エンティティテーブル、またはUUID文字列。誰にも仕えないMobでは省略します |
duration | 上書きが続く時間(ティック)。省略すると、解除されるまで続きます |
settings | 行動名ごとの設定テーブルのテーブル。各行動のデフォルトに置き換わる値を持ちます |
local ok, why = mob:override_ai({ 'guardian', 'wander' }, {
owner = player,
duration = 600,
settings = { guardian = { chase_speed = 1.6, assist = false } }
})
override_aiは、行動名が読み込まれなかったとき、またはそのエンティティを上書きできないときに、理由とともにfalseを返します。空のリストや、エンティティテーブルでもUUIDでもないownerは、エラーを発生させます。行動にない設定や、型の誤った値はコンソールに報告され、デフォルトが残ります。
EliteMobsのスクリプトから
EliteMobs 10.9.14より後のリリースでは、FreeMinecraftModelsがインストールされていれば、ボスのパワーを含むEliteMobsのスクリプトでも、Mobのエンティティテーブルに同じ3つのメンバーがあります。行動を実行するのは引き続きFreeMinecraftModelsで、自身のmob_behaviorsフォルダーから読み込みます。
- エリート、ボス、EliteMobsのNPCはそこでは拒否され、
override_aiは理由とともにfalseを返します。ボスは周囲のMobを自分の護衛にできますが、ボス自身は上書きできません。 ownerにはボスを指定できます:owner = context.boss。- 上書きには
durationを指定してください。上書きは、それを始めたボスがいなくなっても続きます。 - FreeMinecraftModelsがない場合や、Mob行動より前のバージョンの場合、
override_aiは理由とともにfalseを返します。
mob:override_ai('guardian', { owner = context.boss, duration = 600 })
ほかのプラグインから
プラグインは、Javaではcom.magmaguy.freeminecraftmodels.api.MobBehaviorAPIを通じてMob行動を利用します。overrideAI(mob, behaviors, owner, durationTicks, settings)はnull、または拒否した理由を返します。restoreAI(mob)とisAIOverridden(entity)は真偽値を返し、behaviors()は読み込まれた名前の一覧を返します。どの引数もJavaかBukkitの単純な型なので、古いFreeMinecraftModelsに対してコンパイルされたプラグインでも、メソッドを名前で探して呼び出せます。サーバースレッドで呼び出してください。
対象のMob
- どのMobでも、スポーン元を問わず上書きできます。プレイヤーとアーマースタンドはできません。
- 経路に沿って歩くMob向けに作られています。ゾンビ、スケルトン、クリーパー、ピリジャー、ウシ、ニワトリなどです。これまでにテストしたのは、ハスク、クリーパー、ニワトリです。
- 経路に沿って歩かないMobは、上書き中にうまく動かない、またはまったく動かないことがあります。スライム、マグマキューブ、ガスト、ファントム、ウサギ、イカ、魚がこれに当たります。
- ペットや、
behaviorを持つEliteMobsのボスのように、すでに行動プログラムを実行しているほかのMobは、上書きできません。 - 行動プログラムを持たないEliteMobsのエリートは、FreeMinecraftModelsにとっては普通のMobであり、上書きを受けられますが、その組み合わせはまだテストしていません。
ファイル
- 行動は
plugins/FreeMinecraftModels/mob_behaviors/の中にあり、そのフォルダ、または任意のサブフォルダに置きます。そこにあるすべての.luaファイルが行動です。 - 行動の名前は、
.luaを除いたファイル名です。使えるのは、小文字の英字、数字、.、_、-だけです。 - その
idは、fmm:mob/に名前を続けたものでなければなりません。たとえばmob_behaviors/scared_of_cats.luaはid = 'fmm:mob/scared_of_cats'を宣言します。idが名前と一致しないファイルは、警告とともにスキップされます。 - 2つのファイルが同じ名前を持つ場合、パスの並び順で先に来るものが読み込まれ、コンソールはもう一方について警告します。
- FreeMinecraftModelsは、同梱の4つの行動を、
mob_behaviors/の直下にその名前のファイルがない場合に書き出します。削除したものは、次回の起動または/fmm reloadで戻ります。編集したファイルは上書きされません。サブフォルダに移動したものは、そのそばにデフォルトが戻り、パスの並び順で先に来るものだけが読み込まれます。 /fmm reloadはすべてのファイルを読み直します。実行中の上書きは停止し、新しいファイルで再び始まります。
行動を書く
行動ファイルは、idの接頭辞が異なるペット行動モジュールです。settings、memories、behaviors、sensorsを持つai.moduleです。共通のルールはEliteMobsの行動プログラムにあります。作りたいものに最も近い同梱ファイルから始め、新しい名前でコピーして、そのid、行動のid、メモリ名を新しい名前で始まるように変更してください。
この行動は、Mobをネコから逃げさせます。
-- Runs from the nearest cat within range.
return ai.module {
id = 'fmm:mob/scared_of_cats', revision = 1,
settings = { range = 8, speed = 1.4 },
behaviors = {
ai.behavior {
-- Asked and run every 5 ticks: each run plans a new way out.
id = 'fmm:mob/scared_of_cats', priority = 5, probe_interval = 5, tick_interval = 5,
controls = { ai.controls.move },
can_start = function(c)
return c.overlay:nearest(c.settings.range, 'cat') ~= nil
end,
tick = function(c)
local cat = c.overlay:nearest(c.settings.range, 'cat')
if cat ~= nil then c.actuator:flee(cat.current_location, c.settings.speed) end
end,
stop = function(c) c.actuator:stop_moving() end
}
}
}
priorityの数値が小さいほうが先に実行され、自身が列挙したコントロールを、数値が大きい実行中の行動から奪います。同梱の行動は、cowardとguardianの戦闘に5、hostileに10、guardianのついていく動作に20、wanderに40を使います。probe_intervalは、停止中の行動にcan_startを問い合わせる間隔で、ティックで指定します。tick_intervalは、実行中の行動がcan_continueとtickを実行する間隔です。どちらもデフォルトは1で、200を超える値は200として扱われます。- 1匹のMobの2つの行動は、行動id、センサーid、メモリ名を共有できません。
override_aiとコマンドは、そのような組み合わせを拒否し、理由を伝えます。
コールバックが受け取るもの
| 名前 | 内容 |
|---|---|
c.overlay | 上書きの中でのMobの立場。c.overlayを参照 |
c.settings | このMobに対するこの行動の設定。そのデフォルトの上に、上書きの値が重ねられたもの |
c.memory | memoriesの名前に対するget(name)、set(name, value)、forget(name)、contains(name)。各Mobが自分のものを持ちます |
c.tick | 現在のゲームティック。タイマー用 |
c.entity | Mobのエンティティテーブル。current_location、health、entity_typeなどを持ちます |
c.perception、c.actuator | MagmaCoreのMindコンテキスト。Mindプログラムのコンテキストを参照 |
c.overlay
4つのエンティティは、そのたびに読み取り直されるため、コールバックで2回以上使うときは、ローカル変数に保持してください。
| メンバー | 得られるもの、または行うこと |
|---|---|
c.overlay.owner | 飼い主がMobのワールドで生きている間は飼い主のエンティティテーブル、それ以外はnil |
c.overlay.owner_attacker | 直近10秒間に飼い主を傷つけた相手、またはnil |
c.overlay.owner_target | 直近10秒間に飼い主が傷つけた相手、またはnil |
c.overlay.attacker | 直近10秒間にこのMobを傷つけた相手、またはnil |
c.overlay:nearest(radius, kind?) | 半径以内にいる、ある種類の最も近い生物エンティティ、またはnil。kindはplayer、hostile(モンスター)、passive(動物)、living(デフォルト)、またはzombieやiron_golemのようなBukkit名のエンティティタイプです。村人とゴーレムは、hostileでもpassiveでもありません。半径は最大でも128ブロックまでです |
c.overlay:entity(uuid) | そのUUIDを持つ生物エンティティが、Mobのワールドで生きている間はそれ、それ以外はnil。ターゲットのUUIDをメモリに保持する行動向けです |
c.overlay.remaining | 上書きの残りティック数。終わりがない場合はnil |
c.overlay:finish() | このティックが終わった後に上書きを終わらせ、Mobに自身のAIを返します |
owner_attacker、owner_target、attacker、nearestは、Mobの飼い主や、同じ飼い主に仕えるほかのMobを決して返しません。nearestはさらに、クリエイティブとスペクテイターモードのプレイヤーとアーマースタンドも除きます。
移動と戦闘
仕事をするのは、これらのc.actuator呼び出しです。どれも、挙げたコントロールを行動が列挙している必要があります。
| 呼び出し | コントロール | 内容 |
|---|---|---|
c.actuator:move_to(location, speed) | move | 経路に沿ってそこまで歩く |
c.actuator:flee(location, speed) | move | その地点から約10ブロック離れる経路を計画して、たどる。Mobが逃げ道を見つけられない、または経路を計画できない場合はfalse。毎ティックではなく、数ティックごとに呼び出してください |
c.actuator:stop_moving() | move | 止まる |
c.actuator:look_at(location) | look | 次の2ティックの間、頭をそこへ向ける |
c.actuator:attack(target) | attack | その種類自身の打撃。Mobの攻撃ダメージを与える一振り、攻撃を持たない種類では2。クリーパーは代わりに膨らみ、呼び出しが毎ティック来る間膨らみ続け、完全に膨らむと爆発する。呼び出しのないティックが1つあると、しぼむ |
c.actuator:attack(target, damage) | attack | そのダメージを与える一振り |
c.actuator:shoot(target) | attack | その種類自身の射撃。スケルトンの矢、ピリジャーのクロスボウ、ウィッチのポーション、ラマのつば。射撃を持たない種類ではfalse |
flee、shoot、ダメージ付きのattackはMob行動で新しく加わったもので、ペット行動モジュールでも使えます。そこでは、fleeには経路を計画できるボディが、shootには射撃する種類のボディが必要です。
ルール
- アクチュエーターは、行動の
start、tick、stopからのみ、必要なコントロールを列挙した行動で呼び出してください。 - Mobごとの状態は、
memoriesの下で宣言したc.memoryに保持し、名前は行動の名前で始めてください。 - コールバックは短く保ってください。Mob行動は、ペット行動モジュールと同じ制限の下で実行され、1ティックあたりの10 msをそれらと共有します。
問題が起きたとき
以下のどの問題も、サーバーやほかのMobを止めることはありません。コンソールで、大文字小文字を無視してmob behaviorを検索してください。
- 行動が読み込まれない。 コンパイルできない、idがファイル名と一致しない、名前に他の文字が含まれるファイルは、ファイル名と理由を示す警告とともにスキップされます。ほかのすべてのファイルは引き続き読み込まれます。
- コマンドまたは
override_aiが拒否する。 理由を伝えます。読み込まれなかった行動名(読み込まれたものとともに)、または上書きできないエンティティです。 - Mobが立ち止まっている。 行動がすることのない状態です。
wanderを加えるか、サバイバルにいること、そしてそのMobの飼い主ではないことを確認してください。 - Mobの実行中にコールバックが失敗する。 コールバックと失敗の種類ごとに、次のリロードまで1回だけログに出力されます。行動は停止される、または開始されず、次の
probe_intervalの確認で再び問い合わせられます。 - Mobが上書きを再開できなかった。 チャンクが読み込まれたときに、その行動の1つがもう存在しない場合、コンソールがそれを伝え、Mobは自身のAIを保ちます。ファイルが戻って
/fmm reloadが実行されると、上書きは戻ります。読み込まれているMobではただちに、それ以外のMobでは読み込まれたときに戻ります。
修正後は、/fmm reloadを実行してください。