创建物品
学习如何使用 ModItem API 创建自定义物品、武器和配件。请确保您已先完成开发环境设置。
基础物品示例
以下是创建自定义剑的简单示例：
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();
}
}
}
物品属性详解
所有常用物品属性的完整参考：
damage
修正前的基础伤害值
Item.damage = 50;
DamageType
近战、远程、魔法、召唤、投掷
Item.DamageType = DamageClass.Melee;
useTime
使用间隔帧数（越低越快）
Item.useTime = 20;
useAnimation
动画持续时间（通常 = useTime）
Item.useAnimation = 20;
rare
稀有度等级（-1 到 11，影响颜色）
Item.rare = ItemRarityID.Blue;
knockBack
击退力度（通常 0-20）
Item.knockBack = 6;
width / height
碰撞箱大小（像素）
Item.width = 40; Item.height = 40;
value
售价（铜币，100 = 1 银币）
Item.value = Item.sellPrice(gold: 1);
更多物品示例
创建远程武器
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; // Important for guns
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;
}
}
创建配件
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; // Makes it an accessory
}
public override void UpdateAccessory(Player player, bool hideVisual)
{
player.moveSpeed += 0.1f; // +10% movement speed
player.maxRunSpeed += 1f;
player.GetDamage(DamageClass.Generic) += 0.05f; // +5% all damage
}
}