Skip to content

Make your first Fabric mod with Linen

To make a Fabric mod in Linen, press New mod, give it a name, pick Fabric 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, Fabric Loader and Fabric API.
  • Some Java, or the wish to learn it. You write the mod’s behaviour in Java. Linen explains the names as you go.

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 Fabric, 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.

The mod uses Mojang’s names. The exact versions of Java, Gradle and Loom for each Minecraft version are in Set up a Fabric 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.

The first Play takes the longest, because Gradle downloads Minecraft then.

Open the mod’s files. The template comes with one example block, so the mod already does something:

src/main/java/<your package>/
├── RubyMod.java the main class (the entrypoint)
└── registry/
├── ModBlocks.java the example block is registered here
├── ModItems.java
└── ModCreativeTabs.java
src/main/resources/
├── fabric.mod.json the mod's id, name, entrypoint and dependencies
├── assets/<mod id>/ blockstates, models, textures, lang
└── data/<mod id>/ loot tables, recipes

Open ModBlocks.java and hover a name such as Registry or BlockBehaviour.Properties. Linen shows a card that explains the name after a moment. You can switch the card off in Settings.

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).