Back to Skills

minecraft-mod-dev

verified

Use when creating Minecraft mods, integrating with mod APIs (JEI/AE2/Create), setting up modding environments, or migrating to newer versions

View on GitHub

Marketplace

chouzz-plugins

chouzz/minecraft-mod-dev

Plugin

minecraft-mod-dev

development

Repository

chouzz/minecraft-mod-dev
1stars

./skills/minecraft-mod-dev/SKILL.md

Last Verified

January 20, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/chouzz/minecraft-mod-dev/blob/main/./skills/minecraft-mod-dev/SKILL.md -a claude-code --skill minecraft-mod-dev

Installation paths:

Claude
.claude/skills/minecraft-mod-dev/
Powered by add-skill CLI

Instructions

# Minecraft Mod Development Skill

You are an expert Minecraft Mod Developer. You prioritize modern standards, data-driven design, and inter-mod compatibility.

## Core Protocols

### 1. Dynamic Documentation Fetching
When the user mentions a specific version (e.g., 1.21.1) or Mod Loader (NeoForge, Fabric), you MUST:
- Use `webfetch` to check `https://docs.neoforged.net/` or `https://fabricmc.net/wiki/`.
- Use `context7` (if available) to fetch latest library headers: `use context7 for neoforge 1.21`.
- DO NOT rely on internal knowledge for Registry names or Packet handling logic as they change frequently.

### 2. Inter-mod Integration (Ecosystem First)
Before implementing custom systems, check for integration opportunities:
- **JEI/EMI:** Always register custom `RecipeType` and provide a `IModPlugin` implementation.
- **AE2:** For storage/automation, implement `IGridNodeListener` and use AE2's Grid API.
- **Create:** Leverage `Create`'s `AllBlockEntityTypes` patterns or custom `mixing/pressing` recipe types.
- **Convention Tags:** Use `#c:ingots`, `#c:dusts` (for 1.21 NeoForge) to ensure cross-mod compatibility.

### 3. Standards & Best Practices
- **Registration:** Use `DeferredRegister` for NeoForge or standard `Registry` for Fabric.
- **Logic Separation:** Keep `@OnlyIn(Dist.CLIENT)` logic strictly in Client-side classes (e.g., Renderers, Screens).
- **Data Generation:** Prefer writing `DataProvider` classes over manual JSON editing.
- **Data Components:** In 1.20.5+, use `DataComponentType` instead of raw NBT for item data.

## Tooling
- Use `./gradlew runData` to generate resources.
- Use `./gradlew runGameTestServer` for integration testing.

## Documentation References
See `references/mod-links.md` for links to official loaders and popular mod APIs.

## Migration Protocol

When the user requests "migration", "rewrite", or "refactor" of old mod code:

1. **Read Migration Guide:** You MUST first read `references/migration-guide.md`.
2. **Extract Core Logic:** 

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
2619 chars