メインコンテンツまでスキップ

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_distance6飼い主がどれだけ離れたら、Mobが追いかけるか
follow_stop3どこまで近づくか
follow_speed1.2ついていく間の速度
chase_speed1.3戦う間の速度
reach2.2打撃を当てるために、どこまで近づくか
fuse_distance3クリーパーは、ターゲットからこの距離以内で導火線に火をつける
fuse_escape7ターゲットがこの距離まで離れる、または見えなくなると、クリーパーの導火線は消える
shoot_distance12射撃するMobは、ターゲットが見えている間、この距離以内から撃つ
attack_ticks20打撃や射撃の間隔
assisttrue飼い主が傷つけた相手とも戦う
defend_itselftrue自分を傷つけた相手とも戦う

hostile​

直近10秒間に自分を傷つけた相手、いなければrange以内にいる最も近いターゲットを攻撃します。新しいターゲットは10ティックごとに探します。飼い主がいれば、飼い主と、その飼い主に仕えるほかのMobは攻撃しません。

設定デフォルト内容
targetsplayerplayer、hostile、passive、living、またはzombieのようなエンティティタイプ
range16ターゲットにどこまで気づくか
damage0打撃が与えるダメージ。0はMob自身の攻撃に任せ、ニワトリのように攻撃を持たない種類では2になる
chase_speed、reach、fuse_distance、fuse_escape、shoot_distance、attack_ticksguardianと同じguardianと同じ

coward​

恐れるものがrange以内に入ると走り出し、それがsafe_distanceだけ離れると止まります。直近10秒間に自分を傷つけた相手からも、その攻撃者がrange以内にいる間(すでに走っている場合はsafe_distance以内にいる間)は逃げます。走るたびに、脅威から約10ブロック離れる経路を計画します。それだけの長さの逃げ道がない部屋や囲いの中では、奥の壁まで後ずさりします。

設定デフォルト内容
fearsplayerplayer、hostile、passive、living、またはwolfのようなエンティティタイプ
range10脅威がどこまで近づいたら走り出すか
safe_distance16どこまで離れたら走るのをやめるか
speed1.5走る間の速度
cornered_distance6逃げ道が見つからない場所で、どこまで後ずさろうとするか

wander​

radiusブロック以内の地点を選んでそこまで歩き、その後に休みます。ほかの同梱の行動は、どれもすぐにこの行動からMobを奪います。

設定デフォルト内容
radius8ぶらぶら歩きがどこまで行くか
speed1ぶらぶら歩く間の速度
rest_ticks60ぶらぶら歩いた後の休憩
rest_random_ticks120毎回の休憩に加えられる、0からこのティック数マイナス1までのランダムなティック数
walk_ticks200歩き終えられないぶらぶら歩きは、これだけ経つと終わる

Luaスクリプトから​

FreeMinecraftModelsが実行するすべてのLuaスクリプトで、Mobのエンティティテーブルにはメンバーが3つ追加されます。プレイヤーのテーブルにはありません。

メンバー戻り値説明
mob:override_ai(behaviors, options?)true、またはfalseと理由MobのAIを上書きします。behaviorsは1つの名前、または名前のリストです。すでに上書きされているMobでは、これが代わりに適用されます
mob:restore_ai()boolMobに自身のAIを返します。上書きされていた場合はtrue
mob.ai_overriddenboolMobが今、上書きを実行しているかどうか

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.memorymemoriesの名前に対するget(name)、set(name, value)、forget(name)、contains(name)。各Mobが自分のものを持ちます
c.tick現在のゲームティック。タイマー用
c.entityMobのエンティティテーブル。current_location、health、entity_typeなどを持ちます
c.perception、c.actuatorMagmaCoreの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を実行してください。