Minecraft NeoForge Mod Development

Guide NeoForge mod setup, migration, and registration patterns for 1.21+.

4|Updated Apr 25, 2026
One-click install
npx skills add https://github.com/mrquentin/minecraft-skills --skill minecraft-neoforge-mod-development
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Minecraft NeoForge Mod Development
Source: https://github.com/mrquentin/minecraft-skills/tree/main/skills/minecraft-neoforge
Command: npx skills add https://github.com/mrquentin/minecraft-skills --skill minecraft-neoforge-mod-development

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

NeoForge mod development and migration can be complex; this guide provides structured best practices, project setup, and patterns for building NeoForge mods (1.21+).

Core Features & Use Cases

  • Guides MDK setup (ModDevGradle or NeoGradle), Gradle properties, and project structure for NeoForge mods.
  • Explains data storage with attachments, data components for items, CustomPacketPayload networking, and registration patterns with DeferredRegister-like helpers.
  • Provides migration guidance from Forge to NeoForge, best practices for side logic, and testing workflows (build, runData, and run clients/servers).

Quick Start

Create a new NeoForge mod project with ModDevGradle and implement your first mod using the patterns described.

Frequently Asked Questions about Minecraft NeoForge Mod Development

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

FAQPage Schema
How do I set up a NeoForge mod project using ModDevGradle?

To set up a NeoForge mod project, configure ModDevGradle within your Gradle build script to establish the necessary project structure, manage dependencies, and establish the baseline environment for 1.21+ development. This provides structured best practices and templates for your modding workflow.

What is the best way to migrate a Minecraft mod from Forge to NeoForge?

Migrating a Minecraft mod from Forge to NeoForge involves adapting your registration patterns to DeferredRegister-like helpers, switching to CustomPacketPayload for networking, and implementing data attachments for storage. This guide provides structured migration steps for 1.21+ projects.

How does networking work in NeoForge using CustomPacketPayload?

Networking in NeoForge utilizes CustomPacketPayload to handle client-server communication. You define payload classes to serialize and deserialize data, replacing older Forge SimpleChannel methods with modern, structured packet handling for 1.21+.

Can I use data attachments for custom data storage in NeoForge?

Yes, data attachments are the NeoForge mechanism for custom data storage. They allow you to safely append persistent or temporary data to existing game objects like entities or chunks, replacing the old Forge capability system.

Does NeoForge support data generation for items and registries?

NeoForge supports data generation through Gradle tasks like runData. This automates the creation of JSON files for items, blocks, and registries, streamlining asset and data production within your ModDevGradle or NeoGradle project workflow.