Equipment and Stats

Weapons & Armor Design

This document details the categories, stats, and mathematical formulas governing weapons, armor, and weight mechanics in CROSS.

---

⚔️ Weapon Types & Categories

Weapons dictate a character’s base attack style, range, speed, and scaling attributes. They are crafted in the Blacksmith Forge or Fletcher Workshop.

graph TD
    subgraph Weapons
        M[Melee] --- R[Ranged]
        R --- MG[Magical]
    end

    subgraph Melee Subtypes
        M1[One-Handed: Sword/Ax]
        M2[Two-Handed: Greatsword]
        M3[Dagger]
    end

    subgraph Ranged Subtypes
        R1[Longbow]
        R2[Crossbow]
    end

    subgraph Magical Subtypes
        MG1[Staff]
        MG2[Wand + Tome]
    end

1. Melee Weapons

• 🗡️ One-Handed Sword/Ax:
  • Role: Balanced melee. Allows equipping a Shield or Off-hand Tome.
  • Base Speed: $1.2\text{s}-1.5\text{s}$ interval.
  • Scaling: Primarily Strength (STR) with minor Agility (AGI).
• 🪓 Two-Handed Greatsword/Greatax:
  • Role: High raw physical burst damage. Occupies both hand slots.
  • Base Speed: Slow ($1.8\text{s}-2.5\text{s}$ interval). High weight.
  • Scaling: Pure Strength (STR).
• 🔪 Dagger:
  • Role: Rapid attacks, high critical damage. Rogue favorite.
  • Base Speed: Extremely fast ($0.6\text{s}-0.9\text{s}$ interval). Very low weight.
  • Scaling: Pure Agility (AGI).

2. Ranged Weapons

• 🏹 Longbow:
  • Role: Standard physical ranged DPS. Occupies both hand slots.
  • Base Speed: Moderate ($1.2\text{s}-1.6\text{s}$ interval).
  • Scaling: Agility (AGI).
• 🏹 Crossbow:
  • Role: Heavy ranged physical pierce damage. Slow reload.
  • Base Speed: Very slow ($2.0\text{s}-2.8\text{s}$ interval). High weight.
  • Scaling: Agility (AGI) with minor Strength (STR).

3. Magical Weapons

• 🧙 Wizard Staff:
  • Role: Two-handed magical scaling. Boosts spell range and power.
  • Base Speed: Slow ($1.6\text{s}-2.0\text{s}$ interval).
  • Scaling: Pure Intelligence (INT).
• 🪄 Wand & Catalyst/Tome:
  • Role: One-handed casting. High utility, speeds up spellcasting.
  • Base Speed: Fast ($1.0\text{s}-1.3\text{s}$ interval).
  • Scaling: Intelligence (INT) and Agility (AGI).

---

🛡️ Armor Categories & Slots

Characters have three core armor slots: Head (Hat/Helmet), Chest (Armor/Robe/Coat), and Lower (Pants/Boots/Greaves as a single visual slot). Armor comes in three classes, affecting defense, weight, and stat orientations.

Armor Class	Eligible Classes	Core Stat Focus	Mitigation Profile	Weight
Cloth	Mage, Priest	Intelligence (INT)	Low physical defense, high spell warding.	Very Light
Leather	Rogue, Archer	Agility (AGI)	Moderate physical defense, moderate spell ward.	Light
Plate	Warrior, Defender	Vitality (VIT)	Extremely high physical defense, low spell ward.	Heavy

---

📊 Core Equipment Stats

Every weapon and armor piece possesses the following parameters stored in the master database:

Weapon Properties

• weapon_type: Enum (Sword, Greatsword, Dagger, Bow, Crossbow, Staff, Wand).
• min_dmg / max_dmg: The base physical or magical damage range before stat modifiers.
• base_speed: Attack frequency interval (seconds).
• weight: Floating-point value affecting swing speed.
• attributes: Key-value map of base stat bonuses (e.g. {"str": 5, "vit": 3}).
• quality: Enum (Common, Uncommon, Rare, Epic, Legendary).
• is_hacked: Silent boolean flag (anti-cheat trigger).

Armor Properties

• armor_class: Enum (Cloth, Leather, Plate).
• armor_slot: Enum (Head, Chest, Lower, Shield).
• defense_value: Flat physical mitigation points.
• magic_ward: Flat magical mitigation points.
• weight: Weight value contributing to total body weight.
• attributes: Key-value map of base stat bonuses.
• quality: Enum (Common to Legendary).

---

📐 Weight & Damage Math

To prevent players from wearing heavy plate armor on Mages or executing fast attacks with heavy axes, weight interacts with attributes:

1. The Weapon Swing Penalty

A heavy weapon slows down the attack interval unless the character has high Agility. Strength reduces weight burden, but Agility determines hand speed.

$\text{Final Swing Speed (seconds)}=\text{base\_speed}+\left(\frac{\text{Weapon Weight}}{\text{AGI}}\right)-(\text{STR}\times 0.005)$

• If AGI is low, the weapon weight penalty term $\left(\frac{\text{Weight}}{\text{AGI}}\right)$ bloats the attack interval, making heavy axes slow.
• If STR is high, it offsets the base speed slightly, but AGI remains the primary weight mitigation stat.

2. The Body Weight Penalty (Stamina Drain)

A character’s total equipped armor weight determines their Stamina Drain when performing active skills or running:

$\text{Stamina Cost Modifier}=1.0+\left(\frac{\text{Total Equipped Armor Weight}}{\text{VIT}\times 2.0}\right)$

• If a player wears full heavy plate (high weight) but has low Vitality (VIT), active abilities consume double the stamina, causing them to tire out and go to sleep (AFK state) much faster.

3. Damage Types & Mitigation Math

We define four distinct damage types in the combat loop. Each type interacts differently with player Defense (Armor) and Magic Ward (Magic Resist) values:

1. Physical Damage (Melee hits, arrows, traps):
   • Mitigation: Reduced by the target’s total equipped Defense (Armor).
   • Formula: $\text{Damage Received}=\text{Raw Damage}\times \left(\frac{100}{100+\text{Total Defense}}\right)$
   • Curve: Capped by diminishing returns ($100$ Defense = $50\%$ reduction, $300$ Defense = $75\%$ reduction). High-level hits remain threatening.
2. Elemental Magic Damage (Mage spells like Fireball and Blizzard):
   • Mitigation: Reduced by the target’s total equipped Magic Ward.
   • Formula: $\text{Damage Received}=\text{Raw Damage}\times \left(\frac{100}{100+\text{Total Magic Ward}}\right)$
3. Holy Damage (Priest healing/damaging spells):
   • Mitigation: Reduced by the target’s total equipped Magic Ward.
   • Type Specific Rule: Deals $+50\%$ bonus damage against Undead and Demon type enemies, and heals friendly targets instead of damaging them.
4. Shadow / Direct Damage (Rogue Assassin’s Death Mark, Priest Apostate’s Vampiric Touch):
   • Mitigation: Bypasses all Armor and Magic Ward.
   • Rule: Deals flat, unmitigated damage directly to the health pool. This serves as “True Damage” in combat math, making it highly effective against heavily armored tanks or high-ward magical bosses.