Cómo Crear Tu Primer Mod de Terraria en 2025

Lo que Aprenderás

• Configurar tu entorno de desarrollo
• Crear una espada personalizada con propiedades únicas
• Entender la API de C# de tModLoader
• Probar y depurar tu mod
• Publicar en Steam Workshop

Requisitos Previos

Conocimientos Requeridos

• Programación básica de C# (variables, methods, classes)
• Familiaridad con la jugabilidad de Terraria
• Comprensión básica de programación orientada a objetos

Software Requerido

• tModLoader instalado y funcionando
• Visual Studio 2022 (recomendado) o VS Code
• .NET 6.0 SDK or later

Paso 1: Configuración del Entorno de Desarrollo

Crear tu Plantilla de Mod

Inicia tModLoader and go to "Workshop" → "Develop Mods"
Click "Create Mod"
Ingresa el nombre de tu mod (ej., "MyFirstMod" - ¡sin espacios!)
Completa el nombre del autor y la descripción
Click "Create"

Esto crea una plantilla de mod en tu carpeta ModSources con todos los archivos necesarios.

Paso 2: Crear una Espada Personalizada

Vamos a crear una espada personalizada simple pero efectiva. Esto te enseñará los fundamentos de la creación de objetos.

Crear la Clase del Objeto

Create a new file: 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();
        }
    }
}

Entender el Código

SetDefaults(): Define todas las propiedades del objeto como daño, tamaño y comportamiento
AddRecipes(): Crea recetas de crafteo para tu objeto
DamageClass.Melee: Hace que escale con bonificaciones de daño cuerpo a cuerpo
ItemRarityID.Green: Establece el color de rareza (afecta el color del nombre del objeto)

Paso 3: Compilar y Probar

Using Build + Reload

La mejor función de tModLoader para desarrolladores es el sistema "Build + Reload" que te permite probar cambios al instante:

In tModLoader, go to "Workshop" → "Develop Mods"
Find your mod and click "Build + Reload"
Espera la compilación (debería tomar 5-10 segundos)
Tu mod se recarga automáticamente con los cambios
¡Prueba tu nueva espada en el juego!

Probar tu Espada

Para probar tu nueva espada:

1. Abre tu inventario y verifica si puedes fabricarla (necesitarás barras de hierro y madera)
2. Fabrica la espada y prueba su daño en enemigos
3. Verifica que el efecto de sonido y la animación funcionen correctamente
4. Verifica la funcionalidad de auto-swing

Añadir Funciones Avanzadas

Efectos Personalizados al Golpear

Vamos a añadir un efecto especial cuando tu espada golpea a un enemigo:

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);
    }
}

Esto añade un 20% de probabilidad de prender fuego a los enemigos y crea efectos de partículas de fuego al golpear.

Tooltip Personalizado

Añade texto personalizado al tooltip de tu objeto:

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);
}

Publicar Tu Mod

Publicar en Steam Workshop

Asegúrate de que tu mod se compile sin errores
Añade un archivo icon.png (64x64 píxeles) a tu carpeta de mod
Escribe un buen description.txt explicando qué hace tu mod
In "Develop Mods", click "Publish" next to your mod
Completa el formulario de Steam Workshop con etiquetas y descripción
Sube capturas de pantalla mostrando tu mod en acción
Click "Publish" to make it live!

Consejos para Publicar con Éxito

• Escribe descripciones claras y detalladas
• Incluye capturas de pantalla de alta calidad
• Usa etiquetas relevantes para ser descubierto
• Prueba a fondo antes de publicar
• Responde a los comentarios y sugerencias de los usuarios

¡Felicidades! ¡Ahora Eres un Desarrollador de Mods!

¡Has creado tu primer mod de Terraria! Esto es solo el comienzo - la API de tModLoader puede hacer cosas increíbles. Explora NPCs, proyectiles, bloques y generación de mundos a continuación.

Advanced Development API Reference