Créer des Objets
Apprenez à créer des objets personnalisés, des armes et des accessoires en utilisant l'API ModItem. Assurez-vous d'avoir terminé la configuration du développement au préalable.
Exemple d'Objet Basique
Voici un exemple simple de création d'une épée personnalisée :
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();
}
}
}
Propriétés des Objets Expliquées
Référence complète pour toutes les propriétés courantes des objets :
damage
Valeur de dégâts de base avant les modificateurs
Item.damage = 50;
DamageType
Melee, Ranged, Magic, Summon, Throwing
Item.DamageType = DamageClass.Melee;
useTime
Frames entre les utilisations (plus bas = plus rapide)
Item.useTime = 20;
useAnimation
Durée de l'animation (généralement = useTime)
Item.useAnimation = 20;
rare
Niveau de rareté (-1 à 11, affecte la couleur)
Item.rare = ItemRarityID.Blue;
knockBack
Force de recul (0-20 typique)
Item.knockBack = 6;
width / height
Taille de la hitbox en pixels
Item.width = 40; Item.height = 40;
value
Valeur de vente en cuivre (100 = 1 argent)
Item.value = Item.sellPrice(gold: 1);
Plus d'Exemples d'Objets
Créer une Arme à Distance
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 pour les armes à feu
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;
}
}
Créer un Accessoire
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; // En fait un accessoire
}
public override void UpdateAccessory(Player player, bool hideVisual)
{
player.moveSpeed += 0.1f; // +10% vitesse de déplacement
player.maxRunSpeed += 1f;
player.GetDamage(DamageClass.Generic) += 0.05f; // +5% tous les dégâts
}
}