Minecraft Modding (Fabric/Java) Cheat Sheet

🗂️ Project Structure

🍎 Registering an Item

public class ModItems {
    public static final Item RUBY =
        Registry.register(
            Registries.ITEM,
            new Identifier("mymod", "ruby"),
            new Item(new Item.Settings())
        );

    public static void registerItems() {
        // called from onInitialize()
    }
}

Every registered item needs a unique Identifier namespace + path.

🧱 Registering a Block

public static final Block RUBY_BLOCK =
    Registry.register(
        Registries.BLOCK,
        new Identifier("mymod", "ruby_block"),
        new Block(AbstractBlock.Settings.create()
            .strength(4.0f)
            .requiresTool())
    );

// give the block an item form so it appears in the inventory
Registry.register(
    Registries.ITEM,
    new Identifier("mymod", "ruby_block"),
    new BlockItem(RUBY_BLOCK, new Item.Settings())
);

🖼️ Textures & Models

🐲 Custom Mobs

public class RubyGolemEntity extends HostileEntity {
    public RubyGolemEntity(EntityTypeextends HostileEntity> type, World world) {
        super(type, world);
    }
}

// register the entity type
public static final EntityType RUBY_GOLEM =
    Registry.register(
        Registries.ENTITY_TYPE,
        new Identifier("mymod", "ruby_golem"),
        EntityType.Builder.create(RubyGolemEntity::new, SpawnGroup.MONSTER)
            .dimensions(0.9f, 2.2f)
            .build()
    );

🎁 Loot Tables

{
  "type": "minecraft:block",
  "pools": [
    {
      "rolls": 1,
      "entries": [
        {
          "type": "minecraft:item",
          "name": "mymod:ruby"
        }
      ],
      "conditions": [
        { "condition": "minecraft:survives_explosion" }
      ]
    }
  ]
}

Save under data/modid/loot_tables/blocks/name.json.

📡 Events

// listen for block break
PlayerBlockBreakEvents.AFTER.register((world, player, pos, state, blockEntity) -> {
    if (!world.isClient) {
        player.sendMessage(Text.of("Block broken!"), true);
    }
});

// listen for server tick
ServerTickEvents.END_SERVER_TICK.register(server -> {
    // runs once per tick on the server
});

Fabric API events use a static .register() call inside onInitialize().