How to Make a Terraria Mod: Add Items and Crafting Recipes with tModLoader

Based on the Terraria tModLoader 1.4.4 stable development flow, we will create a practice token made from 10 wood. You will learn the roles of C# ModItem, PNG textures, and CreateRecipe. Prepare a separate environment for running vanilla Terraria versus your tModLoader modded worlds and characters.

1. Preparation and Version Check

Install official Terraria and original tModLoader, running them on the same stable branch. Check the developer wiki's Basic Prerequisites and .NET SDK requirements. Current basic instructions use the .NET 8.0 SDK, and the Desktop Runtime alone does not replace development tools. Do not mix outdated 1.3 example item fields or ModRecipe into modern code. Backup your characters, worlds, and existing mods before creating a new test character.

2. Creating a Mod Skeleton in the Game

1. In the tModLoader main menu, select Workshop → Develop Mods → Create Mod.
2. Use a unique internal ModName without spaces, such as TroubleMakerToken.
3. Enter the display name, author, and default item name. The example default item name is set to WorkshopToken.
4. After creation, open the actual ModSources folder via Open Sources in Develop Mods.
5. Open the generated .csproj in the TroubleMakerToken folder in your IDE and wait for necessary dependencies to load.
6. Initially, run Build + Reload once with the generator's original state to verify your development environment.

3. Modifying the Item Class

Replace Content/Items/WorkshopToken.cs with the structure below. If the generator used a different path or namespace, match those names and ensure two identical classes are not created. ModItem defines the new item's behavior, and SetDefaults sets the size, maximum stack, rarity, and more.

using Terraria;
using Terraria.ID;
using Terraria.ModLoader;

namespace TroubleMakerToken.Content.Items;

public class WorkshopToken : ModItem
{
    public override void SetDefaults()
    {
        Item.width = 20;
        Item.height = 20;
        Item.maxStack = 9999;
        Item.value = Item.buyPrice(silver: 1);
        Item.rare = ItemRarityID.White;
    }

    public override void AddRecipes()
    {
        CreateRecipe()
            .AddIngredient(ItemID.Wood, 10)
            .AddTile(TileID.WorkBenches)
            .Register();
    }
}

4. Adding PNG and Display Text

Place WorkshopToken.png in the same Content/Items folder. Modify the practice image included with the generator or use a transparent background PNG you drew yourself. The filename case and path must match the class name. 20×20 is the item collision and display setting, which does not necessarily mean every dimension of the original artwork must be those exact numbers. Starting your first example with a small square image makes alignment verification easy.

TroubleMakerToken/
  TroubleMakerToken.cs
  Content/Items/WorkshopToken.cs
  Content/Items/WorkshopToken.png
  Localization/en-US_Mods.TroubleMakerToken.hjson

Modern tModLoader manages display names and descriptions in HJSON localization. Insert the Items entry below into the generated Localization file or modify existing keys. Do not duplicate the same Mods root in the entire file; edit based on the generator structure.

Mods: {
  TroubleMakerToken: {
    Items: {
      WorkshopToken: {
        DisplayName: Workshop Token
        Tooltip: A token for learning how to create a mod.
      }
    }
  }
}

5. Building and Crafting In-Game

1. Save your modified code and run Build + Reload in Develop Mods.
2. If an error occurs, check the filename and line number of the first compilation error.
3. Verify that your mod is enabled in the mod list and enter a new test world.
4. Prepare 10 wood and a Work Bench, then open the crafting menu near the Work Bench.
5. Craft the Workshop Token and check wood consumption, item stack, name, and description.
6. If the texture is not visible, check the actual path and letter casing of the PNG and run Build + Reload again.

6. Most Common Failures and Troubleshooting

If the recipe does not appear, check whether you are near a work bench and correctly entered ItemID.Wood and TileID.WorkBenches. If you changed the namespace, clean up duplicate generated classes and match the image path accordingly. Disabling the mod will load saves without mod items, so do not apply this directly to actual gameplay saves. Exit the game, disable the mod, and compare using a separate backed-up test world.

7. Check before Workshop Sharing

Explain duplicate internal ModNames, stable version, crafting materials and work bench requirements, and the source of the original artwork. Since tModLoader's Publish function is a public upload, organize the distribution ZIP, README, and test results before using it. This guide explains the creation process and does not automatically upload to readers' accounts. When modifying and sharing other people's game assets or item mods, follow the original creator's permission and conditions.

Original Documents and Verification Criteria

Introductory guide written by the TroubleMaker operations team, verified against creator and official tool documentation on October 7, 2026. Code and diagrams are custom examples for explanation purposes and do not represent verified actual gameplay of the game on this server. Verify and distribute using a separate test save with the versions specified in the text. Compare the latest tool versions and dependencies from the original sources below:

tModLoader 기본 제작 가이드

tModLoader 제작 준비

tModLoader 자체 예제 모음

tModLoader 번역·표시 문구