Skip to content

Make your first NeoForge mod with Linen

To make a NeoForge mod in Linen, press New mod, give it a name, pick NeoForge and a Minecraft version, and press Make the mod. Linen finds or downloads the Java that version needs and builds the mod. The first Play downloads Minecraft and starts the game.

Checked against Linen 0.2.1 on 20 November 2026. Linen is in private beta: join it here.

Want the same steps without Linen? Read How to make a Minecraft mod.

  • Linen, on Windows 10 or 11, a Mac with Apple silicon, or 64-bit Linux.
  • An internet connection for the first setup. Linen downloads Java, Minecraft and NeoForge.
  • Some Java, or the wish to learn it.

You don’t need to install Java or Gradle yourself, and you don’t need an AI account.

  1. On Home, press New mod.
  2. Type a name, such as Ruby Mod. Linen fills in the mod id, the Java package and the author, and you can change them.
  3. Under Loader choose NeoForge, and under Minecraft choose 1.21.1. This guide uses 1.21.1 because every how-to in the how-to library has a version for it.
  4. Look at What Linen will make beside the form. It lists what the project will contain.
  5. Press Make the mod.

What the NeoForge 1.21.1 project uses, from Linen’s template:

Part Value
Java 21
Gradle 9.2.1, running on Java 21
Gradle plugin net.neoforged.moddev (ModDevGradle)
Names in code Mojang’s names with Parchment’s parameter names and javadocs (the default), or Mojang names alone

Other Minecraft versions use other numbers. They are all in Set up a NeoForge mod.

Linen opens the mod, and Getting started on Home lists what the mod needs: Java for Linen’s code help, Java for this mod, the first Play that prepares the game, Git, and Claude Code (optional). Each line has a button when something is missing, such as Get Java.

NeoForge sets Minecraft up on your machine during the first Play, and that is the slow part. NeoForge’s own docs warn that a first load can take a long time, so let it run.

Open the mod’s files. A NeoForge project has the same src/main/java, assets and data folders as a Fabric one. These parts differ:

  • The mod’s metadata is META-INF/neoforge.mods.toml. In Linen’s template it sits under src/main/templates/ and is filled in from gradle.properties when you build.
  • The access transformer is src/main/resources/META-INF/accesstransformer.cfg.
  • The mixin config is <mod id>.mixins.json.

The example block is registered in registry/ModBlocks. Hover a name such as DeferredRegister and Linen shows a card that explains what it does.

Press Play (F5), or choose Play the game in Find anything. The first Play lets Gradle download Minecraft and set the game up, which takes a few minutes, once. Later Plays start the game directly. The Game Log shows what the game prints, and Linen’s Problems view lists what is wrong in your code.

In the game, make a creative world and look for your mod’s tab in the creative inventory. The example block is there.

Press Ctrl+P (Cmd+P on a Mac) for Find anything and look for the how-to for a block, or read How to add a block here, which explains every file. The how-to library has the same steps for each loader and version.

You can also ask Claude. If you have Claude Code, open the Claude panel and ask for the block. Claude gets your mod’s loader, version and mappings with each chat, and you accept or reject its changes as a diff. Read Make a Minecraft mod with AI for prompts that work, and Set up AI to connect it.

Linen Check reads the mod the way the game will: registrations, models, loot tables, names, mixins and the build. Each problem names the file and the fix.

When the mod’s folder isn’t in Git yet, Getting started on Home offers Start Git here. Changes then shows what you changed, and Save a version keeps a copy you can go back to.

  • It does not write your mod’s behaviour for you. The template and the how-tos give you working examples, and the idea and the logic are yours.
  • It does not publish your mod. You upload the jar from build/libs/ to Modrinth or CurseForge yourself.
  • Claude Code is optional and runs on your own Claude plan. See Set up AI (optional).