[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M74FHR5V3J0HZS7DM65TKYGD":3,"skill-same:01M74FHR5V3J0HZS7DM65TKYGD":66},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":6,"ownerDescription":30,"updatedAt":31,"install":32,"resources":45},"01M74FHR5V3J0HZS7DM65TKYGD","minecraft-modding",null,"Full-stack Minecraft mod development skill for both NeoForge (1.21+) and Fabric (1.21+). Scaffolds new mods, adds custom blocks, items, entities, recipes, commands, GUIs, dimensions, and data generation. Knows the NeoForge DeferredRegister + event-bus system and the Fabric Registry + ModInitializer system. Use when the user asks to create a Minecraft mod, add a feature to an existing mod, fix a mod bug, generate JSON assets\u002Fdata, or migrate between modding platforms. Prefer NeoForge unless the user specifies Fabric or Multiloader.","AIKUSAN\u002Fminecraft-agent-skills-bundle","AIKUSAN","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F54048610?v=4","01M74FG91YZ75JDYZ7PNHER2NJ","Lorenz Tazan","01M74FG931PS45HBP26RKEZQDT",12,"MIT","https:\u002F\u002Fgithub.com\u002FAIKUSAN\u002Fminecraft-agent-skills-bundle\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fminecraft-modding\u002FSKILL.md",[],[],"2026-11-11 15:11:14",false,"---\nname: minecraft-modding\ndescription: \"Full-stack Minecraft mod development skill for both NeoForge (1.21+) and Fabric (1.21+). Scaffolds new mods, adds custom blocks, items, entities, recipes, commands, GUIs, dimensions, and data generation. Knows the NeoForge DeferredRegister + event-bus system and the Fabric Registry + ModInitializer system. Use when the user asks to create a Minecraft mod, add a feature to an existing mod, fix a mod bug, generate JSON assets\u002Fdata, or migrate between modding platforms. Prefer NeoForge unless the user specifies Fabric or Multiloader.\"\n---\n\n# Minecraft Modding Skill\n\n## Overview\n\nThis skill guides Codex through developing open-source Minecraft mods.\nTarget platforms:\n\n| Platform | MC Version | Java | Build System |\n|---|---|---|---|\n| **NeoForge** | 1.21.x with 1.21.11 examples | Java 21 | Gradle + ModDevGradle |\n| **Fabric** | 1.21.x with 1.21.11 examples | Java 21 | Gradle + Fabric Loom |\n| **Architectury** (multiloader) | 1.21.x | Java 21 | Gradle + Architectury Loom |\n\nAlways confirm the platform and Minecraft version from `gradle.properties` or `build.gradle`\nbefore writing any mod-specific code.\n\n### Routing Boundaries\n- `Use when`: the task is Java\u002FKotlin mod code, registry\u002Fevent work, networking, datagen wiring, and loader APIs.\n- `Do not use when`: the task is command-only vanilla logic (`minecraft-commands-scripting`) or pure datapacks (`minecraft-datapack`).\n- `Do not use when`: the task targets Paper\u002FBukkit plugins (`minecraft-plugin-dev`).\n- `Do not use when`: one codebase must ship on both NeoForge and Fabric (`minecraft-multiloader`).\n\n---\n\n## 1. Identifying the Platform\n\n```bash\n# NeoForge project signature\ngrep -r \"net.neoforged\" gradle.properties build.gradle settings.gradle 2>\u002Fdev\u002Fnull | head -5\n\n# Fabric project signature\ngrep -r \"fabric\" gradle.properties build.gradle settings.gradle 2>\u002Fdev\u002Fnull | head -5\n\n# Read mod ID and version\ncat gradle.properties\n```\n\nKey files per platform:\n\n- **NeoForge**: `src\u002Fmain\u002Fresources\u002FMETA-INF\u002Fneoforge.mods.toml`, annotated `@Mod` main class\n- **Fabric**: `src\u002Fmain\u002Fresources\u002Ffabric.mod.json`, class implementing `ModInitializer`\n- **Architectury**: `common\u002F`, `fabric\u002F`, `neoforge\u002F` subprojects\n\n---\n\n## 2. Build & Test Commands\n\n```bash\n# Build the mod jar\n.\u002Fgradlew build\n\n# Run the Minecraft client to test\n.\u002Fgradlew runClient\n\n# Run a dedicated server to test\n.\u002Fgradlew runServer\n\n# Run game tests (NeoForge JUnit-style game tests)\n.\u002Fgradlew runGameTestServer\n\n# Run data generation (generates JSON assets automatically)\n.\u002Fgradlew runData\n\n# Clean build cache\n.\u002Fgradlew clean\n\n# Check for dependency updates (optional)\n.\u002Fgradlew dependencyUpdates\n```\n\nAfter `.\u002Fgradlew build`, the mod jar is at:\n`build\u002Flibs\u002F\u003Cmod_id>-\u003Cversion>.jar`\n\n---\n\n## 3. Project Layout (NeoForge)\n\n```\nsrc\u002F\n  main\u002F\n    java\u002F\u003CgroupId>\u002F\u003Cmodid>\u002F\n      MyMod.java               ← @Mod entry point\n      block\u002F\n        ModBlocks.java         ← DeferredRegister\u003CBlock>\n        MyCustomBlock.java\n      item\u002F\n        ModItems.java          ← DeferredRegister\u003CItem>\n      entity\u002F\n        ModEntities.java       ← DeferredRegister\u003CEntityType\u003C?>>\n      menu\u002F                    ← custom GUI containers\n      recipe\u002F\n      worldgen\u002F\n      datagen\u002F\n        ModDataGen.java        ← GatherDataEvent handler\n        providers\u002F\n    resources\u002F\n      META-INF\u002F\n        neoforge.mods.toml     ← mod metadata (renamed from mods.toml in NeoForge 1.20.5+)\n      assets\u002F\u003Cmodid>\u002F\n        blockstates\u002F           ← JSON blockstate definitions\n        models\u002F\n          block\u002F               ← block model JSON\n          item\u002F                ← item model JSON\n        textures\u002F\n          block\u002F               ← 16×16 PNG textures\n          item\u002F\n        lang\u002F\n          en_us.json           ← translation strings\n      data\u002F\u003Cmodid>\u002F\n        recipes\u002F               ← crafting recipe JSON\n        loot_table\u002F\n          blocks\u002F              ← per-block loot table JSON\n        tags\u002F\n          blocks\u002F\n          items\u002F\n```\n\n## 4. Project Layout (Fabric)\n\n```\nsrc\u002F\n  main\u002F\n    java\u002F\u003CgroupId>\u002F\u003Cmodid>\u002F\n      MyMod.java               ← implements ModInitializer\n      client\u002F\n        MyModClient.java       ← implements ClientModInitializer\n      block\u002F\n      item\u002F\n      mixin\u002F                   ← Mixin classes\n    resources\u002F\n      fabric.mod.json\n      assets\u002F\u003Cmodid>\u002F          ← same as NeoForge\n      data\u002F\u003Cmodid>\u002F            ← same as NeoForge\n      \u003Cmodid>.mixins.json      ← mixin configuration\n```\n\n---\n\n## 5. Core Concepts Cheatsheet\n\n### Sides\n- **Physical client** – the game client JAR (has rendering code)\n- **Physical server** – the dedicated server JAR (no rendering)\n- **Logical client** – the client thread (handles rendering, input)\n- **Logical server** – the server thread (handles world simulation)\n- Code decorated with `@OnlyIn(Dist.CLIENT)` (NeoForge) or `@Environment(EnvType.CLIENT)` (Fabric)\n  must NEVER run on the server.\n\n### Registries\nEverything in Minecraft lives in a registry. Always register objects; never\nconstruct them at field initializer time outside a registry call.\n\n- Blocks → `Registry.BLOCK`\n- Items → `Registry.ITEM`\n- Entity types → `Registry.ENTITY_TYPE`\n- Block entity types → `Registry.BLOCK_ENTITY_TYPE`\n- Menu types → `Registry.MENU` (NeoForge) \u002F `Registry.MENU_TYPE` (Fabric)\n- Sound events → `Registry.SOUND_EVENT`\n- Biomes → `Registry.BIOME`\n\n### ResourceLocation \u002F Identifier\nEvery registry entry needs a namespaced ID:\n```java\n\u002F\u002F NeoForge \u002F vanilla Java\nResourceLocation id = ResourceLocation.fromNamespaceAndPath(\"mymod\", \"my_block\");\n\n\u002F\u002F Fabric (same class, same API in 1.21)\nIdentifier id = Identifier.of(\"mymod\", \"my_block\");\n```\n\n---\n\n## 6. NeoForge Quick Patterns\n\nSee full patterns in `references\u002Fneoforge-api.md`.\n\n```java\n\u002F\u002F Main mod class\n@Mod(MyMod.MOD_ID)\npublic class MyMod {\n    public static final String MOD_ID = \"mymod\";\n\n    public MyMod(IEventBus modEventBus) {\n        ModBlocks.BLOCKS.register(modEventBus);\n        ModItems.ITEMS.register(modEventBus);\n        modEventBus.addListener(this::commonSetup);\n    }\n\n    private void commonSetup(FMLCommonSetupEvent event) {\n        \u002F\u002F runs after all mods are registered\n    }\n}\n```\n\n```java\n\u002F\u002F Block registration\npublic class ModBlocks {\n    public static final DeferredRegister\u003CBlock> BLOCKS =\n        DeferredRegister.create(BuiltInRegistries.BLOCK, MyMod.MOD_ID);\n\n    public static final DeferredBlock\u003CBlock> MY_BLOCK =\n        BLOCKS.registerSimpleBlock(\"my_block\",\n            BlockBehaviour.Properties.of()\n                .mapColor(MapColor.STONE)\n                .strength(1.5f, 6.0f)\n                .sound(SoundType.STONE)\n                .requiresCorrectToolForDrops());\n}\n```\n\n---\n\n## 7. Fabric Quick Patterns\n\nSee full patterns in `references\u002Ffabric-api.md`.\n\n```java\n\u002F\u002F Main mod class\npublic class MyMod implements ModInitializer {\n    public static final String MOD_ID = \"mymod\";\n    public static final Logger LOGGER = LoggerFactory.getLogger(MOD_ID);\n\n    @Override\n    public void onInitialize() {\n        ModBlocks.register();\n        ModItems.register();\n    }\n}\n```\n\n```java\n\u002F\u002F Block registration\npublic class ModBlocks {\n    public static final Block MY_BLOCK = new Block(\n        AbstractBlock.Settings.create()\n            .mapColor(MapColor.STONE)\n            .strength(1.5f, 6.0f)\n            .sounds(BlockSoundGroup.STONE)\n            .requiresTool()\n    );\n\n    public static void register() {\n        Registry.register(Registries.BLOCK,\n            Identifier.of(MyMod.MOD_ID, \"my_block\"), MY_BLOCK);\n    }\n}\n```\n\n---\n\n## 8. JSON Asset Templates\n\nAlways provide matching JSON assets for every registered block\u002Fitem.\nCodex should generate or update these files alongside Java code.\n\nSee `references\u002Fcommon-patterns.md` for full JSON templates for:\n- Blockstate JSON\n- Block model JSON (cube, slab, stairs, fence, door, trapdoor, etc.)\n- Item model JSON\n- Loot table JSON\n- Recipe JSON (crafting_shaped, crafting_shapeless, smelting, blasting, stonecutting)\n- Language file (`en_us.json`) entries\n- Tag JSON\n\n---\n\n## 9. Data Generation\n\nPrefer data generation over hand-authored JSON for maintainability.\n\n```java\n\u002F\u002F NeoForge – register data gen providers in GatherDataEvent\n@SubscribeEvent\npublic static void gatherData(GatherDataEvent event) {\n    DataGenerator gen = event.getGenerator();\n    PackOutput output = gen.getPackOutput();\n    ExistingFileHelper helper = event.getExistingFileHelper();\n    CompletableFuture\u003CHolderLookup.Provider> lookupProvider = event.getLookupProvider();\n\n    gen.addProvider(event.includeClient(), new ModBlockStateProvider(output, helper));\n    gen.addProvider(event.includeClient(), new ModItemModelProvider(output, helper));\n    gen.addProvider(event.includeServer(), new ModRecipeProvider(output, lookupProvider));\n    gen.addProvider(event.includeServer(), new ModLootTableProvider(output, lookupProvider));\n    gen.addProvider(event.includeServer(), new ModBlockTagsProvider(output, lookupProvider, helper));\n}\n```\n\nRun data generation with `.\u002Fgradlew runData`, then commit the generated files.\n\n---\n\n## 10. Common Tasks Checklist\n\nWhen adding a **new block**:\n- [ ] `Block` subclass (or use vanilla Block with properties)\n- [ ] Register in `ModBlocks.BLOCKS` \u002F `Registries.BLOCK`\n- [ ] Register `BlockItem` in `ModItems.ITEMS` \u002F `Registries.ITEM`\n- [ ] Blockstate JSON → `assets\u002F\u003Cmodid>\u002Fblockstates\u002F\u003Cname>.json`\n- [ ] Block model JSON → `assets\u002F\u003Cmodid>\u002Fmodels\u002Fblock\u002F\u003Cname>.json`\n- [ ] Item model JSON → `assets\u002F\u003Cmodid>\u002Fmodels\u002Fitem\u002F\u003Cname>.json` (or inherits from block)\n- [ ] Texture PNG → `assets\u002F\u003Cmodid>\u002Ftextures\u002Fblock\u002F\u003Cname>.png`\n- [ ] Loot table JSON → `data\u002F\u003Cmodid>\u002Floot_table\u002Fblocks\u002F\u003Cname>.json`\n- [ ] Language entry in `en_us.json`\n- [ ] Mine-with-correct-tool tag if hardness > 0\n\nWhen adding a **new item**:\n- [ ] `Item` subclass (or use `new Item(properties)`)\n- [ ] Register in `ModItems` \u002F `Registries.ITEM`\n- [ ] Item model JSON\n- [ ] Texture PNG\n- [ ] Language entry\n- [ ] Creative tab registration (NeoForge: `BuildCreativeModeTabContentsEvent`; Fabric: `ItemGroupEvents`)\n- [ ] Recipe JSON if craftable\n\nWhen adding a **new entity**:\n- [ ] Entity class (extends appropriate base: `Mob`, `Animal`, `TamableAnimal`, etc.)\n- [ ] `EntityType` registration\n- [ ] Renderer class (`@OnlyIn(Dist.CLIENT)`)\n- [ ] Model class (`@OnlyIn(Dist.CLIENT)`)\n- [ ] Register renderer in `EntityRenderersEvent.RegisterRenderers` (NeoForge) or\n      `EntityModelLayerRegistry` (Fabric)\n- [ ] Spawn egg item (optional)\n- [ ] Spawn rules \u002F biome modifier\n\n---\n\n## 11. Open-Source Conventions\n\n- **License**: MIT or LGPL-3.0 — include `LICENSE` file and `SPDX-License-Identifier` header\n- **Versioning**: `{mod_version}+{mc_version}` (e.g., `2.0.0+1.21.11`)\n- **Changelog**: Keep `CHANGELOG.md` up to date with semver notes\n- **Publishing**: Use `gradle-modrinth` or `curseforgegradle` plugins for CurseForge \u002F Modrinth\n- **CI**: GitHub Actions with `.\u002Fgradlew build` and `.\u002Fgradlew runGameTestServer`\n- **PR conventions**: Keep PRs scoped to a single feature; include asset files with Java changes\n\n---\n\n## 12. References\n\n- NeoForge API patterns and event system: `.\u002Freferences\u002Fneoforge-api.md`\n- Fabric API patterns and mixin guide: `.\u002Freferences\u002Ffabric-api.md`\n- Blocks, items, recipes, commands, GUIs, datagen: `.\u002Freferences\u002Fcommon-patterns.md`\n- NeoForge official docs: https:\u002F\u002Fdocs.neoforged.net\u002F\n- Fabric developer docs: https:\u002F\u002Fdocs.fabricmc.net\u002Fdevelop\u002F\n- Architectury (multiloader): https:\u002F\u002Fdocs.architectury.dev\u002F\n- Minecraft Wiki (data formats): https:\u002F\u002Fminecraft.wiki\u002Fw\u002FJava_Edition_data_values\n","# Minecraft Modding Skill\n\n## Overview\n\nThis skill guides Codex through developing open-source Minecraft mods.\nTarget platforms:\n\n| Platform | MC Version | Java | Build System |\n|---|---|---|---|\n| **NeoForge** | 1.21.x with 1.21.11 examples | Java 21 | Gradle + ModDevGradle |\n| **Fabric** | 1.21.x with 1.21.11 examples | Java 21 | Gradle + Fabric Loom |\n| **Architectury** (multiloader) | 1.21.x | Java 21 | Gradle + Architectury Loom |\n\nAlways confirm the platform and Minecraft version from `gradle.properties` or `build.gradle`\nbefore writing any mod-specific code.\n\n### Routing Boundaries\n- `Use when`: the task is Java\u002FKotlin mod code, registry\u002Fevent work, networking, datagen wiring, and loader APIs.\n- `Do not use when`: the task is command-only vanilla logic (`minecraft-commands-scripting`) or pure datapacks (`minecraft-datapack`).\n- `Do not use when`: the task targets Paper\u002FBukkit plugins (`minecraft-plugin-dev`).\n- `Do not use when`: one codebase must ship on both NeoForge and Fabric (`minecraft-multiloader`).\n\n---\n\n## 1. Identifying the Platform\n\n```bash\n# NeoForge project signature\ngrep -r \"net.neoforged\" gradle.properties build.gradle settings.gradle 2>\u002Fdev\u002Fnull | head -5\n\n# Fabric project signature\ngrep -r \"fabric\" gradle.properties build.gradle settings.gradle 2>\u002Fdev\u002Fnull | head -5\n\n# Read mod ID and version\ncat gradle.properties\n```\n\nKey files per platform:\n\n- **NeoForge**: `src\u002Fmain\u002Fresources\u002FMETA-INF\u002Fneoforge.mods.toml`, annotated `@Mod` main class\n- **Fabric**: `src\u002Fmain\u002Fresources\u002Ffabric.mod.json`, class implementing `ModInitializer`\n- **Architectury**: `common\u002F`, `fabric\u002F`, `neoforge\u002F` subprojects\n\n---\n\n## 2. Build & Test Commands\n\n```bash\n# Build the mod jar\n.\u002Fgradlew build\n\n# Run the Minecraft client to test\n.\u002Fgradlew runClient\n\n# Run a dedicated server to test\n.\u002Fgradlew runServer\n\n# Run game tests (NeoForge JUnit-style game tests)\n.\u002Fgradlew runGameTestServer\n\n# Run data generation (generates JSON assets automatically)\n.\u002Fgradlew runData\n\n# Clean build cache\n.\u002Fgradlew clean\n\n# Check for dependency updates (optional)\n.\u002Fgradlew dependencyUpdates\n```\n\nAfter `.\u002Fgradlew build`, the mod jar is at:\n`build\u002Flibs\u002F\u003Cmod_id>-\u003Cversion>.jar`\n\n---\n\n## 3. Project Layout (NeoForge)\n\n```\nsrc\u002F\n  main\u002F\n    java\u002F\u003CgroupId>\u002F\u003Cmodid>\u002F\n      MyMod.java               ← @Mod entry point\n      block\u002F\n        ModBlocks.java         ← DeferredRegister\u003CBlock>\n        MyCustomBlock.java\n      item\u002F\n        ModItems.java          ← DeferredRegister\u003CItem>\n      entity\u002F\n        ModEntities.java       ← DeferredRegister\u003CEntityType\u003C?>>\n      menu\u002F                    ← custom GUI containers\n      recipe\u002F\n      worldgen\u002F\n      datagen\u002F\n        ModDataGen.java        ← GatherDataEvent handler\n        providers\u002F\n    resources\u002F\n      META-INF\u002F\n        neoforge.mods.toml     ← mod metadata (renamed from mods.toml in NeoForge 1.20.5+)\n      assets\u002F\u003Cmodid>\u002F\n        blockstates\u002F           ← JSON blockstate definitions\n        models\u002F\n          block\u002F               ← block model JSON\n          item\u002F                ← item model JSON\n        textures\u002F\n          block\u002F               ← 16×16 PNG textures\n          item\u002F\n        lang\u002F\n          en_us.json           ← translation strings\n      data\u002F\u003Cmodid>\u002F\n        recipes\u002F               ← crafting recipe JSON\n        loot_table\u002F\n          blocks\u002F              ← per-block loot table JSON\n        tags\u002F\n          blocks\u002F\n          items\u002F\n```\n\n## 4. Project Layout (Fabric)\n\n```\nsrc\u002F\n  main\u002F\n    java\u002F\u003CgroupId>\u002F\u003Cmodid>\u002F\n      MyMod.java               ← implements ModInitializer\n      client\u002F\n        MyModClient.java       ← implements ClientModInitializer\n      block\u002F\n      item\u002F\n      mixin\u002F                   ← Mixin classes\n    resources\u002F\n      fabric.mod.json\n      assets\u002F\u003Cmodid>\u002F          ← same as NeoForge\n      data\u002F\u003Cmodid>\u002F            ← same as NeoForge\n      \u003Cmodid>.mixins.json      ← mixin configuration\n```\n\n---\n\n## 5. Core Concepts Cheatsheet\n\n### Sides\n- **Physical client** – the game client JAR (has rendering code)\n- **Physical server** – the dedicated server JAR (no rendering)\n- **Logical client** – the client thread (handles rendering, input)\n- **Logical server** – the server thread (handles world simulation)\n- Code decorated with `@OnlyIn(Dist.CLIENT)` (NeoForge) or `@Environment(EnvType.CLIENT)` (Fabric)\n  must NEVER run on the server.\n\n### Registries\nEverything in Minecraft lives in a registry. Always register objects; never\nconstruct them at field initializer time outside a registry call.\n\n- Blocks → `Registry.BLOCK`\n- Items → `Registry.ITEM`\n- Entity types → `Registry.ENTITY_TYPE`\n- Block entity types → `Registry.BLOCK_ENTITY_TYPE`\n- Menu types → `Registry.MENU` (NeoForge) \u002F `Registry.MENU_TYPE` (Fabric)\n- Sound events → `Registry.SOUND_EVENT`\n- Biomes → `Registry.BIOME`\n\n### ResourceLocation \u002F Identifier\nEvery registry entry needs a namespaced ID:\n```java\n\u002F\u002F NeoForge \u002F vanilla Java\nResourceLocation id = ResourceLocation.fromNamespaceAndPath(\"mymod\", \"my_block\");\n\n\u002F\u002F Fabric (same class, same API in 1.21)\nIdentifier id = Identifier.of(\"mymod\", \"my_block\");\n```\n\n---\n\n## 6. NeoForge Quick Patterns\n\nSee full patterns in `references\u002Fneoforge-api.md`.\n\n```java\n\u002F\u002F Main mod class\n@Mod(MyMod.MOD_ID)\npublic class MyMod {\n    public static final String MOD_ID = \"mymod\";\n\n    public MyMod(IEventBus modEventBus) {\n        ModBlocks.BLOCKS.register(modEventBus);\n        ModItems.ITEMS.register(modEventBus);\n        modEventBus.addListener(this::commonSetup);\n    }\n\n    private void commonSetup(FMLCommonSetupEvent event) {\n        \u002F\u002F runs after all mods are registered\n    }\n}\n```\n\n```java\n\u002F\u002F Block registration\npublic class ModBlocks {\n    public static final DeferredRegister\u003CBlock> BLOCKS =\n        DeferredRegister.create(BuiltInRegistries.BLOCK, MyMod.MOD_ID);\n\n    public static final DeferredBlock\u003CBlock> MY_BLOCK =\n        BLOCKS.registerSimpleBlock(\"my_block\",\n            BlockBehaviour.Properties.of()\n                .mapColor(MapColor.STONE)\n                .strength(1.5f, 6.0f)\n                .sound(SoundType.STONE)\n                .requiresCorrectToolForDrops());\n}\n```\n\n---\n\n## 7. Fabric Quick Patterns\n\nSee full patterns in `references\u002Ffabric-api.md`.\n\n```java\n\u002F\u002F Main mod class\npublic class MyMod implements ModInitializer {\n    public static final String MOD_ID = \"mymod\";\n    public static final Logger LOGGER = LoggerFactory.getLogger(MOD_ID);\n\n    @Override\n    public void onInitialize() {\n        ModBlocks.register();\n        ModItems.register();\n    }\n}\n```\n\n```java\n\u002F\u002F Block registration\npublic class ModBlocks {\n    public static final Block MY_BLOCK = new Block(\n        AbstractBlock.Settings.create()\n            .mapColor(MapColor.STONE)\n            .strength(1.5f, 6.0f)\n            .sounds(BlockSoundGroup.STONE)\n            .requiresTool()\n    );\n\n    public static void register() {\n        Registry.register(Registries.BLOCK,\n            Identifier.of(MyMod.MOD_ID, \"my_block\"), MY_BLOCK);\n    }\n}\n```\n\n---\n\n## 8. JSON Asset Templates\n\nAlways provide matching JSON assets for every registered block\u002Fitem.\nCodex should generate or update these files alongside Java code.\n\nSee `references\u002Fcommon-patterns.md` for full JSON templates for:\n- Blockstate JSON\n- Block model JSON (cube, slab, stairs, fence, door, trapdoor, etc.)\n- Item model JSON\n- Loot table JSON\n- Recipe JSON (crafting_shaped, crafting_shapeless, smelting, blasting, stonecutting)\n- Language file (`en_us.json`) entries\n- Tag JSON\n\n---\n\n## 9. Data Generation\n\nPrefer data generation over hand-authored JSON for maintainability.\n\n```java\n\u002F\u002F NeoForge – register data gen providers in GatherDataEvent\n@SubscribeEvent\npublic static void gatherData(GatherDataEvent event) {\n    DataGenerator gen = event.getGenerator();\n    PackOutput output = gen.getPackOutput();\n    ExistingFileHelper helper = event.getExistingFileHelper();\n    CompletableFuture\u003CHolderLookup.Provider> lookupProvider = event.getLookupProvider();\n\n    gen.addProvider(event.includeClient(), new ModBlockStateProvider(output, helper));\n    gen.addProvider(event.includeClient(), new ModItemModelProvider(output, helper));\n    gen.addProvider(event.includeServer(), new ModRecipeProvider(output, lookupProvider));\n    gen.addProvider(event.includeServer(), new ModLootTableProvider(output, lookupProvider));\n    gen.addProvider(event.includeServer(), new ModBlockTagsProvider(output, lookupProvider, helper));\n}\n```\n\nRun data generation with `.\u002Fgradlew runData`, then commit the generated files.\n\n---\n\n## 10. Common Tasks Checklist\n\nWhen adding a **new block**:\n- [ ] `Block` subclass (or use vanilla Block with properties)\n- [ ] Register in `ModBlocks.BLOCKS` \u002F `Registries.BLOCK`\n- [ ] Register `BlockItem` in `ModItems.ITEMS` \u002F `Registries.ITEM`\n- [ ] Blockstate JSON → `assets\u002F\u003Cmodid>\u002Fblockstates\u002F\u003Cname>.json`\n- [ ] Block model JSON → `assets\u002F\u003Cmodid>\u002Fmodels\u002Fblock\u002F\u003Cname>.json`\n- [ ] Item model JSON → `assets\u002F\u003Cmodid>\u002Fmodels\u002Fitem\u002F\u003Cname>.json` (or inherits from block)\n- [ ] Texture PNG → `assets\u002F\u003Cmodid>\u002Ftextures\u002Fblock\u002F\u003Cname>.png`\n- [ ] Loot table JSON → `data\u002F\u003Cmodid>\u002Floot_table\u002Fblocks\u002F\u003Cname>.json`\n- [ ] Language entry in `en_us.json`\n- [ ] Mine-with-correct-tool tag if hardness > 0\n\nWhen adding a **new item**:\n- [ ] `Item` subclass (or use `new Item(properties)`)\n- [ ] Register in `ModItems` \u002F `Registries.ITEM`\n- [ ] Item model JSON\n- [ ] Texture PNG\n- [ ] Language entry\n- [ ] Creative tab registration (NeoForge: `BuildCreativeModeTabContentsEvent`; Fabric: `ItemGroupEvents`)\n- [ ] Recipe JSON if craftable\n\nWhen adding a **new entity**:\n- [ ] Entity class (extends appropriate base: `Mob`, `Animal`, `TamableAnimal`, etc.)\n- [ ] `EntityType` registration\n- [ ] Renderer class (`@OnlyIn(Dist.CLIENT)`)\n- [ ] Model class (`@OnlyIn(Dist.CLIENT)`)\n- [ ] Register renderer in `EntityRenderersEvent.RegisterRenderers` (NeoForge) or\n      `EntityModelLayerRegistry` (Fabric)\n- [ ] Spawn egg item (optional)\n- [ ] Spawn rules \u002F biome modifier\n\n---\n\n## 11. Open-Source Conventions\n\n- **License**: MIT or LGPL-3.0 — include `LICENSE` file and `SPDX-License-Identifier` header\n- **Versioning**: `{mod_version}+{mc_version}` (e.g., `2.0.0+1.21.11`)\n- **Changelog**: Keep `CHANGELOG.md` up to date with semver notes\n- **Publishing**: Use `gradle-modrinth` or `curseforgegradle` plugins for CurseForge \u002F Modrinth\n- **CI**: GitHub Actions with `.\u002Fgradlew build` and `.\u002Fgradlew runGameTestServer`\n- **PR conventions**: Keep PRs scoped to a single feature; include asset files with Java changes\n\n---\n\n## 12. References\n\n- NeoForge API patterns and event system: `.\u002Freferences\u002Fneoforge-api.md`\n- Fabric API patterns and mixin guide: `.\u002Freferences\u002Ffabric-api.md`\n- Blocks, items, recipes, commands, GUIs, datagen: `.\u002Freferences\u002Fcommon-patterns.md`\n- NeoForge official docs: https:\u002F\u002Fdocs.neoforged.net\u002F\n- Fabric developer docs: https:\u002F\u002Fdocs.fabricmc.net\u002Fdevelop\u002F\n- Architectury (multiloader): https:\u002F\u002Fdocs.architectury.dev\u002F\n- Minecraft Wiki (data formats): https:\u002F\u002Fminecraft.wiki\u002Fw\u002FJava_Edition_data_values\n",{"name":5,"description":7},"main","6fdc6b3043932f6cec4d0a2d51630b19d220dc0d",".agents\u002Fskills\u002Fminecraft-modding",1,"https:\u002F\u002Fgithub.com\u002FAIKUSAN\u002Fminecraft-agent-skills-bundle","https:\u002F\u002Fgithub.com\u002FAIKUSAN","Creating virtual worlds, one line of code at a time.","2026-10-03 22:21:47",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add AIKUSAN\u002Fminecraft-agent-skills-bundle --skill minecraft-modding",{"tool":38,"command":39},"bunx","bunx skills add AIKUSAN\u002Fminecraft-agent-skills-bundle --skill minecraft-modding",{"tool":41,"command":42},"pnpm","pnpm dlx skills add AIKUSAN\u002Fminecraft-agent-skills-bundle --skill minecraft-modding","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FAIKUSAN\u002Fminecraft-agent-skills-bundle\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fminecraft-modding\u002FSKILL.md",true,[46,52,56,60],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"references\u002Fcommon-patterns.md","REFERENCE","参考文档",14984,"https:\u002F\u002Fgithub.com\u002FAIKUSAN\u002Fminecraft-agent-skills-bundle\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fminecraft-modding\u002Freferences\u002Fcommon-patterns.md",{"path":53,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":54,"sourceHtmlUrl":55},"references\u002Ffabric-api.md",10869,"https:\u002F\u002Fgithub.com\u002FAIKUSAN\u002Fminecraft-agent-skills-bundle\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fminecraft-modding\u002Freferences\u002Ffabric-api.md",{"path":57,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":58,"sourceHtmlUrl":59},"references\u002Fneoforge-api.md",12287,"https:\u002F\u002Fgithub.com\u002FAIKUSAN\u002Fminecraft-agent-skills-bundle\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fminecraft-modding\u002Freferences\u002Fneoforge-api.md",{"path":61,"resourceType":62,"resourceTypeDesc":63,"sizeBytes":64,"sourceHtmlUrl":65},"scripts\u002Fcheck-build.sh","SCRIPT","脚本",4170,"https:\u002F\u002Fgithub.com\u002FAIKUSAN\u002Fminecraft-agent-skills-bundle\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fminecraft-modding\u002Fscripts\u002Fcheck-build.sh",[67,74,80,86,92,98],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":19},"01M74FXYYEC9NE1YFJC891WFT2","minecraft-ci-release","Fixture with valid workflow YAML but a warning-only secrets section.","https:\u002F\u002Fgithub.com\u002FAIKUSAN\u002Fminecraft-agent-skills-bundle\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fvalidators\u002Fci-release\u002Fwarn-only\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":19},"01M74FXXD5F0J0VA58R53Z8CA3","valid","https:\u002F\u002Fgithub.com\u002FAIKUSAN\u002Fminecraft-agent-skills-bundle\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fvalidators\u002Fci-release\u002Fvalid\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":19},"01M74FXVT401WRMHEMCPJKA89X","non-workflow-yaml","https:\u002F\u002Fgithub.com\u002FAIKUSAN\u002Fminecraft-agent-skills-bundle\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fvalidators\u002Fci-release\u002Fnon-workflow-yaml\u002FSKILL.md",[],[],{"skillNo":87,"name":69,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":19},"01M74FXTBGQGEPGMX81DFY7FY9","Fixture with valid multiline flow collections in workflow YAML.","https:\u002F\u002Fgithub.com\u002FAIKUSAN\u002Fminecraft-agent-skills-bundle\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fvalidators\u002Fci-release\u002Fmultiline-flow\u002FSKILL.md",[],[],{"skillNo":93,"name":94,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":95,"categories":96,"keywords":97,"publishedAt":19},"01M74FXSAW6GDZ3J3S9FBGC1D6","invalid","https:\u002F\u002Fgithub.com\u002FAIKUSAN\u002Fminecraft-agent-skills-bundle\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fvalidators\u002Fci-release\u002Finvalid\u002FSKILL.md",[],[],{"skillNo":99,"name":69,"nameZh":6,"description":100,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":101,"categories":102,"keywords":103,"publishedAt":19},"01M74FXQRKYD2DDQDN0HR1TE10","Fixture with malformed workflow YAML.","https:\u002F\u002Fgithub.com\u002FAIKUSAN\u002Fminecraft-agent-skills-bundle\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fvalidators\u002Fci-release\u002Finvalid-yaml\u002FSKILL.md",[],[]]