minecraft-multiloader

Build and align Architectury-based Minecraft mod codebases for NeoForge and Fabric.

2|Updated May 22, 2026
One-click install
npx skills add https://github.com/AIKUSAN/minecraft-agent-skills-bundle --skill minecraft-multiloader-aikusan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: minecraft-multiloader
Source: https://github.com/AIKUSAN/minecraft-agent-skills-bundle/tree/main/plugins/minecraft-codex-skills/skills/minecraft-multiloader
Command: npx skills add https://github.com/AIKUSAN/minecraft-agent-skills-bundle --skill minecraft-multiloader-aikusan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

minecraft-multiloader helps you build and maintain one Minecraft mod codebase that ships correctly on both Fabric and NeoForge without platform drift or version mismatches.

Core Features & Use Cases

  • Shared Architectury Structure: Organizes code into common, fabric, and neoforge subprojects so shared logic stays portable.
  • Platform-Specific Behavior: Uses ExpectPlatform implementations and loader entrypoints to keep Fabric and NeoForge differences isolated.
  • Release-Safe Validation: Includes version-alignment guidance, a sanity-check script, and publishing patterns for dual-jar releases.
  • Use Case: Ask for help scaffolding a 1.21.x multiloader mod, fixing cross-loader build errors, or checking that Fabric and NeoForge versions match the target Minecraft patch.

Quick Start

Ask the agent to scaffold or review a Minecraft 1.21.x mod for both Fabric and NeoForge, then verify the Architectury layout, version pins, and platform entrypoints.

Frequently Asked Questions about minecraft-multiloader

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build a single Minecraft mod for both Fabric and NeoForge?

To build a Minecraft mod for both Fabric and NeoForge, you use an Architectury-based multiloader structure with common, fabric, and neoforge subprojects. This setup isolates platform-specific behavior using ExpectPlatform implementations and loader entrypoints, keeping shared logic portable across loaders.

What is the Architectury multiloader layout for Minecraft 1.21.x?

The Architectury layout for Minecraft 1.21.x organizes code into common, fabric, and neoforge subprojects. It uses ExpectPlatform implementations and loader entrypoints to isolate platform-specific differences while keeping shared logic portable across both Fabric and NeoForge.

Can I use Architectury to handle platform-specific code in a NeoForge and Fabric mod?

Yes, Architectury handles platform-specific code using ExpectPlatform implementations and loader entrypoints. This keeps Fabric and NeoForge differences isolated within their respective subprojects while the common subproject maintains portable shared logic.

How do I fix cross-loader build errors and version mismatches in a multiloader mod?

You fix cross-loader build errors and version mismatches in a multiloader mod by validating gradle.properties version pins, checking access widener and remap setup, and running the bundled sanity checker for loader compatibility. This ensures Fabric and NeoForge versions match the target Minecraft patch.

Does this multiloader setup validate Fabric and NeoForge versions against the target Minecraft patch?

Yes, the multiloader setup validates Fabric and NeoForge versions against the target Minecraft patch. It checks gradle.properties version pins, access widener and remap setup, and runs a sanity-check script to ensure loader compatibility and release-safe output.

Why does my Architectury mod have version alignment issues when publishing dual jars?

Version alignment issues when publishing dual jars occur when gradle.properties version pins are mismatched across Fabric and NeoForge subprojects. You resolve this by validating version pins and running the bundled sanity checker to ensure loader compatibility before release.