|
この記事は"Minecraft Forge Universal 10.13.0.x～"及び"ComputerCraft 1.65～"を前提MODとしています。 |
リソースのマウント
Modのjarファイルやリソースパックに含まれるファイルやフォルダ（以下リソース）を、接続したComputerのファイルシステムにマウントさせる方法について解説します。
- IMountインスタンスの取得
- IMountインスタンスのマウント
- IMountインスタンスのアンマウント
IMountインスタンスの取得
リソースのマウントに必要なIMountインスタンスは ComputerCraftAPI.createResourceMount() で取得します。
// IMount ComputerCraftAPI.createResourceMount( Class modClass, String domain, String subPath ) IMount mountResource = ComputerCraftAPI.createResourceMount(SamplePeripheralCore.class, "sampleperipheralmod", "lua/rom/apis/sample");
引数でリソースの位置を指定します。実際にマウントできるリソースのパスは以下の両方です。
- modClassのjarファイル + "/assets/" + domain + "/" + subPath
- ゲームフォルダのresourcepacks内の各リソースパック + "/assets/" + domain + "/" + subPath
戻り値はリソースの取得に成功した場合はIMountインスタンスが、失敗した場合はnullが返ります。
ComputerCraft側の仕様上、createResourceMount()を呼び出すタイミングはMinecraftゲームサーバの起動（FMLServerStartedEvent発生）後となります。サーバが起動していないとき（例えばmodのコアクラスでFMLInitializationEventが発生した時点）に呼び出してもIMountインスタンスは取得できません。
取得したIMountインスタンスには、リソース内のファイルリストを取得したり、リソースファイルのInputStreamを取得したりすることのできるメソッドが含まれておりそれを利用することもできます。
Mod開発環境上のデバッグではjarファイルが生成されないため、jarに同梱するリソースをデバッグする場合には、Mod開発環境上のゲームフォルダ/resourcepacks内に代わりとなるリソースパックを作成してそちらを読み込ませるか、配布用と同じくjarファイルを生成して通常のプレイ環境上でデバッグします。
Computerへマウント
取得したIMountのインスタンスは IComputerAccess.mount() でComputerへマウントします。
// String IComputerAccess.mount( String desiredLocation, IMount mount )
String location = computer.mount("rom/apis/sample", mountResource);
desiredLocationにはリソースをマウントするComputerのファイルシステム内のパスを、mountにはComputerCraftAPI.createResourceMount()で取得したリソースのIMountインスタンスを渡します。
戻り値として、実際にマウントされたComputerファイルシステム内でのパスが返ります。これはリソースをアンマウントする時に必要なので、後ほどアンマウントするつもりなら保存しておきましょう。ひとつの周辺機器には複数のComputerが接続されるため、Map<IComputerAccess, String>などに保存しておくとよいでしょう。マウントに失敗した場合はnullが返ります。
Computerのrom/apisにLuaプログラムファイルをマウントすればAPIを追加することができますが、ON状態のComputerにマウントした場合はos.loadAPI()で登録するかComputerを再起動するまでは反映されません。
IPeripheral.attach()でmountすれば、接続された全てのComputerへマウントを試みることができます。ただし、desiredLocationに既にファイルやフォルダが存在した場合、マウントには失敗します。
Computerからアンマウント
ComputerへマウントしたリソースはIComputerAccess.unmount()でアンマウントできます。
// void IComputerAccess.unmount( String location ) computer.unmount(location);
locationにはそのComputerへmountしたときの戻り値を渡します。
IPeripheral.detach()でunmountすれば、取り外された全てのComputerへアンマウントを試みることができます。ただし、リソースをマウントした周辺機器がComputerから取り外されたとき、その周辺機器がマウントしたリソースはComputerCraftによって自動的にComputerからアンマウントされるようです。