Criando Itens

Aprenda a criar itens personalizados, armas e acessórios usando a API ModItem. Certifique-se de ter concluído a configuração de desenvolvimento primeiro.

Exemplo Básico de Item

Aqui está um exemplo simples de criação de uma espada personalizada:

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

namespace YourModName.Items
{
    public class ExampleSword : ModItem
    {
        public override void SetDefaults()
        {
            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 = 10000;
            Item.rare = ItemRarityID.Blue;
        }

        public override void AddRecipes()
        {
            Recipe recipe = CreateRecipe();
            recipe.AddIngredient(ItemID.DirtBlock, 10);
            recipe.AddTile(TileID.WorkBenches);
            recipe.Register();
        }
    }
}

Propriedades de Item Explicadas

Referência completa para todas as propriedades comuns de itens:

damage

Valor de dano base antes dos modificadores

Item.damage = 50;

DamageType

Melee, Ranged, Magic, Summon, Throwing

Item.DamageType = DamageClass.Melee;

useTime

Frames entre usos (menor = mais rápido)

Item.useTime = 20;

useAnimation

Duração da animação (geralmente = useTime)

Item.useAnimation = 20;

rare

Nível de raridade (-1 a 11, afeta a cor)

Item.rare = ItemRarityID.Blue;

knockBack

Força de knockback (0-20 típico)

Item.knockBack = 6;

width / height

Tamanho da hitbox em pixels

Item.width = 40; Item.height = 40;

value

Valor de venda em cobre (100 = 1 prata)

Item.value = Item.sellPrice(gold: 1);

Mais Exemplos de Itens

Criando uma Arma de Longo Alcance

public class ExampleGun : ModItem
{
    public override void SetDefaults()
    {
        Item.damage = 25;
        Item.DamageType = DamageClass.Ranged;
        Item.width = 44;
        Item.height = 24;
        Item.useTime = 10;
        Item.useAnimation = 10;
        Item.useStyle = ItemUseStyleID.Shoot;
        Item.noMelee = true; // Importante para armas de fogo
        Item.knockBack = 2;
        Item.value = Item.sellPrice(silver: 50);
        Item.rare = ItemRarityID.Green;
        Item.UseSound = SoundID.Item11;
        Item.autoReuse = true;
        Item.shoot = ProjectileID.Bullet;
        Item.shootSpeed = 16f;
        Item.useAmmo = AmmoID.Bullet;
    }
}

Criando um Acessório

public class ExampleAccessory : ModItem
{
    public override void SetDefaults()
    {
        Item.width = 24;
        Item.height = 24;
        Item.value = Item.sellPrice(gold: 1);
        Item.rare = ItemRarityID.Orange;
        Item.accessory = true; // Torna um acessório
    }

    public override void UpdateAccessory(Player player, bool hideVisual)
    {
        player.moveSpeed += 0.1f; // +10% velocidade de movimento
        player.maxRunSpeed += 1f;
        player.GetDamage(DamageClass.Generic) += 0.05f; // +5% todo dano
    }
}

Próximos Passos