アイテムの作成

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

次のステップ