Items

Mods add three kinds of items, each starting as a copy of one of the game's - its stats, sprites, sounds and behaviour - under the mod's own name, changing what they like:

Every game item has a generated class in StoneForge.GameItems to inherit, named after it (DrifterSword, LinenShirt, Wine).

A weapon

using StoneForge;
using StoneForge.GameItems;

public class ExampleBlade : DrifterSword
{
    public ExampleBlade() : base("Example Blade")
    {
        Description = "A blade made in C#.";
        InventorySprite = "blade_inv.png";     // Assets\blade_inv.png
        LootSprite = "blade_loot.png";
        Set(WeaponColumn.Slashing_Damage, 40);
        Set(WeaponColumn.CRT, 15);
        Set(WeaponColumn.Price, 999);
    }

    protected override void OnEquip(Item item) => Context.Log("Drawn");

    // While it's on: a point of durability back each turn.
    protected override void OnEquippedTurn(Item item)
    {
        if (item.Durability < item.MaxDurability)
            item.Durability += 1;
    }

    // A blow that lands.
    protected override void OnHit(Item item, Attack attack)
    {
        if (attack.Result == AttackResult.Crit)
            attack.DealExtraDamage(5);
    }
}

Add it in Load, and give it to the player:

var blade = new ExampleBlade();
context.Items.Add(blade);
// later, in game:
context.Items.Give(blade);

Once the game has loaded its item tables, a mod's item is like the game's own: it can be given, sold, worn, saved, and found in loot if InRandomLoot is set.

Armour

public class ExampleShirt : LinenShirt
{
    public ExampleShirt() : base("Example Shirt")
    {
        Description = "A linen shirt dyed blue in C#.";
        InventorySprite = "shirt_inv.png";
        InventoryFrames = 2;
        LootSprite = "shirt_loot.png";
        WornSprite = "shirt_worn.png";               // on the character: 48x40 frames
        WornSpriteFemale = "shirt_worn_female.png";
        CorpseSprite = "shirt_corpse.png";
        Set(ArmorColumn.DEF, 3);
        Set(ArmorColumn.Magic_Resistance, 10);
    }

    protected override void OnHitTaken(Item item, Attack attack) => Context.Log($"Took {attack.Damage:0}");
}

Weapons and armour: ModItem

Set(WeaponColumn..., value) / Set(ArmorColumn..., value) change its stats: the columns are generated from the game's tables.

Each event gets the Item it happened to:

Consumables

public class ExampleTonic : Wine
{
    public ExampleTonic() : base("tonic")
    {
        DisplayName = "Example Tonic";
        Description = "A teal tonic: it soothes wounds.";
        InventorySprite = "tonic_inv.png";
        LootSprite = "tonic_loot.png";
        Set(ConsumableColumn.Health_Restoration, 15);
        Set(ConsumableColumn.Price, 120);
    }

    // As it's drunk: this, then the game item's own effect.
    protected override void OnUse(Instance item) => Context.Log("Drunk!");
}

Giving and querying

To give items with values of their own (a condition, a mod's data), take them away, or put them in chests, see Inventory and containers.