アドオン制作

連載 アドオン制作入門 第1回

①環境構築(com.mojang の場所・フォルダ構成・テキストエディタ)

統合版アドオン開発を始める前に、com.mojang フォルダの場所とフォルダ構成、開発に使うテキストエディタを整理しておきます。

自作アドオンの作り方解説シリーズの1本目です。実際に何かを作り始める前に、Minecraft がアドオンを読み込む場所と、開発の下準備を整理しておきます。ここを雑にやると後で「ファイルを直したのに反映されない」で詰まるので、最初にちゃんと押さえておきます。

com.mojang の場所

Windows 版の統合版だと、com.mojang フォルダはこの下にあります。

%appdata%\Minecraft Bedrock\Users\Shared\games\com.mojang

エクスプローラーのアドレスバーに直接貼り付ければ一発で開けます。AppData は隠しフォルダなので、普通にフォルダをたどっていくと見つからないことがありますが、アドレスバー入力なら関係ありません。

古い解説記事だと %localappdata%\Packages\Microsoft.MinecraftUWP_8wekyb3d8bbwe\LocalState\games\com.mojang と書かれていることがあります。これは Windows 版の作りが変わる前の場所で、今のバージョンではデータが上の場所に移っています。古いフォルダにパックを置いても読み込まれないので注意してください。

Preview 版(ベータ版)を使っている場合はフォルダ名が違うので、こっちを使います。

%appdata%\Minecraft Bedrock Preview\Users\Shared\games\com.mojang

正式版と Preview 版で com.mojang は別物として扱われる点に注意です。Preview で動作確認したアドオンを正式版で試すときは、フォルダを移すかコピーする必要があります。

フォルダ構成

com.mojang の中には、開発用と実行用でフォルダが分かれています。

  • development_behavior_packs / development_resource_packs — 開発中のパックを置く場所。ここに置いたフォルダは .mcaddon に固めなくてもそのまま Minecraft に認識されます
  • behavior_packs / resource_packs — ワールドに配布されたパックが展開される場所。基本的に手で触りません
  • minecraftWorlds — ワールドのセーブデータ

開発中は development_behavior_packs と development_resource_packs の2つだけ意識していれば十分です。ここにフォルダを作って、中に manifest.json を置くところから始まります。

テキストエディタ

JSON をたくさん書くことになるので、構文チェックが効くエディタを使うのが前提になります。おすすめは VS Code です。標準機能だけでも JSON のカッコ・カンマの対応チェックはしてくれますし、拡張機能を入れれば Minecraft のスキーマに沿った補完も効くようになります。

Minecraft アドオン専用のツールが欲しくなったら bridge. というエディタもあります。UUID の自動生成やテンプレートからのファイル作成など、アドオン開発に特化した機能がまとまっているので、慣れてきたら触ってみるのもありです。ただ最初のうちは VS Code で仕組みを理解しながら進めた方が、後々つまずいた時に自分で原因を追いやすいです。

開発フォルダをリポジトリの外に置く

development_behavior_packs の中身を直接 Git で管理してもいいのですが、VS Code で Unity の補完が効かない時に見る所でも書いた通り、OneDrive 配下や日本語・スペースを含むパスはツールチェーンと相性が悪いことがあります。com.mojang は特に深い階層にあるので、自分は別の場所に Git 管理用のフォルダを作り、そこから development_behavior_packs 側にジャンクション(シンボリックリンクの一種)を張って使っています。

PowerShell を開き、com.mojang フォルダに移動してから次を実行します。

New-Item -ItemType Junction -Path "development_behavior_packs\AokiAddon" -Target "D:\dev\aoki-addon\behavior_pack"

(コマンドプロンプトなら mklink /J "development_behavior_packs\AokiAddon" "D:\dev\aoki-addon\behavior_pack" でも同じです。mklink は PowerShell では直接使えません。)

こうしておくと、普段の開発は D:\dev\aoki-addon 側で完結させつつ、Minecraft からは com.mojang の中にあるように見える状態を作れます。管理者権限も不要です。

まとめ

  • com.mojang は %appdata%\Minecraft Bedrock\Users\Shared\games\com.mojang
  • 開発中は development_behavior_packs / development_resource_packs を使う
  • エディタは VS Code。慣れたら bridge. も選択肢
  • 開発フォルダは Git 管理しやすい場所に置いて、ジャンクションで繋ぐと安全

次は実際に manifest.json を書いて、Minecraft に「何もしないアドオン」を認識させるところまでやります。