1201-forge-modding

概要

このSkillは Minecraft 1.20.1 Forge 向けMod開発の標準パターンと落とし穴をまとめたものです。

✅ やるべきこと

1. DeferredRegister + RegistryObject を使う — 旧来の RegistryEvent ベースの登録は非推奨。
2. DataGen を使う — 手書きJSONはミスとメンテナンスコストが爆発する。
3. Mojang Mappings（official）が標準 — Parchmentでパラメータ名を補完する。
4. すべてのDeferredRegisterをModBusにregisterする — コンストラクタで IEventBus modEventBus = FMLJavaModLoadingContext.get().getModEventBus(); を取得し、各 register(modEventBus) を呼ぶ。
5. Block登録時はBlockItemも登録する — Blockだけではインベントリに出ない。
6. level.isClientSide で論理サイド判定 — 物理サイドではなく論理サイドで分岐。
7. Networkingのハンドラでは ctx.enqueueWork() でメインスレッドに戻す — ネットワークスレッドでワールド変更を行うとクラッシュ。
8. Capability取得時は LazyOptional を使う — isPresent() / ifPresent() で安全にアクセス。invalidateCaps() も必ず実装する。
9. BlockEntityのデータ変更時は setChanged() + level.sendBlockUpdated() を呼ぶ — どちらか欠けると保存/同期されない。
10. sourceSets.main.resources { srcDir 'src/generated/resources' } を忘れない — DataGenの出力が読み込まれなくなる。

❌ やってはいけないこと

1. @OnlyIn をModコードで使わない — Forge内部専用。使うとマルチプレイでクラッシュ。クライアント限定コードは @Mod.EventBusSubscriber(value = Dist.CLIENT) または FMLClientSetupEvent で分離する。
2. ResourceLocation に大文字・ハイフンを使わない — 小文字と _ / . / / のみ。
3. ContainerDataの各スロットは16bit — 32bit整数（エネルギー量など）は2スロットに分割すること。
4. PacketのID（int）を重複させない — SimpleChannelのregisterMessageでID衝突は通信破損。
5. Capabilityを通常のBlockに直接付けない — BlockEntityが必要。
6. runClientクラッシュ後は ./gradlew --stop — Daemonがポートを占有していることがある。

開発ワークフロー（新規Mod作成時）

• 1. Forge MDK（1.20.1）を入手し、Gradleプロジェクトとしてインポート
• 2. gradle.properties / build.gradle / mods.toml を確認・編集
• 3. メインModクラス（@Mod）と DeferredRegister + RegistryObject のセットアップ
• 4. Block/Item/Entity などの登録とプロパティ定義
• 5. Data Provider（Recipe, LootTable, BlockState, Tags）の実装
• 6. 必要に応じてNetworking（SimpleChannel）、Capability、WorldGenを追加
• 7. runClient / runData で動作確認

よく使うGradleタスク

./gradlew build              # 配布用jar生成
./gradlew runClient          # クライアント起動
./gradlew runServer          # サーバー起動
./gradlew runData            # DataGen実行
./gradlew runGameTestServer  # GameTest実行
./gradlew clean              # ビルドキャッシュ削除