1211-neoforge-modding

概要

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

✅ やるべきこと

1. DeferredRegister + DeferredHolder（または型付きAPI）を使う — DeferredRegister.createBlocks(MODID), DeferredRegister.createItems(MODID) などの型付きAPIが利用可能。
2. DataGen を使う — 手書きJSONはミスとメンテナンスコストが爆発する。
3. Parchmentでパラメータ名を補完 — neoForge { parchment { ... } } で設定。無効でも動作するが可読性が下がる。
4. すべてのDeferredRegisterをメインModクラスのコンストラクタで modBus にregisterする — コンストラクタ引数 IEventBus modEventBus を使う。
5. Block登録時はBlockItemも登録する — DeferredRegister.Items.registerSimpleBlockItem("name", BLOCK) で簡易化可能。
6. ResourceLocation.fromNamespaceAndPath(MODID, "path") を使う — new ResourceLocation(...) は非推奨。
7. level.isClientSide() で論理サイド判定 — メソッド呼び出し形式（1.21.1以降）。
8. Networkingのハンドラでは context.enqueueWork() でメインスレッドに戻す — ネットワークスレッドでワールド変更を行うとクラッシュ。
9. Capability取得は直接メソッド呼び出し — LazyOptional は廃止。level.getCapability(...) / entity.getCapability(...) で直接取得。
10. BlockEntityのデータ変更時は setChanged() + level.sendBlockUpdated() を呼ぶ — どちらか欠けると保存/同期されない。
11. Data ComponentsをItemStackのデータに使う — persistent(Codec) + networkSynchronized(StreamCodec) の両方を提供する。
12. Data AttachmentはBlockEntity/Entity/Chunk用 — ItemStackには使えない。ItemStackにはData Componentを使う。
13. sourceSets.main.resources { srcDir 'src/generated/resources' } を忘れない — DataGenの出力が読み込まれなくなる。
14. @EventBusSubscriber でbus自動検出 — bus の明示が不要になったが、特定バスに限定したい場合 bus = Bus.MOD または Bus.GAME を指定。

❌ やってはいけないこと

1. @OnlyIn をModコードで使わない — NeoForge内部専用。クライアント限定は @Mod(value = MODID, dist = Dist.CLIENT) または FMLClientSetupEvent で分離。
2. new ResourceLocation(...) を使わない — ResourceLocation.fromNamespaceAndPath() を使うこと。
3. CapabilityにLazyOptionalを使わない — 1.21.1では廃止。getCapability() は直接呼び出し。
4. Data AttachmentをItemStackに使わない — ItemStackにはData Componentを使う。
5. mods.toml ではなく neoforge.mods.toml — ファイル名を間違えるとModが認識されない。
6. ModDevGradleの dependencies {} に minecraft や neoforge を書かない — neoForge { version = ... } ブロックで解決される。
7. runClientクラッシュ後は ./gradlew --stop — Daemonがポートを占有していることがある。
8. Data Componentの Codec / StreamCodec を忘れない — ないとコンパイルエラーまたは実行時エラーになる。