Guia de Desenvolvimento de Mods
Aprenda a criar mods incríveis de Terraria com a API C# do tModLoader
Pré-requisitos
Ambiente de Desenvolvimento
- • Visual Studio 2022 (recomendado)
- • JetBrains Rider
- • Visual Studio Code com extensão C#
- • .NET 6.0 SDK ou posterior
Conhecimentos Necessários
- • Programação básica em C#
- • Conceitos de orientação a objetos
- • Familiaridade com a jogabilidade do Terraria
- • Compreensão básica de desenvolvimento de jogos
Configuração de Desenvolvimento
1 Instalar Ferramentas de Desenvolvimento
Escolha seu ambiente de desenvolvimento C# preferido:
2 Criar Seu Primeiro Mod
Use as ferramentas integradas do tModLoader para criar um template de mod:
- Inicie o tModLoader e vá em "Workshop" → "Develop Mods"
- Clique em "Create Mod" e insira os detalhes do seu mod
- Escolha um nome único para o mod (sem espaços ou caracteres especiais)
- Clique em "Create" para gerar o template do mod
Isso cria uma estrutura básica de mod na sua pasta ModSources com todos os arquivos necessários.
Estrutura Básica do Mod
Todo mod do tModLoader segue uma estrutura padrão:
YourModName/
├── build.txt # Metadados e dependências do mod
├── description.txt # Descrição do mod para o navegador
├── icon.png # Ícone do mod (64x64 recomendado)
├── YourModName.cs # Classe principal do mod
├── Items/ # Itens personalizados
├── NPCs/ # NPCs personalizados
├── Projectiles/ # Projéteis personalizados
├── Tiles/ # Blocos personalizados
├── Walls/ # Paredes personalizadas
├── Buffs/ # Buffs/debuffs personalizados
└── Sounds/ # Arquivos de áudio personalizadosExemplo de Classe do Mod
Aqui está uma estrutura básica de classe de mod:
using Terraria.ModLoader;
namespace YourModName
{
public class YourModName : Mod
{
public override void PostSetupContent()
{
// Code that runs after all mods are loaded
}
public override void PostUpdateInput()
{
// Code that runs every frame
}
public override void Unload()
{
// Cleanup code when mod is unloaded
}
}
}Configuração do build.txt
O arquivo build.txt contém metadados importantes sobre seu mod:
displayName = Your Mod Name
author = Your Name
version = 1.0.0
modReferences =
buildIgnore = *.csproj, *.user, *.suo, bin/, obj/, .vs/
homepage = https://github.com/yourusername/yourmod
description = A brief description of what your mod doesCriando Seu Primeiro Item
Vamos criar uma espada personalizada simples como seu primeiro item:
Criar a Classe do Item
Crie um novo arquivo: Items/ExampleSword.cs
using Terraria;
using Terraria.ID;
using Terraria.ModLoader;
namespace YourModName.Items
{
public class ExampleSword : ModItem
{
public override void SetDefaults()
{
// Basic item properties
Item.damage = 50;
Item.DamageType = DamageClass.Melee;
Item.width = 40;
Item.height = 40;
Item.useTime = 20;
Item.useAnimation = 20;
Item.useStyle = ItemUseStyleID.Swing;
Item.knockBack = 6;
Item.value = Item.buyPrice(gold: 1);
Item.rare = ItemRarityID.Green;
Item.UseSound = SoundID.Item1;
Item.autoReuse = true;
}
public override void AddRecipes()
{
Recipe recipe = CreateRecipe();
recipe.AddIngredient(ItemID.IronBar, 10);
recipe.AddIngredient(ItemID.Wood, 5);
recipe.AddTile(TileID.Anvils);
recipe.Register();
}
}
}Adicionar Textura do Item
Crie uma imagem PNG de 40x40 pixels e salve como:
Items/ExampleSword.png
O nome do arquivo deve corresponder exatamente ao nome da classe.
Compilar e Testar Seu Mod
Fluxo de Build + Reload
O poderoso recurso de desenvolvimento do tModLoader permite testar alterações instantaneamente:
- No tModLoader, vá em "Workshop" → "Develop Mods"
- Encontre seu mod na lista e clique em "Build + Reload"
- Aguarde a compilação ser concluída
- Seu mod será recarregado automaticamente com as alterações
- Teste seu novo item no jogo
Dica: Use "Build + Reload" frequentemente durante o desenvolvimento. É muito mais rápido do que reiniciar o jogo!
Erros Comuns de Build
- Textura faltando: Certifique-se de que o arquivo PNG corresponde exatamente ao nome da classe
- Erros de compilação: Verifique a sintaxe e declarações using
- Referências faltando: Verifique se as referências do ModLoader estão corretas
- Erros no build.txt: Verifique a formatação dos metadados do mod
Tópicos Avançados de Desenvolvimento
Publicando Seu Mod
Publicando na Steam Workshop
- Certifique-se de que seu mod compila sem erros
- Vá em "Workshop" → "Develop Mods"
- Clique em "Publish" ao lado do seu mod
- Preencha o formulário da Steam Workshop com descrição e tags
- Envie capturas de tela e defina a visibilidade
- Clique em "Publish" para publicar
Seu mod ficará disponível no navegador de mods dentro de alguns minutos após a publicação.
Boas Práticas para Publicação
Diretrizes de Conteúdo
- Escreva descrições claras e detalhadas
- Inclua capturas de tela de alta qualidade
- Teste completamente antes de publicar
- Documente problemas conhecidos
Requisitos Técnicos
- Sem erros ou avisos de compilação
- Verificação adequada de null
- Teste de compatibilidade multiplayer
- Otimização de desempenho