hairyf Minecraft Modding (Java)
Consolidated on 2026-08-10 from the 12 temporary
mc-*development skills (temporarily/skills/mc-*). This is the loader-agnostic workflow layer: it does not repeat content that dedicated skills in this repository already cover, so implementation topics link out to them instead.
This skill covers the shared Minecraft Java mod development workflow: establishing verified project context, adapting vanilla implementations, following a standard implementation and verification checklist, and diagnosing/fixing defects. It applies to Fabric, NeoForge, and Forge projects and is version- and loader-agnostic: always derive APIs from the pinned version and mappings, never from memory or generic snippets.
Standard Workflow
- Audit the repository with core-project-context: exact Minecraft/loader versions, mappings, Java/Gradle toolchain, modules, registration style, side boundaries, and project conventions.
- Find the closest vanilla or in-repo analogue with core-vanilla-reference; copy only patterns compatible with the pinned version and mappings.
- Define observable behavior, server authority, persistence needs, and acceptance checks before editing.
- Implement the smallest coherent vertical slice: registration, class/behavior, resource references, and initialization wiring. Register exactly once; keep client-only code out of common/server initialization.
- Add only applicable assets/data: blockstates, models, loot tables, recipes, tags, advancements, and translations. Prefer data generation over hand-written JSON.
- Keep every user-visible string in
zh_cn,zh_tw, anden_us; derive Traditional Chinese naturally rather than copying Simplified Chinese. - Verify: compile/build, run data generation when configured, launch the narrowest relevant client/server test, and inspect logs rather than relying on exit code alone.
Core References
| Topic | Description | Reference |
|---|---|---|
| Project Context | Audit versions, loader, mappings, source structure, and conventions before coding | core-project-context |
| Vanilla Reference | Find and adapt the closest vanilla implementation from pinned mapped sources | core-vanilla-reference |
| Debug & Fix | Reproduce, diagnose, and fix build, crash, data, networking, and gameplay defects | best-practices-debug-and-fix |
Implementation Topics — Existing Skills
The following topics from the temporary mc-* skills are already covered by dedicated skills in this repository; use those instead of duplicating content here. The fabric skill documents Fabric-specific APIs; for NeoForge or Forge projects apply the same Standard Workflow with that loader's own APIs (no dedicated NeoForge/Forge skill exists here yet).
| Topic | Use skill |
|---|---|
| Blocks & Items | fabric |
| Entities & Mobs | fabric |
| Events & Core Logic | fabric |
| Networking | fabric |
| GUI & Screens | fabric |
| Mixin Injection | fabric |
| Data Generation | fabric |
| World Generation | fabric |
| GeckoLib Animation | geckolib |