提供: Minecraft Modding Wiki
移動先: 案内検索
(間違っていたサンプルコードの修正、サンプルコードのちょっとした方針の変更)
(「様々なイベントを受け取る」節を追加)
51行目: 51行目:
  
 
* [https://github.com/MinecraftForge/MinecraftForge/blob/b15269fde504dbe8837a540202a0947c1a5b3e62/src/main/java/net/minecraftforge/fml/common/Mod.java#L278-L303 公式ドキュメント(2017/12/13時点)]
 
* [https://github.com/MinecraftForge/MinecraftForge/blob/b15269fde504dbe8837a540202a0947c1a5b3e62/src/main/java/net/minecraftforge/fml/common/Mod.java#L278-L303 公式ドキュメント(2017/12/13時点)]
 +
 +
== 様々なイベントを受け取る ==
 +
 +
@EventBusSubscriberアノテーションをクラスにつけると、@SubscribeEventアノテーションを'''static'''メソッドにつけることでイベントを受け取れます。
 +
 +
<source lang="java">
 +
package info.minecraftjp;
 +
 +
import net.minecraftforge.fml.common.Mod;
 +
import net.minecraftforge.fml.common.Mod.EventHandler;
 +
import net.minecraftforge.fml.common.Mod.EventBusSubscriber;
 +
import net.minecraftforge.fml.common.event.PreInitializationEvent;
 +
import net.minecraftforge.fml.common.event.InitializationEvent;
 +
import net.minecraftforge.fml.common.event.PostInitializationEvent;
 +
 +
@Mod(modid = "samplemod")
 +
@EventBusSubscriber
 +
public class Sample {
 +
    @EventHandler
 +
    public preInit(PreInitializationEvent event) {
 +
        // ...
 +
    }
 +
 +
    @EventHandler
 +
    public init(InitializationEvent event) {
 +
        // ...
 +
    }
 +
 +
    @EventHandler
 +
    public postInit(PostInitializationEvent event) {
 +
        // ...
 +
    }
 +
 +
    @SubscribeEvent
 +
    public static registerItem(RegistryEvent.Register<Item> event) {
 +
        // ...
 +
    }
 +
}
 +
</source>

2018年1月24日 (水) 20:41時点における版

ここではMODのメインクラスの作り方を解説します。

必要最低限のコード

MODのエントリポイントとなる@Modアノテーションが付いたクラスのみがある状態です。何の処理も行えないのですがMod一覧には表示されます。

package info.minecraftjp;

import net.minecraftforge.fml.common.Mod;

@Mod(modid = "samplemod")
public class Sample {}

初期化イベントを受け取る

@EventHandlerアノテーションをメソッドにつけると、MODが読み込まれる時にそのメソッドが呼ばれるためその中で様々な処理を行えます。ただし、その引数はある特定のイベントを表すクラス一つのみでなければなりません。

package info.minecraftjp;

import net.minecraftforge.fml.common.Mod;
import net.minecraftforge.fml.common.Mod.EventHandler;
import net.minecraftforge.fml.common.event.PreInitializationEvent;
import net.minecraftforge.fml.common.event.InitializationEvent;
import net.minecraftforge.fml.common.event.PostInitializationEvent;

@Mod(modid = "samplemod")
public class Sample {
    @EventHandler
    public preInit(PreInitializationEvent event) {
        // ...
    }

    @EventHandler
    public init(InitializationEvent event) {
        // ...
    }

    @EventHandler
    public postInit(PostInitializationEvent event) {
        // ...
    }
}

これが定番です。ただし、@EventHandlerアノテーションがついてさえいればメソッドの名前や引数の名前は自由で、「ある特定のイベントを表すクラス」というのもこれだけではありません。

様々なイベントを受け取る

@EventBusSubscriberアノテーションをクラスにつけると、@SubscribeEventアノテーションをstaticメソッドにつけることでイベントを受け取れます。

package info.minecraftjp;

import net.minecraftforge.fml.common.Mod;
import net.minecraftforge.fml.common.Mod.EventHandler;
import net.minecraftforge.fml.common.Mod.EventBusSubscriber;
import net.minecraftforge.fml.common.event.PreInitializationEvent;
import net.minecraftforge.fml.common.event.InitializationEvent;
import net.minecraftforge.fml.common.event.PostInitializationEvent;

@Mod(modid = "samplemod")
@EventBusSubscriber
public class Sample {
    @EventHandler
    public preInit(PreInitializationEvent event) {
        // ...
    }

    @EventHandler
    public init(InitializationEvent event) {
        // ...
    }

    @EventHandler
    public postInit(PostInitializationEvent event) {
        // ...
    }

    @SubscribeEvent
    public static registerItem(RegistryEvent.Register<Item> event) {
        // ...
    }
}