Mobの作り方
Minecraft Modding会 in Kyoto

Ajenda
自己紹介
Mobとは
Mobの中身
実装例(人形MOD)
まとめ
Tips

自己紹介
名前：いわゆき(@iwa_yuki)
作ったもの
◦ アリスの人形MOD(AliceDollsMOD)
◦ 鉱石グモMOD(OreSpiderMOD)
◦ etc…
AliceDoll
s
http://forum.minecraftuser.jp/viewtopic.php?f=13&t=832

Mobとは
Minecraft内での生き物全般。
動物、モンスター、ボスなどが含まれる。
プレイヤーは含まない場合が多い。
動物
モンスター
タ
• ウシ
• ゾン
ゾ ビ
• ブタ
• スケル
スケ トン
• ニワ
ニ トリ
• クリーパー
• et
e c
t …
• et
e c.
t ..
ボス
その他
• エン
エ ダードラゴン
• アイア
イ ンゴーレム
• ウィザ
ィ ー
• スノーゴ
スノ
ーレム

Mobの中身
• 機能を記述する
Entity
•
Model
見た目を記述する
•
Render
描画方法を記述する
•
(EntityAI)
動作を記述する
En
E ti
t tyA
y Iを
I 使わないMo
M bもいる
「Mob
M
を
ob 作る
を
」
作る ために
ため は…
に

これ
こ らの
れ
ク
らの ラス
ク
(またはこ
または れ
こ らの
れ
クラ
らの
スを
クラ

継承し
継
たク
承し
ラ
たク ス
ラ )を継承
を
し
継承 て
し

作り
作 たいMob
M
のク
ob
ラ
のク スを
ラ
実装すれ
スを
ば
実装すれ よい
よ

実装例(人形MOD)
EntityAliceDoll.java
◦ EntityLivingを継承
◦ 右クリックでの動作モード変更
DataWatcherでサーバ・クライアント間を同期
NBTでセーブ・ロード
(参考：オオカミ)
◦ インベントリ
Iinventoryインターフェースを実装
(参考：チェスト付カート)
◦ チャンクローダー
ForgeChunkManager$LoadingCallbackインター
フェースを実装
(参考：ChickenBones氏のChickenChunks)

実装例(人形MOD)
ModelAliceDoll.java
◦ 人間型なのでModelBipedを継承
◦ 各人形のモデルデータは「Techne」で作成したもの
を使用する(←超便利)
◦ 一つのモデルで複数の人形に対応するため、インス
タンスごとに異なる形状を保持できるようにしている

実装例(人形MOD)
RenderAliceDoll.java
◦ 人間型なのでRenderBipedを継承
◦ 手持ちアイテム、頭にかぶれるアイテムの描画位置・
大きさを微調整(←すごく面倒)
◦ 防具は人間型Mobなら標準で対応しているので、
基本的にModelを差し替えるだけ
◦ 歩く、手を振るなどの挙動も標準で対応しているの
で、特に難しくはない

実装例(人形MOD)
EntityAI
◦ EntityAIBaseを継承
◦ 基本的な動作(ランダムに歩く、近くのプレイヤー
を見る、etc…)は既存AIを流用
◦ 人形独自の動作(Mob探知、鉱石採掘、アイテム
収集、etc…)は自作
◦ Mob作成において一番の鬼門となる
人形MOD作成にかかった工数の7割程度はAIのアル
ゴリズム検討と実装、動作検証。。。
逆に既存AIの流用や簡単なAIの追加で済むMobであ
れば、工数はほとんどかからない(ex.鉱石グモ)

まとめ
MobはMinecraftの生物全般を表す
MobはソースコードではEntity, Model,
Render,EntityAIを継承したクラスで記
述される
モデリングはTechneを使うと便利
独自機能が多いと実装は大変(特にAI)
だが、既存のMobに近ければ割と簡単
既存コード、先人の知恵を活用しよう

Tips：Entityの登録
Entityを登録するにはregisterGlobalEntityIDとregister
ModEntityを使う
Entityの登録はModのinitで行う
EntityRegistry.registerGlobalEntityID(
登録するMobのEntityクラス,
登録するMobの名前,
登録するMobのID);
EntityRegistry.registerModEntity(
登録するMobのEntityクラス,
登録するMobの名前,
登録するMobのID,
Mod自身のインスタンス,
描画される最大距離,
同期間隔,
速度を同期するかどうか);

Tips：Renderの登録
EntityとRenderを対応付けするためにはregisterEntityR
enderingHandlerを呼び出す
対応付けはModのinitで行う
ただしクライアント側のみでよいのでProxyを使用して処
理を振り分ける
RenderingRegistry.registerEntityRenderingHandler(
登録するMobのEntityクラス,
登録するMobのRenderのインスタンス);
CommonProxy
x .
Server
@SidedProxy(
regi
e ste
st r
e Ren
e der
e er
e s(
clientSide="ClientProxy",
)
serverSide="CommonProxy")
public static CommonProxy proxy;
Clien
e tProxy. .
registerRenderers(
proxy. registerRenderers();
registerRenderer
Client
)

Tips：AIの動作(1)
AIはsetMutexBitsで設定した値(mutexBits)によ
りAI同士が同時に動作可能か判定している
2つのAIのmutexBitsのANDを計算する
→結果が0の時は同時に動作可能
→結果が0以外の時は競合する
Entit
Ent yA
y IA
I r
A rowAt
A t
t ack
(mut
m exBit=3)
競合する
競合する
Enti
Ent ty
t A
y IW
I atc
t hClos
h
e
En
E tit
t yA
y IW
A
ander
st
s
同時
同 に動作可能
可
(mut
m exBit=1)
(mut
m exBit=2)

Tips：AIの動作(2)
AIを実行するかどうかはshouldExecute、AIを実行
し続けるかどうかはcontinueExecutingで指定する
AIの実行開始時にstartExecuting、終了時にreset
Task、それ以外は1TickごとにupdateTaskが呼ば
れる
startExecuting
updateTask
sholdExecute true
fals
e
resetTask
continueExecuting
fals
true
e

Tips：複数種類のMobを
一つのEntityで扱う
人形MODでは機能、AI、Modelの異なる人形を一
つのEntityで扱っている
Entityの各種パラメータ、AIの初期化、Modelの生
成・初期化など人形の種類ごとに異なる処理は人
形管理クラス(DollRegistory)で一元管理して、Ent
ity・Renderから適宜呼び出すことで実現
DollRegistory
En
E tity
t AliceD
ce oll
DollShan
ha ghai
gha
DollHo
H rai
a
Ren
e der
e AliceD
e o
DollRu
R ssia
et
e c…
ll

Tips：特定の条件にあうEntityを
抽出する
World.selectEntitiesWithinAABBを使うと、特
定条件にあうEntityを抽出できる
抽出する条件はIEntitySelectorインターフェー
スを実装したクラスのインスタンスを渡すことで
実現
World.selectEntitiesWithinAABB(
抽出したいEntityのクラス,
抽出範囲を表すAxisAlignedBBインスタンス
IEntitySelectorを実装したクラスのインスタンス);
public class CustomSelector implements IEntitySelector{
public boolean isEntityApplicable(Entity entity){
// 抽出対象ならtrueを返す
}
}