Project Structure 1.21.1

An overview of the structure of a Fabric mod project.

WARNING

This page is written for version 1.21.1. Documentation for older versions may be incomplete.

This page will go over the structure of a Fabric mod project, and the purpose of each file and folder in the project.

fabric.mod.json

The fabric.mod.json file is the main file that describes your mod to Fabric Loader. It contains information such as the mod's ID, version, and dependencies.

The most important fields in the fabric.mod.json file are:

• id: The mod's ID, which should be unique.
• name: The mod's name.
• environment: The environment that your mod runs in, such as client, server, or * for both.
• entrypoints: The entrypoints that your mod provides, such as main or client.
• depends: The mods that your mod depends on.
• mixins: The mixins that your mod provides.

You can see an example fabric.mod.json file below - this is the fabric.mod.json file for the reference project that powers this documentation site.

Reference Project fabric.mod.json

{
  "schemaVersion": 1,
  "id": "example-mod",
  "version": "1.0.0",
  "name": "Example Mod",
  "icon": "assets/example-mod/icon.png",
  "environment": "*",
  "entrypoints": {
    "main": [
      "com.example.docs.ExampleMod",
      "com.example.docs.event.ExampleModEvents",
      "com.example.docs.command.ExampleModCommands",
      "com.example.docs.effect.ExampleModEffects",
      "com.example.docs.potion.ExampleModPotions",
      "com.example.docs.sound.ExampleModSounds",
      "com.example.docs.damage.ExampleModDamageTypes",
      "com.example.docs.item.ExampleModItems",
      "com.example.docs.enchantment.ExampleModEnchantments",
      "com.example.docs.block.ExampleModBlocks",
      "com.example.docs.block.entity.ExampleModBlockEntities",
      "com.example.docs.component.ExampleModComponents",
      "com.example.docs.advancement.ExampleModDatagenAdvancement",
      "com.example.docs.networking.ExampleModNetworking"
    ],
    "client": [
      "com.example.docs.ExampleModClient",
      "com.example.docs.client.command.ExampleModClientCommands",
      "com.example.docs.ExampleModDynamicSound",
      "com.example.docs.ExampleModBlockEntityRenderer"
    ],
    "fabric-datagen": [
      "com.example.docs.datagen.ExampleModDataGenerator"
    ]
  },
  "mixins": [
    "example-mod.mixins.json",
    {
      "config": "example-mod.client.mixins.json",
      "environment": "client"
    }
  ],
  "depends": {}
}

Entrypoints

As mentioned before, the fabric.mod.json file contains a field called entrypoints - this field is used to specify the entrypoints that your mod provides.

The template mod generator creates both a main and client entrypoint by default:

• The main entrypoint is used for common code, and it's contained in a class which implements ModInitializer
• The client entrypoint is used for client-specific code, and its class implements ClientModInitializer

These entrypoints are called respectively when the game starts.

Here's an example of a simple main entrypoint that logs a message to the console when the game starts:

public class ExampleMod implements ModInitializer {
	// This logger is used to write text to the console and the log file.
	// It is considered best practice to use your mod id as the logger's name.
	// That way, it's clear which mod wrote info, warnings, and errors.
	public static final String MOD_ID = "example-mod";
	public static final Logger LOGGER = LoggerFactory.getLogger(MOD_ID);

	@Override
	public void onInitialize() {
		// This code runs as soon as Minecraft is in a mod-load-ready state.
		// However, some things (like resources) may still be uninitialized.
		// Proceed with mild caution.

		LOGGER.info("Hello Fabric world!");
	}
}

src/main/resources

The src/main/resources folder is used to store the resources that your mod uses, such as textures, models, and sounds.

It's also the location of fabric.mod.json and any mixin configuration files that your mod uses.

Assets are stored in a structure that mirrors the structure of resource packs - for example, a texture for a block would be stored in assets/example-mod/textures/block/block.png.

src/client/resources

The src/client/resources folder is used to store client-specific resources, such as textures, models, and sounds that are only used on the client side.

src/main/java

The src/main/java folder is used to store the Java source code for your mod - it exists on both the client and server environments.

src/client/java

The src/client/java folder is used to store client-specific Java source code, such as rendering code or client-side logic - such as block color providers.