[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M74FVY47RS1AF5CYP283NQHM":3,"skill-same:01M74FVY47RS1AF5CYP283NQHM":58},{"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},"01M74FVY47RS1AF5CYP283NQHM","minecraft-multiloader",null,"Build Minecraft mods targeting both NeoForge and Fabric simultaneously using the Architectury framework for Minecraft 1.21.x. Covers Architectury project structure (common\u002Fneoforge\u002Ffabric subprojects), ExpectPlatform annotation for platform-specific implementations, shared registry via Architectury's registration API, platform-specific entrypoints, architectury-loom Gradle plugin configuration, gradle.properties for both loaders, multi-jar publishing to Modrinth and CurseForge, and avoiding common pitfalls when sharing code. Use this skill when building a mod that must run on both NeoForge and Fabric with a single shared codebase.","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\u002Fplugins\u002Fminecraft-codex-skills\u002Fskills\u002Fminecraft-multiloader\u002FSKILL.md",[],[],"2026-11-11 15:11:14",false,"---\nname: minecraft-multiloader\ndescription: \"Build Minecraft mods targeting both NeoForge and Fabric simultaneously using the Architectury framework for Minecraft 1.21.x. Covers Architectury project structure (common\u002Fneoforge\u002Ffabric subprojects), ExpectPlatform annotation for platform-specific implementations, shared registry via Architectury's registration API, platform-specific entrypoints, architectury-loom Gradle plugin configuration, gradle.properties for both loaders, multi-jar publishing to Modrinth and CurseForge, and avoiding common pitfalls when sharing code. Use this skill when building a mod that must run on both NeoForge and Fabric with a single shared codebase.\"\n---\n\n# Minecraft Multiloader Skill (Architectury)\n\n## What Is Architectury?\n\n[Architectury](https:\u002F\u002Fgithub.com\u002Farchitectury\u002Farchitectury-api) is a framework that\nlets you write one mod codebase that compiles to both **NeoForge** and **Fabric** JARs.\nThe common subproject has a shared API; platform subprojects implement\nplatform-specific behavior behind the `@ExpectPlatform` abstraction.\n\n### Routing Boundaries\n- `Use when`: one shared codebase must build and ship both NeoForge and Fabric artifacts.\n- `Do not use when`: the project is single-loader only (`minecraft-modding` for NeoForge\u002FFabric, not both).\n- `Do not use when`: the task is Paper\u002FBukkit plugin development (`minecraft-plugin-dev`).\n\n| Component | Purpose |\n|-----------|---------|\n| `architectury-loom` | Gradle plugin — extends Fabric Loom for multiloader support |\n| `architectury-api` | Runtime library — abstractions over both platforms |\n| `@ExpectPlatform` | Annotation marking methods with platform-specific implementations |\n| `common\u002F` | Shared code (no loader-specific APIs) |\n| `fabric\u002F` | Fabric-specific code + entrypoint |\n| `neoforge\u002F` | NeoForge-specific code + entrypoint |\n\n---\n\n## Versions (1.21.x)\n\n```properties\n# gradle.properties (root)\nminecraft_version=1.21.11\nenabled_platforms=fabric,neoforge\n\narchitectury_version=13.0.8\nfabric_loader_version=0.17.3\nfabric_api_version=0.116.10+1.21.1\nneoforge_version=21.11.42\n\nloom_version=1.7\n```\n\nPin `architectury_version`, the Architectury plugin version, and `loom_version`\nfrom the same released template line when scaffolding a new project. The values\nabove are for the stable 1.21.x toolchain story in this repo and avoid snapshot-only examples.\n\n## Bundled References And Helpers\n\n- Version alignment reference: `references\u002Farchitectury-reference.md`\n- Sanity checker: `.\u002Fscripts\u002Fcheck-version-sanity.sh --root \u003Cproject>`\n\nRun the sanity checker after editing `gradle.properties`. It catches the most common\nmultiloader drift mistakes: snapshot toolchain pins, missing `fabric` \u002F `neoforge`\nplatforms, and mismatched NeoForge vs Minecraft patch lines.\n\n---\n\n## Root Project Layout\n\n```\nmy-mod\u002F\n├── build.gradle           ← root build (shared config)\n├── settings.gradle\n├── gradle.properties\n├── common\u002F\n│   ├── build.gradle\n│   └── src\u002Fmain\u002Fjava\u002Fcom\u002Fexample\u002Fmymod\u002F\n│       ├── MyMod.java               ← shared init\n│       ├── registry\u002F\n│       │   └── ModItems.java        ← shared registry declarations\n│       └── platform\u002F\n│           └── PlatformHelper.java  ← @ExpectPlatform methods\n├── fabric\u002F\n│   ├── build.gradle\n│   └── src\u002Fmain\u002F\n│       ├── java\u002Fcom\u002Fexample\u002Fmymod\u002Ffabric\u002F\n│       │   ├── MyModFabric.java          ← Fabric entrypoint\n│       │   └── platform\u002F\n│       │       └── PlatformHelperImpl.java  ← Fabric implementation\n│       └── resources\u002F\n│           ├── fabric.mod.json\n│           └── assets\u002F...\n└── neoforge\u002F\n    ├── build.gradle\n    └── src\u002Fmain\u002F\n        ├── java\u002Fcom\u002Fexample\u002Fmymod\u002Fneoforge\u002F\n        │   ├── MyModNeoForge.java        ← NeoForge @Mod entry\n        │   └── platform\u002F\n        │       └── PlatformHelperImpl.java  ← NeoForge implementation\n        └── resources\u002F\n            ├── META-INF\u002Fneoforge.mods.toml\n            └── assets\u002F...\n```\n\n---\n\n## Root `settings.gradle`\n\n```groovy\npluginManagement {\n    repositories {\n        maven { url \"https:\u002F\u002Fmaven.architectury.dev\u002F\" }\n        maven { url \"https:\u002F\u002Fmaven.fabricmc.net\u002F\" }\n        maven { url \"https:\u002F\u002Fmaven.neoforged.net\u002Freleases\" }\n        gradlePluginPortal()\n    }\n}\n\ninclude \"common\"\ninclude \"fabric\"\ninclude \"neoforge\"\n```\n\n---\n\n## Root `build.gradle`\n\n```groovy\nplugins {\n    id \"architectury-plugin\" version \"3.4\" apply false\n    id \"dev.architectury.loom\" version \"${loom_version}\" apply false\n    id \"com.github.johnrengelman.shadow\" version \"8.1.1\" apply false\n}\n\narchitectury {\n    minecraft = rootProject.minecraft_version\n}\n\nsubprojects {\n    apply plugin: \"java\"\n    apply plugin: \"architectury-plugin\"\n\n    group = \"com.example.mymod\"\n    version = \"${mod_version}+${minecraft_version}\"\n    archivesBaseName = \"my-mod-${project.name}\"\n\n    repositories {\n        maven { url \"https:\u002F\u002Fmaven.architectury.dev\u002F\" }\n        maven { url \"https:\u002F\u002Fmod-buildtools.pkg.github.com\u002FTerraformersMC\u002F\" }\n    }\n\n    java {\n        withSourcesJar()\n        sourceCompatibility = JavaVersion.VERSION_21\n        targetCompatibility = JavaVersion.VERSION_21\n    }\n}\n```\n\n---\n\n## `common\u002Fbuild.gradle`\n\n```groovy\nplugins {\n    id \"dev.architectury.loom\" apply true\n}\n\narchitectury {\n    common(rootProject.enabled_platforms.split(\",\"))\n}\n\nloom {\n    \u002F\u002F common project uses mappings only\n}\n\ndependencies {\n    minecraft \"com.mojang:minecraft:${rootProject.minecraft_version}\"\n    mappings loom.officialMojangMappings()\n\n    modImplementation \"dev.architectury:architectury-api:${rootProject.architectury_version}\"\n}\n```\n\n---\n\n## `fabric\u002Fbuild.gradle`\n\n```groovy\nplugins {\n    id \"com.github.johnrengelman.shadow\"\n    id \"dev.architectury.loom\" apply true\n}\n\narchitectury {\n    platformSetupLoomIde()\n    fabric()\n}\n\nloom {\n    accessWidenerPath = project(\":common\").loom.accessWidenerPath\n}\n\nconfigurations {\n    common\n    shadowCommon\n    compileClasspath.extendsFrom common\n    runtimeClasspath.extendsFrom common\n    developmentFabric.extendsFrom common\n}\n\ndependencies {\n    minecraft \"com.mojang:minecraft:${rootProject.minecraft_version}\"\n    mappings loom.officialMojangMappings()\n\n    modImplementation \"net.fabricmc:fabric-loader:${rootProject.fabric_loader_version}\"\n    modApi \"net.fabricmc.fabric-api:fabric-api:${rootProject.fabric_api_version}\"\n    modApi \"dev.architectury:architectury-api:${rootProject.architectury_version}:fabric\"\n\n    common(project(path: \":common\", configuration: \"namedElements\")) { transitive false }\n    shadowCommon(project(path: \":common\", configuration: \"transformProductionFabric\")) { transitive false }\n}\n\nshadowJar {\n    exclude \"architectury.common.json\"\n    configurations = [project.configurations.shadowCommon]\n    archiveClassifier = \"dev-shadow\"\n}\n\nremapJar {\n    injectAccessWidener = true\n    input.fileValue shadowJar.archiveFile.get().asFile\n    dependsOn shadowJar\n    archiveClassifier = \"\"\n}\n\njar { archiveClassifier = \"dev\" }\nsourcesJar { archiveClassifier = \"dev-sources\" }\ncomponents.java.withVariantsFromConfiguration(configurations.shadowRuntimeElements) { skip() }\n```\n\n---\n\n## `neoforge\u002Fbuild.gradle`\n\n```groovy\nplugins {\n    id \"com.github.johnrengelman.shadow\"\n    id \"dev.architectury.loom\" apply true\n}\n\narchitectury {\n    platformSetupLoomIde()\n    neoForge()\n}\n\nloom {\n    accessWidenerPath = project(\":common\").loom.accessWidenerPath\n}\n\nconfigurations {\n    common\n    shadowCommon\n    compileClasspath.extendsFrom common\n    runtimeClasspath.extendsFrom common\n    developmentNeoForge.extendsFrom common\n}\n\ndependencies {\n    minecraft \"com.mojang:minecraft:${rootProject.minecraft_version}\"\n    mappings loom.officialMojangMappings()\n\n    neoForge \"net.neoforged:neoforge:${rootProject.neoforge_version}\"\n    modApi \"dev.architectury:architectury-api:${rootProject.architectury_version}:neoforge\"\n\n    common(project(path: \":common\", configuration: \"namedElements\")) { transitive false }\n    shadowCommon(project(path: \":common\", configuration: \"transformProductionNeoForge\")) { transitive false }\n}\n\nshadowJar {\n    exclude \"architectury.common.json\"\n    configurations = [project.configurations.shadowCommon]\n    archiveClassifier = \"dev-shadow\"\n}\n\nremapJar {\n    input.fileValue shadowJar.archiveFile.get().asFile\n    dependsOn shadowJar\n    archiveClassifier = \"\"\n}\n\njar { archiveClassifier = \"dev\" }\n```\n\n---\n\n## Shared Common Code\n\n### `common\u002F...\u002FMyMod.java`\n```java\npackage com.example.mymod;\n\nimport dev.architectury.registry.registries.DeferredRegister;\nimport dev.architectury.registry.registries.RegistrySupplier;\nimport net.minecraft.core.registries.BuiltInRegistries;\nimport net.minecraft.resources.ResourceLocation;\nimport net.minecraft.world.item.Item;\n\npublic class MyMod {\n    public static final String MOD_ID = \"mymod\";\n\n    \u002F\u002F Architectury's DeferredRegister — works on both platforms\n    public static final DeferredRegister\u003CItem> ITEMS =\n        DeferredRegister.create(MOD_ID, BuiltInRegistries.ITEM);\n\n    public static final RegistrySupplier\u003CItem> MY_ITEM =\n        ITEMS.register(\"my_item\", () -> new Item(new Item.Properties()));\n\n    public static void init() {\n        ITEMS.register(); \u002F\u002F registers with both platforms\n    }\n}\n```\n\n### `@ExpectPlatform` — platform-specific methods\n\nDefine the contract in `common\u002F`:\n```java\npackage com.example.mymod.platform;\n\nimport dev.architectury.injectables.annotations.ExpectPlatform;\nimport net.minecraft.world.level.material.Fluid;\n\npublic class PlatformHelper {\n\n    @ExpectPlatform\n    public static boolean isModLoaded(String modId) {\n        \u002F\u002F This body is replaced at compile time by the platform implementation\n        throw new AssertionError(\"ExpectPlatform implementation not found\");\n    }\n\n    @ExpectPlatform\n    public static boolean isClient() {\n        throw new AssertionError();\n    }\n}\n```\n\nImplement in `fabric\u002F...\u002Fplatform\u002FPlatformHelperImpl.java`:\n```java\npackage com.example.mymod.platform;\n\nimport net.fabricmc.loader.api.FabricLoader;\n\n\u002F\u002F Class name must match: \u003Ccommon class name>Impl\npublic class PlatformHelperImpl {\n\n    public static boolean isModLoaded(String modId) {\n        return FabricLoader.getInstance().isModLoaded(modId);\n    }\n\n    public static boolean isClient() {\n        return FabricLoader.getInstance().getEnvironmentType() ==\n            net.fabricmc.api.EnvType.CLIENT;\n    }\n}\n```\n\nImplement in `neoforge\u002F...\u002Fplatform\u002FPlatformHelperImpl.java`:\n```java\npackage com.example.mymod.platform;\n\nimport net.neoforged.fml.ModList;\nimport net.neoforged.fml.loading.FMLEnvironment;\n\npublic class PlatformHelperImpl {\n\n    public static boolean isModLoaded(String modId) {\n        return ModList.get().isLoaded(modId);\n    }\n\n    public static boolean isClient() {\n        return FMLEnvironment.dist.isClient();\n    }\n}\n```\n\n---\n\n## Fabric Entrypoint\n\n### `fabric\u002F...\u002FMyModFabric.java`\n```java\npackage com.example.mymod.fabric;\n\nimport com.example.mymod.MyMod;\nimport net.fabricmc.api.ModInitializer;\n\npublic class MyModFabric implements ModInitializer {\n    @Override\n    public void onInitialize() {\n        MyMod.init();\n    }\n}\n```\n\n### `fabric\u002F...\u002Fresources\u002Ffabric.mod.json`\n```json\n{\n  \"schemaVersion\": 1,\n  \"id\": \"mymod\",\n  \"version\": \"${version}\",\n  \"name\": \"My Mod\",\n  \"description\": \"A multiloader example mod\",\n  \"license\": \"MIT\",\n  \"environment\": \"*\",\n  \"entrypoints\": {\n    \"main\": [\"com.example.mymod.fabric.MyModFabric\"]\n  },\n  \"depends\": {\n    \"fabricloader\": \">=0.16.0\",\n    \"fabric-api\": \"*\",\n    \"architectury\": \">=13.0.0\",\n    \"minecraft\": \"~1.21\"\n  }\n}\n```\n\n---\n\n## NeoForge Entrypoint\n\n### `neoforge\u002F...\u002FMyModNeoForge.java`\n```java\npackage com.example.mymod.neoforge;\n\nimport com.example.mymod.MyMod;\nimport net.neoforged.bus.api.IEventBus;\nimport net.neoforged.fml.common.Mod;\n\n@Mod(MyMod.MOD_ID)\npublic class MyModNeoForge {\n    public MyModNeoForge(IEventBus modEventBus) {\n        MyMod.init();\n    }\n}\n```\n\n### `neoforge\u002F...\u002Fresources\u002FMETA-INF\u002Fneoforge.mods.toml`\n```toml\nmodLoader = \"javafml\"\nloaderVersion = \"[4,)\"\nlicense = \"MIT\"\n\n[[mods]]\nmodId = \"mymod\"\nversion = \"${file.jarVersion}\"\ndisplayName = \"My Mod\"\ndescription = \"A multiloader example mod\"\n\n[[dependencies.mymod]]\nmodId = \"neoforge\"\ntype = \"required\"\nversionRange = \"[21.11,)\"\nordering = \"NONE\"\nside = \"BOTH\"\n\n[[dependencies.mymod]]\nmodId = \"minecraft\"\ntype = \"required\"\nversionRange = \"[1.21.11,1.22)\"\nordering = \"NONE\"\nside = \"BOTH\"\n```\n\n---\n\n## Build Commands\n\n```bash\n# Build both JARs simultaneously\n.\u002Fgradlew build\n\n# Outputs:\n#   fabric\u002Fbuild\u002Flibs\u002Fmy-mod-fabric-1.0.0+1.21.11.jar\n#   neoforge\u002Fbuild\u002Flibs\u002Fmy-mod-neoforge-1.0.0+1.21.11.jar\n\n# Run in dev environment\n.\u002Fgradlew :fabric:runClient\n.\u002Fgradlew :neoforge:runClient\n.\u002Fgradlew :neoforge:runServer\n\n# Datagen (if applicable)\n.\u002Fgradlew :neoforge:runData\n```\n\n---\n\n## Common Pitfalls\n\n| Pitfall | Solution |\n|---------|----------|\n| Using `net.neoforged.*` \u002F `net.fabricmc.*` in `common\u002F` | Only use vanilla MC and Architectury APIs in common |\n| Direct field access on `DeferredRegister` (NeoForge style) in common | Use Architectury's `DeferredRegister` |\n| Forgetting `@ExpectPlatform` throws `AssertionError` at runtime | Both `fabric\u002F` and `neoforge\u002F` must have matching `*Impl` classes |\n| Assets duplicated in fabric\u002F and neoforge\u002F | Keep assets in `common\u002Fsrc\u002Fmain\u002Fresources\u002Fassets\u002F` |\n| Mixins in common — not supported on NeoForge | Put Mixins in the platform subprojects only |\n| Accessing world\u002Fregistry on mod init thread | Use `mod bus` events for setup; never access world on init |\n\n---\n\n## References\n\n- Architectury API GitHub: https:\u002F\u002Fgithub.com\u002Farchitectury\u002Farchitectury-api\n- Architectury Loom: https:\u002F\u002Fgithub.com\u002Farchitectury\u002Farchitectury-loom\n- Architectury templates: https:\u002F\u002Fgithub.com\u002Farchitectury\u002Farchitectury-templates\n- Architectury docs: https:\u002F\u002Fdocs.architectury.dev\u002F\n","# Minecraft Multiloader Skill (Architectury)\n\n## What Is Architectury?\n\n[Architectury](https:\u002F\u002Fgithub.com\u002Farchitectury\u002Farchitectury-api) is a framework that\nlets you write one mod codebase that compiles to both **NeoForge** and **Fabric** JARs.\nThe common subproject has a shared API; platform subprojects implement\nplatform-specific behavior behind the `@ExpectPlatform` abstraction.\n\n### Routing Boundaries\n- `Use when`: one shared codebase must build and ship both NeoForge and Fabric artifacts.\n- `Do not use when`: the project is single-loader only (`minecraft-modding` for NeoForge\u002FFabric, not both).\n- `Do not use when`: the task is Paper\u002FBukkit plugin development (`minecraft-plugin-dev`).\n\n| Component | Purpose |\n|-----------|---------|\n| `architectury-loom` | Gradle plugin — extends Fabric Loom for multiloader support |\n| `architectury-api` | Runtime library — abstractions over both platforms |\n| `@ExpectPlatform` | Annotation marking methods with platform-specific implementations |\n| `common\u002F` | Shared code (no loader-specific APIs) |\n| `fabric\u002F` | Fabric-specific code + entrypoint |\n| `neoforge\u002F` | NeoForge-specific code + entrypoint |\n\n---\n\n## Versions (1.21.x)\n\n```properties\n# gradle.properties (root)\nminecraft_version=1.21.11\nenabled_platforms=fabric,neoforge\n\narchitectury_version=13.0.8\nfabric_loader_version=0.17.3\nfabric_api_version=0.116.10+1.21.1\nneoforge_version=21.11.42\n\nloom_version=1.7\n```\n\nPin `architectury_version`, the Architectury plugin version, and `loom_version`\nfrom the same released template line when scaffolding a new project. The values\nabove are for the stable 1.21.x toolchain story in this repo and avoid snapshot-only examples.\n\n## Bundled References And Helpers\n\n- Version alignment reference: `references\u002Farchitectury-reference.md`\n- Sanity checker: `.\u002Fscripts\u002Fcheck-version-sanity.sh --root \u003Cproject>`\n\nRun the sanity checker after editing `gradle.properties`. It catches the most common\nmultiloader drift mistakes: snapshot toolchain pins, missing `fabric` \u002F `neoforge`\nplatforms, and mismatched NeoForge vs Minecraft patch lines.\n\n---\n\n## Root Project Layout\n\n```\nmy-mod\u002F\n├── build.gradle           ← root build (shared config)\n├── settings.gradle\n├── gradle.properties\n├── common\u002F\n│   ├── build.gradle\n│   └── src\u002Fmain\u002Fjava\u002Fcom\u002Fexample\u002Fmymod\u002F\n│       ├── MyMod.java               ← shared init\n│       ├── registry\u002F\n│       │   └── ModItems.java        ← shared registry declarations\n│       └── platform\u002F\n│           └── PlatformHelper.java  ← @ExpectPlatform methods\n├── fabric\u002F\n│   ├── build.gradle\n│   └── src\u002Fmain\u002F\n│       ├── java\u002Fcom\u002Fexample\u002Fmymod\u002Ffabric\u002F\n│       │   ├── MyModFabric.java          ← Fabric entrypoint\n│       │   └── platform\u002F\n│       │       └── PlatformHelperImpl.java  ← Fabric implementation\n│       └── resources\u002F\n│           ├── fabric.mod.json\n│           └── assets\u002F...\n└── neoforge\u002F\n    ├── build.gradle\n    └── src\u002Fmain\u002F\n        ├── java\u002Fcom\u002Fexample\u002Fmymod\u002Fneoforge\u002F\n        │   ├── MyModNeoForge.java        ← NeoForge @Mod entry\n        │   └── platform\u002F\n        │       └── PlatformHelperImpl.java  ← NeoForge implementation\n        └── resources\u002F\n            ├── META-INF\u002Fneoforge.mods.toml\n            └── assets\u002F...\n```\n\n---\n\n## Root `settings.gradle`\n\n```groovy\npluginManagement {\n    repositories {\n        maven { url \"https:\u002F\u002Fmaven.architectury.dev\u002F\" }\n        maven { url \"https:\u002F\u002Fmaven.fabricmc.net\u002F\" }\n        maven { url \"https:\u002F\u002Fmaven.neoforged.net\u002Freleases\" }\n        gradlePluginPortal()\n    }\n}\n\ninclude \"common\"\ninclude \"fabric\"\ninclude \"neoforge\"\n```\n\n---\n\n## Root `build.gradle`\n\n```groovy\nplugins {\n    id \"architectury-plugin\" version \"3.4\" apply false\n    id \"dev.architectury.loom\" version \"${loom_version}\" apply false\n    id \"com.github.johnrengelman.shadow\" version \"8.1.1\" apply false\n}\n\narchitectury {\n    minecraft = rootProject.minecraft_version\n}\n\nsubprojects {\n    apply plugin: \"java\"\n    apply plugin: \"architectury-plugin\"\n\n    group = \"com.example.mymod\"\n    version = \"${mod_version}+${minecraft_version}\"\n    archivesBaseName = \"my-mod-${project.name}\"\n\n    repositories {\n        maven { url \"https:\u002F\u002Fmaven.architectury.dev\u002F\" }\n        maven { url \"https:\u002F\u002Fmod-buildtools.pkg.github.com\u002FTerraformersMC\u002F\" }\n    }\n\n    java {\n        withSourcesJar()\n        sourceCompatibility = JavaVersion.VERSION_21\n        targetCompatibility = JavaVersion.VERSION_21\n    }\n}\n```\n\n---\n\n## `common\u002Fbuild.gradle`\n\n```groovy\nplugins {\n    id \"dev.architectury.loom\" apply true\n}\n\narchitectury {\n    common(rootProject.enabled_platforms.split(\",\"))\n}\n\nloom {\n    \u002F\u002F common project uses mappings only\n}\n\ndependencies {\n    minecraft \"com.mojang:minecraft:${rootProject.minecraft_version}\"\n    mappings loom.officialMojangMappings()\n\n    modImplementation \"dev.architectury:architectury-api:${rootProject.architectury_version}\"\n}\n```\n\n---\n\n## `fabric\u002Fbuild.gradle`\n\n```groovy\nplugins {\n    id \"com.github.johnrengelman.shadow\"\n    id \"dev.architectury.loom\" apply true\n}\n\narchitectury {\n    platformSetupLoomIde()\n    fabric()\n}\n\nloom {\n    accessWidenerPath = project(\":common\").loom.accessWidenerPath\n}\n\nconfigurations {\n    common\n    shadowCommon\n    compileClasspath.extendsFrom common\n    runtimeClasspath.extendsFrom common\n    developmentFabric.extendsFrom common\n}\n\ndependencies {\n    minecraft \"com.mojang:minecraft:${rootProject.minecraft_version}\"\n    mappings loom.officialMojangMappings()\n\n    modImplementation \"net.fabricmc:fabric-loader:${rootProject.fabric_loader_version}\"\n    modApi \"net.fabricmc.fabric-api:fabric-api:${rootProject.fabric_api_version}\"\n    modApi \"dev.architectury:architectury-api:${rootProject.architectury_version}:fabric\"\n\n    common(project(path: \":common\", configuration: \"namedElements\")) { transitive false }\n    shadowCommon(project(path: \":common\", configuration: \"transformProductionFabric\")) { transitive false }\n}\n\nshadowJar {\n    exclude \"architectury.common.json\"\n    configurations = [project.configurations.shadowCommon]\n    archiveClassifier = \"dev-shadow\"\n}\n\nremapJar {\n    injectAccessWidener = true\n    input.fileValue shadowJar.archiveFile.get().asFile\n    dependsOn shadowJar\n    archiveClassifier = \"\"\n}\n\njar { archiveClassifier = \"dev\" }\nsourcesJar { archiveClassifier = \"dev-sources\" }\ncomponents.java.withVariantsFromConfiguration(configurations.shadowRuntimeElements) { skip() }\n```\n\n---\n\n## `neoforge\u002Fbuild.gradle`\n\n```groovy\nplugins {\n    id \"com.github.johnrengelman.shadow\"\n    id \"dev.architectury.loom\" apply true\n}\n\narchitectury {\n    platformSetupLoomIde()\n    neoForge()\n}\n\nloom {\n    accessWidenerPath = project(\":common\").loom.accessWidenerPath\n}\n\nconfigurations {\n    common\n    shadowCommon\n    compileClasspath.extendsFrom common\n    runtimeClasspath.extendsFrom common\n    developmentNeoForge.extendsFrom common\n}\n\ndependencies {\n    minecraft \"com.mojang:minecraft:${rootProject.minecraft_version}\"\n    mappings loom.officialMojangMappings()\n\n    neoForge \"net.neoforged:neoforge:${rootProject.neoforge_version}\"\n    modApi \"dev.architectury:architectury-api:${rootProject.architectury_version}:neoforge\"\n\n    common(project(path: \":common\", configuration: \"namedElements\")) { transitive false }\n    shadowCommon(project(path: \":common\", configuration: \"transformProductionNeoForge\")) { transitive false }\n}\n\nshadowJar {\n    exclude \"architectury.common.json\"\n    configurations = [project.configurations.shadowCommon]\n    archiveClassifier = \"dev-shadow\"\n}\n\nremapJar {\n    input.fileValue shadowJar.archiveFile.get().asFile\n    dependsOn shadowJar\n    archiveClassifier = \"\"\n}\n\njar { archiveClassifier = \"dev\" }\n```\n\n---\n\n## Shared Common Code\n\n### `common\u002F...\u002FMyMod.java`\n```java\npackage com.example.mymod;\n\nimport dev.architectury.registry.registries.DeferredRegister;\nimport dev.architectury.registry.registries.RegistrySupplier;\nimport net.minecraft.core.registries.BuiltInRegistries;\nimport net.minecraft.resources.ResourceLocation;\nimport net.minecraft.world.item.Item;\n\npublic class MyMod {\n    public static final String MOD_ID = \"mymod\";\n\n    \u002F\u002F Architectury's DeferredRegister — works on both platforms\n    public static final DeferredRegister\u003CItem> ITEMS =\n        DeferredRegister.create(MOD_ID, BuiltInRegistries.ITEM);\n\n    public static final RegistrySupplier\u003CItem> MY_ITEM =\n        ITEMS.register(\"my_item\", () -> new Item(new Item.Properties()));\n\n    public static void init() {\n        ITEMS.register(); \u002F\u002F registers with both platforms\n    }\n}\n```\n\n### `@ExpectPlatform` — platform-specific methods\n\nDefine the contract in `common\u002F`:\n```java\npackage com.example.mymod.platform;\n\nimport dev.architectury.injectables.annotations.ExpectPlatform;\nimport net.minecraft.world.level.material.Fluid;\n\npublic class PlatformHelper {\n\n    @ExpectPlatform\n    public static boolean isModLoaded(String modId) {\n        \u002F\u002F This body is replaced at compile time by the platform implementation\n        throw new AssertionError(\"ExpectPlatform implementation not found\");\n    }\n\n    @ExpectPlatform\n    public static boolean isClient() {\n        throw new AssertionError();\n    }\n}\n```\n\nImplement in `fabric\u002F...\u002Fplatform\u002FPlatformHelperImpl.java`:\n```java\npackage com.example.mymod.platform;\n\nimport net.fabricmc.loader.api.FabricLoader;\n\n\u002F\u002F Class name must match: \u003Ccommon class name>Impl\npublic class PlatformHelperImpl {\n\n    public static boolean isModLoaded(String modId) {\n        return FabricLoader.getInstance().isModLoaded(modId);\n    }\n\n    public static boolean isClient() {\n        return FabricLoader.getInstance().getEnvironmentType() ==\n            net.fabricmc.api.EnvType.CLIENT;\n    }\n}\n```\n\nImplement in `neoforge\u002F...\u002Fplatform\u002FPlatformHelperImpl.java`:\n```java\npackage com.example.mymod.platform;\n\nimport net.neoforged.fml.ModList;\nimport net.neoforged.fml.loading.FMLEnvironment;\n\npublic class PlatformHelperImpl {\n\n    public static boolean isModLoaded(String modId) {\n        return ModList.get().isLoaded(modId);\n    }\n\n    public static boolean isClient() {\n        return FMLEnvironment.dist.isClient();\n    }\n}\n```\n\n---\n\n## Fabric Entrypoint\n\n### `fabric\u002F...\u002FMyModFabric.java`\n```java\npackage com.example.mymod.fabric;\n\nimport com.example.mymod.MyMod;\nimport net.fabricmc.api.ModInitializer;\n\npublic class MyModFabric implements ModInitializer {\n    @Override\n    public void onInitialize() {\n        MyMod.init();\n    }\n}\n```\n\n### `fabric\u002F...\u002Fresources\u002Ffabric.mod.json`\n```json\n{\n  \"schemaVersion\": 1,\n  \"id\": \"mymod\",\n  \"version\": \"${version}\",\n  \"name\": \"My Mod\",\n  \"description\": \"A multiloader example mod\",\n  \"license\": \"MIT\",\n  \"environment\": \"*\",\n  \"entrypoints\": {\n    \"main\": [\"com.example.mymod.fabric.MyModFabric\"]\n  },\n  \"depends\": {\n    \"fabricloader\": \">=0.16.0\",\n    \"fabric-api\": \"*\",\n    \"architectury\": \">=13.0.0\",\n    \"minecraft\": \"~1.21\"\n  }\n}\n```\n\n---\n\n## NeoForge Entrypoint\n\n### `neoforge\u002F...\u002FMyModNeoForge.java`\n```java\npackage com.example.mymod.neoforge;\n\nimport com.example.mymod.MyMod;\nimport net.neoforged.bus.api.IEventBus;\nimport net.neoforged.fml.common.Mod;\n\n@Mod(MyMod.MOD_ID)\npublic class MyModNeoForge {\n    public MyModNeoForge(IEventBus modEventBus) {\n        MyMod.init();\n    }\n}\n```\n\n### `neoforge\u002F...\u002Fresources\u002FMETA-INF\u002Fneoforge.mods.toml`\n```toml\nmodLoader = \"javafml\"\nloaderVersion = \"[4,)\"\nlicense = \"MIT\"\n\n[[mods]]\nmodId = \"mymod\"\nversion = \"${file.jarVersion}\"\ndisplayName = \"My Mod\"\ndescription = \"A multiloader example mod\"\n\n[[dependencies.mymod]]\nmodId = \"neoforge\"\ntype = \"required\"\nversionRange = \"[21.11,)\"\nordering = \"NONE\"\nside = \"BOTH\"\n\n[[dependencies.mymod]]\nmodId = \"minecraft\"\ntype = \"required\"\nversionRange = \"[1.21.11,1.22)\"\nordering = \"NONE\"\nside = \"BOTH\"\n```\n\n---\n\n## Build Commands\n\n```bash\n# Build both JARs simultaneously\n.\u002Fgradlew build\n\n# Outputs:\n#   fabric\u002Fbuild\u002Flibs\u002Fmy-mod-fabric-1.0.0+1.21.11.jar\n#   neoforge\u002Fbuild\u002Flibs\u002Fmy-mod-neoforge-1.0.0+1.21.11.jar\n\n# Run in dev environment\n.\u002Fgradlew :fabric:runClient\n.\u002Fgradlew :neoforge:runClient\n.\u002Fgradlew :neoforge:runServer\n\n# Datagen (if applicable)\n.\u002Fgradlew :neoforge:runData\n```\n\n---\n\n## Common Pitfalls\n\n| Pitfall | Solution |\n|---------|----------|\n| Using `net.neoforged.*` \u002F `net.fabricmc.*` in `common\u002F` | Only use vanilla MC and Architectury APIs in common |\n| Direct field access on `DeferredRegister` (NeoForge style) in common | Use Architectury's `DeferredRegister` |\n| Forgetting `@ExpectPlatform` throws `AssertionError` at runtime | Both `fabric\u002F` and `neoforge\u002F` must have matching `*Impl` classes |\n| Assets duplicated in fabric\u002F and neoforge\u002F | Keep assets in `common\u002Fsrc\u002Fmain\u002Fresources\u002Fassets\u002F` |\n| Mixins in common — not supported on NeoForge | Put Mixins in the platform subprojects only |\n| Accessing world\u002Fregistry on mod init thread | Use `mod bus` events for setup; never access world on init |\n\n---\n\n## References\n\n- Architectury API GitHub: https:\u002F\u002Fgithub.com\u002Farchitectury\u002Farchitectury-api\n- Architectury Loom: https:\u002F\u002Fgithub.com\u002Farchitectury\u002Farchitectury-loom\n- Architectury templates: https:\u002F\u002Fgithub.com\u002Farchitectury\u002Farchitectury-templates\n- Architectury docs: https:\u002F\u002Fdocs.architectury.dev\u002F\n",{"name":5,"description":7},"main","6fdc6b3043932f6cec4d0a2d51630b19d220dc0d","plugins\u002Fminecraft-codex-skills\u002Fskills\u002Fminecraft-multiloader",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-multiloader",{"tool":38,"command":39},"bunx","bunx skills add AIKUSAN\u002Fminecraft-agent-skills-bundle --skill minecraft-multiloader",{"tool":41,"command":42},"pnpm","pnpm dlx skills add AIKUSAN\u002Fminecraft-agent-skills-bundle --skill minecraft-multiloader","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FAIKUSAN\u002Fminecraft-agent-skills-bundle\u002Fblob\u002Fmain\u002Fplugins\u002Fminecraft-codex-skills\u002Fskills\u002Fminecraft-multiloader\u002FSKILL.md",true,[46,52],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"references\u002Farchitectury-reference.md","REFERENCE","参考文档",1561,"https:\u002F\u002Fgithub.com\u002FAIKUSAN\u002Fminecraft-agent-skills-bundle\u002Fblob\u002Fmain\u002Fplugins\u002Fminecraft-codex-skills\u002Fskills\u002Fminecraft-multiloader\u002Freferences\u002Farchitectury-reference.md",{"path":53,"resourceType":54,"resourceTypeDesc":55,"sizeBytes":56,"sourceHtmlUrl":57},"scripts\u002Fcheck-version-sanity.sh","SCRIPT","脚本",3537,"https:\u002F\u002Fgithub.com\u002FAIKUSAN\u002Fminecraft-agent-skills-bundle\u002Fblob\u002Fmain\u002Fplugins\u002Fminecraft-codex-skills\u002Fskills\u002Fminecraft-multiloader\u002Fscripts\u002Fcheck-version-sanity.sh",[59,66,72,78,84,90],{"skillNo":60,"name":61,"nameZh":6,"description":62,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":63,"categories":64,"keywords":65,"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":67,"name":68,"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":69,"categories":70,"keywords":71,"publishedAt":19},"01M74FXXD5F0J0VA58R53Z8CA3","valid","https:\u002F\u002Fgithub.com\u002FAIKUSAN\u002Fminecraft-agent-skills-bundle\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fvalidators\u002Fci-release\u002Fvalid\u002FSKILL.md",[],[],{"skillNo":73,"name":74,"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":75,"categories":76,"keywords":77,"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":79,"name":61,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"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":85,"name":86,"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":87,"categories":88,"keywords":89,"publishedAt":19},"01M74FXSAW6GDZ3J3S9FBGC1D6","invalid","https:\u002F\u002Fgithub.com\u002FAIKUSAN\u002Fminecraft-agent-skills-bundle\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fvalidators\u002Fci-release\u002Finvalid\u002FSKILL.md",[],[],{"skillNo":91,"name":61,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":93,"categories":94,"keywords":95,"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",[],[]]