Como Criar Seu Primeiro Mod de Terraria em 2025

O que Você Vai Aprender

• Configurar seu ambiente de desenvolvimento
• Criar uma espada personalizada com propriedades únicas
• Entender a API C# do tModLoader
• Testar e depurar seu mod
• Publicar na Steam Workshop

Pré-requisitos

Conhecimento Necessário

• Programação básica em C# (variáveis, métodos, classes)
• Familiaridade com a jogabilidade do Terraria
• Entendimento básico de programação orientada a objetos

Software Necessário

• tModLoader instalado e funcionando
• Visual Studio 2022 (recomendado) ou VS Code
• .NET 6.0 SDK ou posterior

Passo 1: Configuração do Ambiente de Desenvolvimento

Criando o Template do Seu Mod

Inicie o tModLoader e vá para "Workshop" → "Desenvolver Mods"
Clique em "Criar Mod"
Digite o nome do seu mod (ex: "MyFirstMod" - sem espaços!)
Preencha o nome do autor e a descrição
Clique em "Criar"

Isso cria um template de mod na sua pasta ModSources com todos os arquivos necessários.

Passo 2: Criando uma Espada Personalizada

Vamos criar uma espada personalizada simples mas eficaz. Isso vai ensinar os fundamentos da criação de itens.

Criar a Classe do Item

Crie um novo arquivo: Items/BeginnerSword.cs

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

namespace MyFirstMod.Items
{
    public class BeginnerSword : ModItem
    {
        public override void SetDefaults()
        {
            // Basic item properties
            Item.damage = 45;                    // Damage value
            Item.DamageType = DamageClass.Melee; // Damage type
            Item.width = 40;                     // Hitbox width
            Item.height = 40;                    // Hitbox height
            Item.useTime = 20;                   // Use speed
            Item.useAnimation = 20;              // Animation speed
            Item.useStyle = ItemUseStyleID.Swing;// How it's used
            Item.knockBack = 6;                  // Knockback strength
            Item.value = Item.buyPrice(gold: 2); // Sell value
            Item.rare = ItemRarityID.Green;      // Rarity color
            Item.UseSound = SoundID.Item1;       // Use sound
            Item.autoReuse = true;               // Can auto-swing
        }

        public override void AddRecipes()
        {
            Recipe recipe = CreateRecipe();
            recipe.AddIngredient(ItemID.IronBar, 15);
            recipe.AddIngredient(ItemID.Wood, 10);
            recipe.AddTile(TileID.Anvils);
            recipe.Register();
        }
    }
}

Entendendo o Código

SetDefaults(): Define todas as propriedades do item como dano, tamanho e comportamento
AddRecipes(): Cria receitas de criação para seu item
DamageClass.Melee: Faz escalar com bônus de dano melee
ItemRarityID.Green: Define a cor de raridade (afeta a cor do nome do item)

Passo 3: Compilar e Testar

Usando Build + Reload

O melhor recurso do tModLoader para desenvolvedores é o sistema "Build + Reload" que permite testar mudanças instantaneamente:

No tModLoader, vá para "Workshop" → "Desenvolver Mods"
Encontre seu mod e clique em "Build + Reload"
Aguarde a compilação (deve levar 5-10 segundos)
Seu mod recarrega automaticamente com as mudanças
Teste sua nova espada no jogo!

Testando Sua Espada

Para testar sua nova espada:

1. Abra seu inventário e verifique se pode criá-la (você precisará de barras de ferro e madeira)
2. Crie a espada e teste seu dano em inimigos
3. Verifique se o efeito sonoro e a animação funcionam corretamente
4. Verifique a funcionalidade de auto-ataque

Adicionando Recursos Avançados

Efeitos Personalizados ao Acertar

Vamos adicionar um efeito especial quando sua espada acerta um inimigo:

public override void OnHitNPC(Player player, NPC target, NPC.HitInfo hit, int damageDone)
{
    // 20% chance to inflict fire debuff
    if (Main.rand.NextBool(5))
    {
        target.AddBuff(BuffID.OnFire, 180); // 3 seconds of fire
    }

    // Spawn some visual effects
    for (int i = 0; i < 10; i++)
    {
        Dust.NewDust(target.position, target.width, target.height, DustID.Fire);
    }
}

Isso adiciona uma chance de 20% de incendiar inimigos e cria efeitos de partículas de fogo ao acertar.

Tooltip Personalizado

Adicione texto personalizado ao tooltip do seu item:

public override void ModifyTooltips(List<TooltipLine> tooltips)
{
    TooltipLine line = new TooltipLine(Mod, "CustomTooltip", "A sword forged by a beginner modder!");
    line.OverrideColor = Color.Orange;
    tooltips.Add(line);
}

Publicando Seu Mod

Publicando na Steam Workshop

Certifique-se de que seu mod compila sem erros
Adicione um arquivo icon.png (64x64 pixels) à pasta do seu mod
Escreva um bom description.txt explicando o que seu mod faz
Em "Desenvolver Mods", clique em "Publicar" ao lado do seu mod
Preencha o formulário da Steam Workshop com tags e descrição
Envie capturas de tela mostrando seu mod em ação
Clique em "Publicar" para colocá-lo no ar!

Dicas para uma Publicação de Sucesso

• Escreva descrições claras e detalhadas
• Inclua capturas de tela de alta qualidade
• Use tags relevantes para descoberta
• Teste bem antes de publicar
• Responda ao feedback e comentários dos usuários

Parabéns! Agora Você é um Desenvolvedor de Mods!

Você criou seu primeiro mod de Terraria! Este é apenas o começo - a API do tModLoader pode fazer coisas incríveis. Explore NPCs, projéteis, tiles e geração de mundo a seguir.

Desenvolvimento Avançado Referência da API