aboutsummaryrefslogtreecommitdiff
path: root/skill_plans/combat.md
diff options
context:
space:
mode:
Diffstat (limited to 'skill_plans/combat.md')
-rw-r--r--skill_plans/combat.md3402
1 files changed, 0 insertions, 3402 deletions
diff --git a/skill_plans/combat.md b/skill_plans/combat.md
deleted file mode 100644
index 67037d6..0000000
--- a/skill_plans/combat.md
+++ /dev/null
@@ -1,3402 +0,0 @@
-# Combat System Overhaul — OSRS-Style Attack Types & Per-Type Defense
-
-## 1. Overview
-
-The current combat system uses a single `attack_bonus` / `defense_bonus` per item, ignoring attack types entirely. OSRS uses per-type accuracy bonuses (stab/slash/crush/ranged/magic) and per-type defense bonuses. This overhaul brings the game's combat inline with OSRS mechanics while adapting the naming to the sci-fi theme (Science replaces Magic, Technology replaces Prayer).
-
-**What changes:**
-- `ItemStats` struct: 5 attack bonuses, 5 defense bonuses, 4 damage bonuses (14 fields total)
-- Weapons get an `attack_type` field (stab/slash/crush/ranged/science)
-- Mobs get per-type defense bonuses and attack bonuses
-- Combat formulas use the true OSRS accuracy formula (not the current binary hit/miss)
-- `formulas.go` rewritten with proper OSRS accuracy curve
-- `cmd_attack.go` updated to use per-type bonuses for both player and mob attacks
-- Mobs get an `attack_type` field (default "crush")
-- New `stats` command shows total equipment bonuses
-- `look <item>` shows per-type combat stats
-- All ~66 combat item YAMLs updated with per-type stats
-- All 5 mob YAMLs updated with per-type defense/attack bonuses
-- 8 new example mob YAMLs for varied combat encounters
-
-**What stays the same:**
-- 4 attack styles (accurate/aggressive/defensive/balanced) — style determines level bonus
-- XP distribution formula (dmg * 4, split by style)
-- Death mechanics, flee mechanics, combat timing/tick system
-- WeaponType enum (melee/ranged/science) — still used for equip text + XP routing
-- Player combat level formula
-
----
-
-## 2. ItemStats Struct
-
-**File:** `internal/object/item.go:67-73`
-
-**Current:**
-```go
-type ItemStats struct {
- AttackBonus int `yaml:"attack_bonus"`
- StrengthBonus int `yaml:"strength_bonus"`
- DefenseBonus int `yaml:"defense_bonus"`
- ScienceBonus int `yaml:"science_bonus"`
- TechnologyBonus int `yaml:"technology_bonus"`
-}
-```
-
-**New:**
-```go
-type ItemStats struct {
- // Offensive accuracy bonuses
- StabAttack int `yaml:"stab_attack"`
- SlashAttack int `yaml:"slash_attack"`
- CrushAttack int `yaml:"crush_attack"`
- ScienceAttack int `yaml:"science_attack"`
- RangedAttack int `yaml:"ranged_attack"`
-
- // Defensive bonuses
- StabDefense int `yaml:"stab_defense"`
- SlashDefense int `yaml:"slash_defense"`
- CrushDefense int `yaml:"crush_defense"`
- ScienceDefense int `yaml:"science_defense"`
- RangedDefense int `yaml:"ranged_defense"`
-
- // Damage bonuses
- StrengthBonus int `yaml:"strength_bonus"`
- RangedStrength int `yaml:"ranged_strength"`
- ScienceDamage int `yaml:"science_damage"`
- TechnologyBonus int `yaml:"technology_bonus"`
-}
-```
-
-**Notes:**
-- `AttackBonus` and `DefenseBonus` YAML tags are removed entirely. All item YAMLs will be updated to use the new per-type fields.
-- `ScienceBonus` is removed. It was never used in combat. The new `ScienceDamage` field replaces it for future science combat.
-- `TechnologyBonus` stays — it will be used in the Technology skill (Prayer equivalent) in the future.
-- The old `attack` YAML tag (used by bows/arrows/bolts, silently ignored because the Go struct had `attack_bonus`) is also removed. Those items move to `ranged_attack` and `ranged_strength`.
-
-**Backward Compatibility:** None needed. All YAML files will be rewritten. The old YAML tags (`attack_bonus`, `defense_bonus`, `attack`) will no longer be recognized and will be silently ignored by `gopkg.in/yaml.v3` (which is the current behavior for unknown fields). No `UnmarshalYAML` shim needed.
-
----
-
-## 3. Weapon Attack Types
-
-**File:** `internal/object/item.go:33-59` — add field to `ItemDef`
-
-**Add this field to `ItemDef`:**
-```go
-AttackType string `yaml:"attack_type"` // "stab", "slash", "crush", "ranged", "science"
-```
-
-Insert it after `WeaponType` (line 41), before `Stats`:
-```go
-type ItemDef struct {
- ID string `yaml:"id"`
- Name string `yaml:"name"`
- Color string `yaml:"color"`
- Description string `yaml:"description"`
- Value int `yaml:"value"`
- Stackable bool `yaml:"stackable"`
- EquipSlot EquipSlot `yaml:"equip_slot"`
- WeaponType WeaponType `yaml:"weapon_type"`
- AttackType string `yaml:"attack_type"` // NEW
- Stats ItemStats `yaml:"stats"`
- Speed float64 `yaml:"speed"`
- // ... rest unchanged
-}
-```
-
-**Default attack type mapping** (used when `attack_type` is empty):
-- If `WeaponType == "ranged"` → `"ranged"`
-- If `WeaponType == "science"` → `"science"`
-- Unarmed (no weapon) → `"crush"`
-- Otherwise → `"crush"` (safest default for melee)
-
-Weapons should always have `attack_type` set explicitly in YAML. The default is only a fallback.
-
-**Attack type assignments for existing weapons:**
-
-| Weapon Category | attack_type | Reasoning |
-|-----------------|-------------|-----------|
-| Swords (all tiers) | slash | Swords are slashing weapons |
-| Daggers (all tiers) | stab | Daggers are stabbing weapons |
-| Axes (all tiers) | slash | Axes are slashing weapons (also tools) |
-| Pickaxes (all tiers) | stab | Pickaxes stab/pierce (also tools) |
-| Bows (all types) | ranged | Ranged weapons |
-| Unarmed | crush | Fists = crush |
-
----
-
-## 4. Combat Style Mapping
-
-The 4 existing styles remain. The style determines:
-1. **Level bonus** (which combat level gets +3 or +1)
-2. **XP distribution** (unchanged from current)
-
-The **weapon's `attack_type`** determines:
-1. Which of the player's 5 attack bonus totals is used for the accuracy roll
-2. Which of the mob's 5 defense bonus values is used for the defense roll
-
-**Style → Level Bonus (unchanged from current):**
-
-| Style | Attack Level | Strength Level | Defense Level |
-|-------|-------------|----------------|---------------|
-| Accurate | +3 | +0 | +0 |
-| Aggressive | +0 | +3 | +0 |
-| Defensive | +0 | +0 | +3 |
-| Balanced | +1 | +1 | +1 |
-
-**Style → XP Distribution (unchanged from current):**
-
-| Style | Distribution |
-|-------|-------------|
-| Accurate | 75% Attack, 25% Hitpoints |
-| Aggressive | 75% Strength, 25% Hitpoints |
-| Defensive | 75% Defense, 25% Hitpoints |
-| Balanced | 25% each Attack/Strength/Defense/Hitpoints |
-
-**Ranged style bonuses** (when weapon_type is "ranged"):
-
-| Style | Ranged Level | Defense Level | XP Distribution |
-|-------|-------------|---------------|-----------------|
-| Accurate | +3 | +0 | 75% Ranged, 25% Hitpoints |
-| Aggressive | +3 | +0 | 75% Ranged, 25% Hitpoints |
-| Defensive | +0 | +3 | 75% Ranged, 25% Hitpoints |
-| Balanced | +1 | +1 | 75% Ranged, 25% Hitpoints |
-
-Note: For ranged, accurate and aggressive both give +3 Ranged (matching OSRS "accurate" and "rapid" which both boost ranged). The attack/strength bonuses from `AttackStyleBonus()` are NOT used — Ranged level is used instead.
-
----
-
-## 5. Updated Combat Formulas
-
-**File:** `internal/combat/formulas.go` — complete rewrite
-
-```go
-package combat
-
-import "math/rand"
-
-// AttackRoll computes the maximum attack roll for accuracy.
-// effectiveLevel = level + styleBonus + 8
-// equipBonus = total equipment bonus for the relevant attack type
-func AttackRoll(level int, styleBonus int, equipBonus int) int {
- effective := level + styleBonus + 8
- return effective * (equipBonus + 64)
-}
-
-// DefenseRoll computes the maximum defense roll.
-// effectiveLevel = level + styleBonus + 8
-// equipBonus = total equipment bonus for the relevant defense type
-func DefenseRoll(level int, styleBonus int, equipBonus int) int {
- effective := level + styleBonus + 8
- return effective * (equipBonus + 64)
-}
-
-// HitChance returns the probability of hitting (0.0 to 1.0) using the
-// true OSRS accuracy formula.
-func HitChance(attackRoll, defenseRoll int) float64 {
- a := float64(attackRoll)
- d := float64(defenseRoll)
- if a > d {
- return 1.0 - (d+2.0)/(2.0*(a+1.0))
- }
- return a / (2.0*(d+1.0))
-}
-
-// HitCheck uses the OSRS accuracy formula to determine if an attack hits.
-// Returns true if the attack lands.
-func HitCheck(attackRoll, defenseRoll int) bool {
- chance := HitChance(attackRoll, defenseRoll)
- return rand.Float64() < chance
-}
-
-// MaxHit computes the maximum melee hit.
-// level = Strength level (or Ranged level for ranged)
-// styleBonus = strength style bonus (+3 aggressive, +1 balanced, 0 otherwise)
-// equipBonus = total equipment strength bonus (or ranged_strength for ranged)
-func MaxHit(level int, styleBonus int, equipBonus int) int {
- effective := level + styleBonus + 8
- hit := (effective * (equipBonus + 64)) / 512
- if hit < 1 {
- hit = 1
- }
- return hit
-}
-
-// RollDamage returns a random damage value from 0 to maxHit inclusive.
-// In OSRS, 0 is a valid damage (a "hit 0" or splash). We keep the
-// current behavior of 1..maxHit to match existing game feel, but this
-// can be changed to 0..maxHit for true OSRS.
-func RollDamage(maxHit int) int {
- if maxHit <= 0 {
- return 0
- }
- return 1 + rand.Intn(maxHit)
-}
-
-// AttackStyleBonus returns the level bonuses for melee combat styles.
-// For ranged weapons, the caller should use RangedStyleBonus instead.
-func AttackStyleBonus(style string) (attack, strength, defense int) {
- switch style {
- case "accurate":
- return 3, 0, 0
- case "aggressive":
- return 0, 3, 0
- case "defensive":
- return 0, 0, 3
- case "balanced":
- return 1, 1, 1
- default:
- return 0, 0, 0
- }
-}
-
-// RangedStyleBonus returns the level bonuses for ranged combat styles.
-func RangedStyleBonus(style string) (ranged, defense int) {
- switch style {
- case "accurate":
- return 3, 0
- case "aggressive":
- return 3, 0
- case "defensive":
- return 0, 3
- case "balanced":
- return 1, 1
- default:
- return 0, 0
- }
-}
-
-// MobCombatLevel computes a mob's combat level.
-// Uses the standard OSRS NPC formula:
-// floor((attack + strength + defense + hp) / 4)
-func MobCombatLevel(attack, strength, defense, hp int) int {
- return (attack + strength + defense + hp) / 4
-}
-
-// EquipBonusForAttackType selects the correct attack bonus from a
-// pre-summed equipment stats struct based on the weapon's attack type.
-// attackType is one of: "stab", "slash", "crush", "ranged", "science"
-//
-// This function lives here to avoid circular imports. The caller passes
-// the individual bonus values.
-func SelectAttackBonus(attackType string, stab, slash, crush, science, ranged int) int {
- switch attackType {
- case "stab":
- return stab
- case "slash":
- return slash
- case "crush":
- return crush
- case "science":
- return science
- case "ranged":
- return ranged
- default:
- return crush
- }
-}
-
-// SelectDefenseBonus picks the correct defense bonus to oppose a given
-// attack type.
-func SelectDefenseBonus(attackType string, stab, slash, crush, science, ranged int) int {
- switch attackType {
- case "stab":
- return stab
- case "slash":
- return slash
- case "crush":
- return crush
- case "science":
- return science
- case "ranged":
- return ranged
- default:
- return crush
- }
-}
-```
-
-**Key differences from current formulas.go:**
-1. `HitCheck` now uses the continuous OSRS accuracy formula instead of a binary comparison. Previously, if `attackRoll > defenseRoll` it was always a hit; if less, always a miss. Now it uses the proper probability curve.
-2. `HitChance` is exposed as a separate function (useful for debugging/display).
-3. `RangedStyleBonus` added for ranged weapons.
-4. `MobCombatLevel` moved here from `utils.go` (optional, can stay in utils.go).
-5. `SelectAttackBonus` and `SelectDefenseBonus` helper functions added.
-6. `AttackRoll`, `DefenseRoll`, `MaxHit` formulas are actually unchanged in structure — they were already OSRS-correct. The change is in what values are passed to them.
-
----
-
-## 6. Code Changes to cmd_attack.go
-
-**File:** `internal/game/cmd_attack.go`
-
-### 6.1 playerAttack (lines 174-236)
-
-**Current flow:**
-1. Gets style bonuses from `AttackStyleBonus`
-2. Reads main hand weapon's `AttackBonus` and `StrengthBonus`
-3. `attRoll = AttackRoll(Attack level, attBonus, equipAtt)`
-4. `defRoll = DefenseRoll(mob.Defense, 0, 0)` — mob has NO equipment defense
-5. Binary `HitCheck(attRoll, defRoll)`
-6. `MaxHit(Strength level, strBonus, equipStr)`
-
-**New flow:**
-```go
-func (g *Game) playerAttack(sess *net.Session, p *player.Player, mob *world.MobInstance) {
- if g.processConsumeQueue(p, sess) {
- p.ActionState = &ActionState{Type: ActionEating, TargetName: "food"}
- return
- }
-
- // Determine weapon and attack type
- attackType := "crush" // unarmed default
- var weaponType object.WeaponType
- if itemID, ok := p.Equipment[object.SlotMainHand]; ok {
- if def, err := g.ItemStore.Load(itemID); err == nil {
- if def.AttackType != "" {
- attackType = def.AttackType
- } else if def.WeaponType == object.WeaponRanged {
- attackType = "ranged"
- } else if def.WeaponType == object.WeaponScience {
- attackType = "science"
- }
- weaponType = def.WeaponType
- }
- }
-
- // Sum all equipment bonuses
- totals := g.playerEquipBonuses(p)
-
- if weaponType == object.WeaponRanged {
- // --- RANGED ATTACK ---
- rangedBonus, defBonus := combat.RangedStyleBonus(string(p.AttackStyle))
-
- equipAttack := totals.RangedAttack
- attRoll := combat.AttackRoll(p.Level(player.Ranged), rangedBonus, equipAttack)
-
- mobDefBonus := combat.SelectDefenseBonus(attackType,
- mob.StabDefense, mob.SlashDefense, mob.CrushDefense,
- mob.ScienceDefense, mob.RangedDefense)
- defRoll := combat.DefenseRoll(mob.Defense, 0, mobDefBonus)
-
- if combat.HitCheck(attRoll, defRoll) {
- maxHit := combat.MaxHit(p.Level(player.Ranged), rangedBonus, totals.RangedStrength)
- dmg := combat.RollDamage(maxHit)
- // ... apply damage, award XP (ranged style), consume ammo ...
- _ = defBonus // used if needed for defense-related ranged style
- }
- } else {
- // --- MELEE ATTACK ---
- attBonus, strBonus, _ := combat.AttackStyleBonus(string(p.AttackStyle))
-
- equipAttack := combat.SelectAttackBonus(attackType,
- totals.StabAttack, totals.SlashAttack, totals.CrushAttack,
- totals.ScienceAttack, totals.RangedAttack)
- attRoll := combat.AttackRoll(p.Level(player.Attack), attBonus, equipAttack)
-
- mobDefBonus := combat.SelectDefenseBonus(attackType,
- mob.StabDefense, mob.SlashDefense, mob.CrushDefense,
- mob.ScienceDefense, mob.RangedDefense)
- defRoll := combat.DefenseRoll(mob.Defense, 0, mobDefBonus)
-
- if combat.HitCheck(attRoll, defRoll) {
- maxHit := combat.MaxHit(p.Level(player.Strength), strBonus, totals.StrengthBonus)
- dmg := combat.RollDamage(maxHit)
- // ... apply damage, award XP (current style) ...
- }
- }
-}
-```
-
-**Detailed changes (line-by-line for melee path):**
-
-Replace lines 180-193:
-```go
-// OLD:
-attBonus, strBonus, _ := combat.AttackStyleBonus(string(p.AttackStyle))
-equipAtt := 0
-equipStr := 0
-if itemID, ok := p.Equipment[object.SlotMainHand]; ok {
- def, err := g.ItemStore.Load(itemID)
- if err == nil {
- equipAtt = def.Stats.AttackBonus
- equipStr = def.Stats.StrengthBonus
- }
-}
-attRoll := combat.AttackRoll(p.Level(player.Attack), attBonus, equipAtt)
-defRoll := combat.DefenseRoll(mob.Defense, 0, 0)
-
-// NEW:
-attBonus, strBonus, _ := combat.AttackStyleBonus(string(p.AttackStyle))
-
-attackType := "crush"
-if itemID, ok := p.Equipment[object.SlotMainHand]; ok {
- if def, err := g.ItemStore.Load(itemID); err == nil {
- if def.AttackType != "" {
- attackType = def.AttackType
- }
- }
-}
-
-totals := g.playerEquipBonuses(p)
-equipAttack := combat.SelectAttackBonus(attackType,
- totals.StabAttack, totals.SlashAttack, totals.CrushAttack,
- totals.ScienceAttack, totals.RangedAttack)
-attRoll := combat.AttackRoll(p.Level(player.Attack), attBonus, equipAttack)
-
-mobDefBonus := combat.SelectDefenseBonus(attackType,
- mob.StabDefense, mob.SlashDefense, mob.CrushDefense,
- mob.ScienceDefense, mob.RangedDefense)
-defRoll := combat.DefenseRoll(mob.Defense, 0, mobDefBonus)
-```
-
-Replace line 196 (`MaxHit` call):
-```go
-// OLD:
-maxHit := combat.MaxHit(p.Level(player.Strength), strBonus, equipStr)
-
-// NEW:
-maxHit := combat.MaxHit(p.Level(player.Strength), strBonus, totals.StrengthBonus)
-```
-
-### 6.2 mobAttack (lines 238-289)
-
-**Current flow:**
-1. Gets defense style bonus
-2. Sums `DefenseBonus` from ALL equipped items
-3. `attRoll = AttackRoll(mob.Attack, 0, 0)` — mob has NO attack bonus
-4. `defRoll = DefenseRoll(Defense level, defBonus, equipDef)`
-
-**New flow:**
-```go
-func (g *Game) mobAttack(sess *net.Session, p *player.Player, mob *world.MobInstance) {
- _, _, defStyleBonus := combat.AttackStyleBonus(string(p.AttackStyle))
-
- // Determine mob's attack type
- mobAttackType := mob.AttackType
- if mobAttackType == "" {
- mobAttackType = "crush"
- }
-
- // Mob attack roll: uses mob's attack level + mob's attack bonus
- attRoll := combat.AttackRoll(mob.Attack, 0, mob.AttackBonus)
-
- // Player defense roll: uses player's defense level + style bonus +
- // equipment defense matching the mob's attack type
- totals := g.playerEquipBonuses(p)
- equipDef := combat.SelectDefenseBonus(mobAttackType,
- totals.StabDefense, totals.SlashDefense, totals.CrushDefense,
- totals.ScienceDefense, totals.RangedDefense)
- defRoll := combat.DefenseRoll(p.Level(player.Defense), defStyleBonus, equipDef)
-
- if combat.HitCheck(attRoll, defRoll) {
- maxHit := combat.MaxHit(mob.Strength, 0, mob.StrengthBonus)
- dmg := combat.RollDamage(maxHit)
- // ... rest unchanged (apply damage, save, flee check, etc.)
- }
-}
-```
-
-**Detailed changes (line-by-line):**
-
-Replace lines 239-250:
-```go
-// OLD:
-_, _, defBonus := combat.AttackStyleBonus(string(p.AttackStyle))
-equipDef := 0
-for _, itemID := range p.Equipment {
- def, err := g.ItemStore.Load(itemID)
- if err == nil {
- equipDef += def.Stats.DefenseBonus
- }
-}
-attRoll := combat.AttackRoll(mob.Attack, 0, 0)
-defRoll := combat.DefenseRoll(p.Level(player.Defense), defBonus, equipDef)
-
-// NEW:
-_, _, defStyleBonus := combat.AttackStyleBonus(string(p.AttackStyle))
-
-mobAttackType := mob.AttackType
-if mobAttackType == "" {
- mobAttackType = "crush"
-}
-
-attRoll := combat.AttackRoll(mob.Attack, 0, mob.AttackBonus)
-
-totals := g.playerEquipBonuses(p)
-equipDef := combat.SelectDefenseBonus(mobAttackType,
- totals.StabDefense, totals.SlashDefense, totals.CrushDefense,
- totals.ScienceDefense, totals.RangedDefense)
-defRoll := combat.DefenseRoll(p.Level(player.Defense), defStyleBonus, equipDef)
-```
-
-Replace line 253 (`MaxHit` call):
-```go
-// OLD:
-maxHit := combat.MaxHit(mob.Strength, 0, 0)
-
-// NEW:
-maxHit := combat.MaxHit(mob.Strength, 0, mob.StrengthBonus)
-```
-
-### 6.3 awardCombatXP changes for Ranged
-
-**Current** (lines 378-406): Only awards to Attack/Strength/Defense/Hitpoints based on style.
-
-**New:** If the player's weapon_type is "ranged", XP goes to Ranged instead of melee skills.
-
-Add a new parameter to `awardCombatXP`:
-```go
-func (g *Game) awardCombatXP(p *player.Player, dmg int, isRanged bool) ([]xpGain, []player.SkillName) {
- baseXP := dmg * 4
- var gains []xpGain
- var leveledUp []player.SkillName
-
- if isRanged {
- // All ranged styles: 75% ranged, 25% hitpoints
- gains = []xpGain{
- {string(player.Ranged), baseXP * 3 / 4},
- {string(player.Hitpoints), baseXP / 4},
- }
- } else {
- switch p.AttackStyle {
- case player.Accurate:
- gains = []xpGain{{string(player.Attack), baseXP * 3 / 4}, {string(player.Hitpoints), baseXP / 4}}
- case player.Aggressive:
- gains = []xpGain{{string(player.Strength), baseXP * 3 / 4}, {string(player.Hitpoints), baseXP / 4}}
- case player.Defensive:
- gains = []xpGain{{string(player.Defense), baseXP * 3 / 4}, {string(player.Hitpoints), baseXP / 4}}
- case player.Balanced:
- quarter := baseXP / 4
- gains = []xpGain{
- {string(player.Attack), quarter},
- {string(player.Strength), quarter},
- {string(player.Defense), quarter},
- {string(player.Hitpoints), quarter},
- }
- }
- }
-
- for _, gain := range gains {
- if newLevel := p.AddSkillXP(player.SkillName(gain.Skill), gain.XP); newLevel > 0 {
- leveledUp = append(leveledUp, player.SkillName(gain.Skill))
- }
- }
- g.AccountStore.SaveCharacter(p)
- return gains, leveledUp
-}
-```
-
-Update call sites:
-- `playerAttack` melee path: `g.awardCombatXP(p, dmg, false)`
-- `playerAttack` ranged path: `g.awardCombatXP(p, dmg, true)`
-
-### 6.4 Ammo Consumption (Ranged)
-
-In `playerAttack`, after a successful ranged attack:
-```go
-if weaponType == object.WeaponRanged {
- p.AmmoQty--
- if p.AmmoQty <= 0 {
- delete(p.Equipment, object.SlotAmmo)
- p.AmmoQty = 0
- sess.WriteLine("You've run out of ammo!")
- combat.LeaveCombat(p.Name)
- // End combat
- }
- g.AccountStore.SaveCharacter(p)
-}
-```
-
-Before combat starts (in `startCombat` or `doAttack`), check for ammo:
-```go
-if weaponDef.WeaponType == object.WeaponRanged {
- if _, hasAmmo := p.Equipment[object.SlotAmmo]; !hasAmmo || p.AmmoQty <= 0 {
- sess.WriteLine("You don't have any ammo equipped.")
- return
- }
-}
-```
-
-### 6.5 startCombat Style Display
-
-In `startCombat` (line 120), the style display should also show the attack type:
-```go
-attackType := "crush"
-if itemID, ok := p.Equipment[object.SlotMainHand]; ok {
- if def, err := g.ItemStore.Load(itemID); err == nil && def.AttackType != "" {
- attackType = def.AttackType
- }
-}
-styleStr := fmt.Sprintf(" Style: %s (%s, %s)", p.AttackStyle, strings.Join(styleParts, ", "), attackType)
-```
-
----
-
-## 7. Code Changes to MobDef and MobInstance
-
-**File:** `internal/world/mob.go`
-
-### 7.1 MobDef (lines 20-37)
-
-**Add these fields:**
-```go
-type MobDef struct {
- ID string `yaml:"id"`
- Name string `yaml:"name"`
- Description string `yaml:"description"`
- BehaviorID string `yaml:"behavior"`
- IdleDescriptions []string `yaml:"idle_descriptions"`
- CombatDescriptions []string `yaml:"combat_descriptions"`
- Attack int `yaml:"attack"`
- Strength int `yaml:"strength"`
- Defense int `yaml:"defense"`
- HP int `yaml:"hp"`
- Ranged int `yaml:"ranged"` // NEW
- Science int `yaml:"science"` // NEW
- Speed float64 `yaml:"speed"`
- Aggressive bool `yaml:"aggressive"`
- Protected bool `yaml:"protected"`
- Unique bool `yaml:"unique"`
- RespawnTicks float64 `yaml:"respawn_ticks"`
- Drops DropTable `yaml:"drops"`
-
- // NEW: Attack bonuses
- AttackBonus int `yaml:"attack_bonus"` // equipment-equivalent attack bonus
- StrengthBonus int `yaml:"strength_bonus"` // equipment-equivalent strength bonus
- RangedBonus int `yaml:"ranged_bonus"` // ranged attack bonus
- ScienceBonus int `yaml:"science_bonus"` // science attack bonus
- AttackType string `yaml:"attack_type"` // "stab"/"slash"/"crush"/"ranged"/"science" (default "crush")
-
- // NEW: Defense bonuses
- StabDefense int `yaml:"stab_defense"`
- SlashDefense int `yaml:"slash_defense"`
- CrushDefense int `yaml:"crush_defense"`
- ScienceDefense int `yaml:"science_defense"`
- RangedDefense int `yaml:"ranged_defense"`
-
- // NEW: Elemental weakness
- Weakness string `yaml:"weakness"` // "solar"/"hydro"/"eco"/"bio"/""
-}
-```
-
-### 7.2 MobInstance (lines 39-62)
-
-**Add matching fields:**
-```go
-type MobInstance struct {
- InstanceID string
- DefID string
- Name string
- BehaviorID string
- HP int
- MaxHP int
- Attack int
- Strength int
- Defense int
- Ranged int // NEW
- Science int // NEW
- Speed float64
- Aggressive bool
- Protected bool
- Unique bool
- RespawnTicks float64
- RoomID int
- HomeRoomID int
- Drops DropTable
- IdleDescription string
- WanderRooms []int
- WanderInterval float64
- WanderTickCounter int
- regenerateTick int
-
- // NEW: Attack bonuses
- AttackBonus int
- StrengthBonus int
- RangedBonus int
- ScienceBonus int
- AttackType string
-
- // NEW: Defense bonuses
- StabDefense int
- SlashDefense int
- CrushDefense int
- ScienceDefense int
- RangedDefense int
-
- // NEW: Elemental weakness
- Weakness string
-}
-```
-
-### 7.3 SeedMobs (lines 213-259)
-
-**Add field propagation** in the `inst := &MobInstance{...}` block (lines 236-258):
-
-After line 245 (`Defense: dw.def.Defense,`), add:
-```go
-Ranged: dw.def.Ranged,
-Science: dw.def.Science,
-```
-
-After line 255 (`Drops: dw.def.Drops,`), add:
-```go
-AttackBonus: dw.def.AttackBonus,
-StrengthBonus: dw.def.StrengthBonus,
-RangedBonus: dw.def.RangedBonus,
-ScienceBonus: dw.def.ScienceBonus,
-AttackType: dw.def.AttackType,
-StabDefense: dw.def.StabDefense,
-SlashDefense: dw.def.SlashDefense,
-CrushDefense: dw.def.CrushDefense,
-ScienceDefense: dw.def.ScienceDefense,
-RangedDefense: dw.def.RangedDefense,
-Weakness: dw.def.Weakness,
-```
-
-### 7.4 mobCombatLevel Update
-
-**File:** `internal/game/utils.go:47-49`
-
-**Current:**
-```go
-func mobCombatLevel(m *world.MobInstance) int {
- return int(0.25*float64(m.Attack+m.Strength+m.Defense+m.MaxHP) + 0.5)
-}
-```
-
-**New** (unchanged — this formula is already correct for melee-only mobs):
-```go
-func mobCombatLevel(m *world.MobInstance) int {
- base := float64(m.Defense+m.MaxHP) / 4.0
- melee := float64(m.Attack+m.Strength) / 4.0
- ranged := float64(m.Ranged) * 3.0 / 8.0
- science := float64(m.Science) * 3.0 / 8.0
- best := melee
- if ranged > best {
- best = ranged
- }
- if science > best {
- best = science
- }
- return int(base + best + 0.5)
-}
-```
-
-This uses the OSRS NPC combat level formula:
-- `base = (def + hp) / 4`
-- `offensive = max(melee=(atk+str)/4, ranged=rng*3/8, magic=sci*3/8)`
-- `level = floor(base + offensive)`
-
-For existing mobs with no Ranged/Science, this produces the same results as the old formula.
-
----
-
-## 8. Equipment Bonus Aggregation
-
-**File:** `internal/game/cmd_attack.go` (or a new `internal/game/equip_stats.go`)
-
-Add a helper function that sums all equipped items' stats:
-
-```go
-func (g *Game) playerEquipBonuses(p *player.Player) object.ItemStats {
- var totals object.ItemStats
- for _, itemID := range p.Equipment {
- def, err := g.ItemStore.Load(itemID)
- if err != nil {
- continue
- }
- totals.StabAttack += def.Stats.StabAttack
- totals.SlashAttack += def.Stats.SlashAttack
- totals.CrushAttack += def.Stats.CrushAttack
- totals.ScienceAttack += def.Stats.ScienceAttack
- totals.RangedAttack += def.Stats.RangedAttack
- totals.StabDefense += def.Stats.StabDefense
- totals.SlashDefense += def.Stats.SlashDefense
- totals.CrushDefense += def.Stats.CrushDefense
- totals.ScienceDefense += def.Stats.ScienceDefense
- totals.RangedDefense += def.Stats.RangedDefense
- totals.StrengthBonus += def.Stats.StrengthBonus
- totals.RangedStrength += def.Stats.RangedStrength
- totals.ScienceDamage += def.Stats.ScienceDamage
- totals.TechnologyBonus += def.Stats.TechnologyBonus
- }
- return totals
-}
-```
-
-This function is called by `playerAttack`, `mobAttack`, the new `stats` command, and `doLookTarget` for comparing equipment.
-
----
-
-## 9. Equipment Stats Display
-
-**File:** `internal/game/cmd_look.go`
-
-### 9.1 Item Examination (doLookTarget)
-
-When looking at an item (inventory or ground), if the item has any non-zero combat stats, display them in a formatted block.
-
-**Location:** After displaying item name/description/value (lines 508-514 for ground items, lines 526-536 for inventory items).
-
-**Add this helper function:**
-```go
-func (g *Game) showItemStats(sess *net.Session, def *object.ItemDef) {
- s := def.Stats
- hasAttack := s.StabAttack != 0 || s.SlashAttack != 0 || s.CrushAttack != 0 ||
- s.ScienceAttack != 0 || s.RangedAttack != 0
- hasDefense := s.StabDefense != 0 || s.SlashDefense != 0 || s.CrushDefense != 0 ||
- s.ScienceDefense != 0 || s.RangedDefense != 0
- hasOther := s.StrengthBonus != 0 || s.RangedStrength != 0 ||
- s.ScienceDamage != 0 || s.TechnologyBonus != 0
-
- if !hasAttack && !hasDefense && !hasOther {
- return
- }
-
- sess.WriteLine("")
- if hasAttack || hasDefense {
- sess.WriteLine(" Attack bonuses: Defense bonuses:")
- sess.WriteLine(fmt.Sprintf(" Stab: %+4d Stab: %+4d", s.StabAttack, s.StabDefense))
- sess.WriteLine(fmt.Sprintf(" Slash: %+4d Slash: %+4d", s.SlashAttack, s.SlashDefense))
- sess.WriteLine(fmt.Sprintf(" Crush: %+4d Crush: %+4d", s.CrushAttack, s.CrushDefense))
- sess.WriteLine(fmt.Sprintf(" Science:%+4d Science:%+4d", s.ScienceAttack, s.ScienceDefense))
- sess.WriteLine(fmt.Sprintf(" Ranged: %+4d Ranged: %+4d", s.RangedAttack, s.RangedDefense))
- }
- if hasOther {
- sess.WriteLine("")
- sess.WriteLine(" Other bonuses:")
- if s.StrengthBonus != 0 {
- sess.WriteLine(fmt.Sprintf(" Melee strength: %+d", s.StrengthBonus))
- }
- if s.RangedStrength != 0 {
- sess.WriteLine(fmt.Sprintf(" Ranged strength: %+d", s.RangedStrength))
- }
- if s.ScienceDamage != 0 {
- sess.WriteLine(fmt.Sprintf(" Science damage: %+d", s.ScienceDamage))
- }
- if s.TechnologyBonus != 0 {
- sess.WriteLine(fmt.Sprintf(" Technology: %+d", s.TechnologyBonus))
- }
- }
- if def.AttackType != "" {
- sess.WriteLine(fmt.Sprintf(" Attack type: %s", def.AttackType))
- }
- if def.Speed > 0 {
- sess.WriteLine(fmt.Sprintf(" Speed: %.0f", def.Speed))
- }
-}
-```
-
-**Call it** in the ground item branch (after line 513):
-```go
-g.showItemStats(sess, def)
-```
-
-**Call it** in the inventory item branch (after line 531):
-```go
-g.showItemStats(sess, def)
-```
-
-### 9.2 Mob Examination
-
-Update the mob examination section in `doLookTarget` (lines 451-457) to show per-type bonuses:
-
-```go
-// Replace lines 451-457:
-sess.WriteLines(
- "",
- fmt.Sprintf(" Attack: %d Strength: %d Defense: %d", best.Attack, best.Strength, best.Defense),
- fmt.Sprintf(" HP: %d/%d", best.HP, best.MaxHP),
-)
-if best.StabDefense != 0 || best.SlashDefense != 0 || best.CrushDefense != 0 ||
- best.ScienceDefense != 0 || best.RangedDefense != 0 {
- sess.WriteLines(
- "",
- " Defense bonuses:",
- fmt.Sprintf(" Stab: %+d Slash: %+d Crush: %+d", best.StabDefense, best.SlashDefense, best.CrushDefense),
- fmt.Sprintf(" Science: %+d Ranged: %+d", best.ScienceDefense, best.RangedDefense),
- )
-}
-if best.Weakness != "" {
- sess.WriteLine(fmt.Sprintf(" Weakness: %s", best.Weakness))
-}
-```
-
----
-
-## 10. Equipment Totals Command — `stats`
-
-**New file:** `internal/game/cmd_stats.go`
-
-```go
-package game
-
-import (
- "fmt"
- "strings"
-
- "thehouseoficarus/internal/combat"
- "thehouseoficarus/internal/net"
- "thehouseoficarus/internal/object"
- "thehouseoficarus/internal/player"
-)
-
-func (g *Game) doStats(sess *net.Session) {
- p := sess.Player.(*player.Player)
- totals := g.playerEquipBonuses(p)
-
- attackType := "crush"
- weaponName := "unarmed"
- if itemID, ok := p.Equipment[object.SlotMainHand]; ok {
- if def, err := g.ItemStore.Load(itemID); err == nil {
- weaponName = def.Name
- if def.AttackType != "" {
- attackType = def.AttackType
- }
- }
- }
-
- sess.WriteLines(
- "",
- fmt.Sprintf("Weapon: %s (attack type: %s)", weaponName, attackType),
- "",
- "Attack bonuses: Defense bonuses:",
- fmt.Sprintf(" Stab: %+4d Stab: %+4d", totals.StabAttack, totals.StabDefense),
- fmt.Sprintf(" Slash: %+4d Slash: %+4d", totals.SlashAttack, totals.SlashDefense),
- fmt.Sprintf(" Crush: %+4d Crush: %+4d", totals.CrushAttack, totals.CrushDefense),
- fmt.Sprintf(" Science:%+4d Science:%+4d", totals.ScienceAttack, totals.ScienceDefense),
- fmt.Sprintf(" Ranged: %+4d Ranged: %+4d", totals.RangedAttack, totals.RangedDefense),
- "",
- "Other bonuses:",
- fmt.Sprintf(" Melee strength: %+d", totals.StrengthBonus),
- fmt.Sprintf(" Ranged strength: %+d", totals.RangedStrength),
- fmt.Sprintf(" Science damage: %+d", totals.ScienceDamage),
- fmt.Sprintf(" Technology: %+d", totals.TechnologyBonus),
- )
-
- // Show effective accuracy and max hit for current setup
- attBonus, strBonus, _ := combat.AttackStyleBonus(string(p.AttackStyle))
- equipAtt := combat.SelectAttackBonus(attackType,
- totals.StabAttack, totals.SlashAttack, totals.CrushAttack,
- totals.ScienceAttack, totals.RangedAttack)
- attRoll := combat.AttackRoll(p.Level(player.Attack), attBonus, equipAtt)
- maxHit := combat.MaxHit(p.Level(player.Strength), strBonus, totals.StrengthBonus)
-
- sess.WriteLines(
- "",
- fmt.Sprintf("Style: %s Attack roll: %d Max hit: %d",
- p.AttackStyle, attRoll, maxHit),
- )
-
- _ = strings.Join // avoid unused import (the real code won't need this)
-}
-```
-
-**Register the command:**
-
-**File:** `internal/game/game.go`
-
-In `classifyCommand` (line 138), add `"stats"` to the `ClassInstant` case:
-```go
-case "say", "score", "sc", "inventory", "i", "inv",
- "look", "l", "exits", "help",
- "map", "option", "options", "alias", "unalias",
- "description", "desc", "queued", "color", "colors",
- "colortable", "prompt", "style", "stats": // ADD "stats"
- return ClassInstant
-```
-
-In `executeCommand` (find the switch statement for instant commands), add:
-```go
-case "stats":
- g.doStats(sess)
-```
-
----
-
-## 11. Item YAML Migration
-
-Every item with combat stats needs updated YAML. Below is the complete set.
-
-### 11.1 Melee Weapons — Swords (attack_type: slash)
-
-Stats are OSRS-proportional. Swords have high slash, moderate stab, no crush.
-
-**Bronze Sword** (`data/items/bronze_sword.yaml`):
-```yaml
-id: bronze_sword
-name: bronze sword
-color: "178"
-description: "A basic bronze sword."
-value: 12
-stackable: false
-equip_slot: main_hand
-weapon_type: melee
-attack_type: slash
-stats:
- stab_attack: 4
- slash_attack: 10
- crush_attack: -2
- strength_bonus: 7
-speed: 4
-```
-
-**Iron Sword** (`data/items/iron_sword.yaml`):
-```yaml
-id: iron_sword
-name: iron sword
-color: "250"
-description: "An iron sword."
-value: 30
-stackable: false
-equip_slot: main_hand
-weapon_type: melee
-attack_type: slash
-stats:
- stab_attack: 7
- slash_attack: 15
- crush_attack: -2
- strength_bonus: 10
-speed: 4
-```
-
-**Steel Sword** (`data/items/steel_sword.yaml`):
-```yaml
-id: steel_sword
-name: steel sword
-color: "253"
-description: "A steel sword."
-value: 100
-stackable: false
-equip_slot: main_hand
-weapon_type: melee
-attack_type: slash
-stats:
- stab_attack: 10
- slash_attack: 22
- crush_attack: -2
- strength_bonus: 14
-speed: 4
-```
-
-**Mithril Sword** (`data/items/mithril_sword.yaml`):
-```yaml
-id: mithril_sword
-name: mithril sword
-color: "75"
-description: "A mithril sword."
-value: 250
-stackable: false
-equip_slot: main_hand
-weapon_type: melee
-attack_type: slash
-stats:
- stab_attack: 14
- slash_attack: 30
- crush_attack: -2
- strength_bonus: 20
-speed: 4
-```
-
-**Adamant Sword** (`data/items/adamant_sword.yaml`):
-```yaml
-id: adamant_sword
-name: adamant sword
-color: "120"
-description: "An adamant sword."
-value: 700
-stackable: false
-equip_slot: main_hand
-weapon_type: melee
-attack_type: slash
-stats:
- stab_attack: 20
- slash_attack: 40
- crush_attack: -2
- strength_bonus: 27
-speed: 4
-```
-
-**Rune Sword** (`data/items/rune_sword.yaml`):
-```yaml
-id: rune_sword
-name: rune sword
-color: "87"
-description: "A rune sword."
-value: 10000
-stackable: false
-equip_slot: main_hand
-weapon_type: melee
-attack_type: slash
-stats:
- stab_attack: 27
- slash_attack: 52
- crush_attack: -2
- strength_bonus: 36
-speed: 4
-```
-
-### 11.2 Melee Weapons — Daggers (attack_type: stab)
-
-Daggers have high stab, moderate slash, negative crush. Fast speed.
-
-**Bronze Dagger** (`data/items/bronze_dagger.yaml`):
-```yaml
-id: bronze_dagger
-name: bronze dagger
-color: "178"
-description: "A small bronze dagger."
-value: 8
-stackable: false
-equip_slot: main_hand
-weapon_type: melee
-attack_type: stab
-stats:
- stab_attack: 5
- slash_attack: 3
- crush_attack: -1
- strength_bonus: 4
-speed: 3
-```
-
-**Iron Dagger** (`data/items/iron_dagger.yaml`):
-```yaml
-id: iron_dagger
-name: iron dagger
-color: "250"
-description: "A small iron dagger."
-value: 20
-stackable: false
-equip_slot: main_hand
-weapon_type: melee
-attack_type: stab
-stats:
- stab_attack: 8
- slash_attack: 5
- crush_attack: -1
- strength_bonus: 7
-speed: 3
-```
-
-**Steel Dagger** (`data/items/steel_dagger.yaml`):
-```yaml
-id: steel_dagger
-name: steel dagger
-color: "253"
-description: "A small steel dagger."
-value: 60
-stackable: false
-equip_slot: main_hand
-weapon_type: melee
-attack_type: stab
-stats:
- stab_attack: 12
- slash_attack: 7
- crush_attack: -1
- strength_bonus: 10
-speed: 3
-```
-
-**Mithril Dagger** (`data/items/mithril_dagger.yaml`):
-```yaml
-id: mithril_dagger
-name: mithril dagger
-color: "75"
-description: "A small mithril dagger."
-value: 150
-stackable: false
-equip_slot: main_hand
-weapon_type: melee
-attack_type: stab
-stats:
- stab_attack: 17
- slash_attack: 10
- crush_attack: -1
- strength_bonus: 14
-speed: 3
-```
-
-**Adamant Dagger** (`data/items/adamant_dagger.yaml`):
-```yaml
-id: adamant_dagger
-name: adamant dagger
-color: "120"
-description: "A small adamant dagger."
-value: 400
-stackable: false
-equip_slot: main_hand
-weapon_type: melee
-attack_type: stab
-stats:
- stab_attack: 23
- slash_attack: 14
- crush_attack: -1
- strength_bonus: 19
-speed: 3
-```
-
-**Rune Dagger** (`data/items/rune_dagger.yaml`):
-```yaml
-id: rune_dagger
-name: rune dagger
-color: "87"
-description: "A small rune dagger."
-value: 5000
-stackable: false
-equip_slot: main_hand
-weapon_type: melee
-attack_type: stab
-stats:
- stab_attack: 30
- slash_attack: 18
- crush_attack: -1
- strength_bonus: 24
-speed: 3
-```
-
-### 11.3 Melee Weapons — Axes (attack_type: slash)
-
-Axes are also tools. They have moderate slash, some crush, weak stab. Slower than swords.
-
-**Bronze Axe** (`data/items/bronze_axe.yaml`):
-```yaml
-id: bronze_axe
-name: bronze axe
-color: "178"
-description: "A sturdy bronze axe, good for woodcutting."
-value: 10
-stackable: false
-equip_slot: main_hand
-weapon_type: melee
-attack_type: slash
-stats:
- stab_attack: -2
- slash_attack: 7
- crush_attack: 5
- strength_bonus: 5
-speed: 5
-tool_type: axe
-tool_speed: 4
-```
-
-**Iron Axe** (`data/items/iron_axe.yaml`):
-```yaml
-id: iron_axe
-name: iron axe
-color: "250"
-description: "A sturdy iron axe, good for woodcutting."
-value: 25
-stackable: false
-equip_slot: main_hand
-weapon_type: melee
-attack_type: slash
-stats:
- stab_attack: -2
- slash_attack: 10
- crush_attack: 7
- strength_bonus: 8
-speed: 5
-tool_type: axe
-tool_speed: 3.5
-```
-
-**Steel Axe** (`data/items/steel_axe.yaml`):
-```yaml
-id: steel_axe
-name: steel axe
-color: "253"
-description: "A sturdy steel axe, good for woodcutting."
-value: 75
-stackable: false
-equip_slot: main_hand
-weapon_type: melee
-attack_type: slash
-stats:
- stab_attack: -2
- slash_attack: 15
- crush_attack: 11
- strength_bonus: 12
-speed: 5
-tool_type: axe
-tool_speed: 3
-```
-
-**Black Axe** (`data/items/black_axe.yaml`):
-```yaml
-id: black_axe
-name: black axe
-color: "240"
-description: "A black axe, good for woodcutting."
-value: 150
-stackable: false
-equip_slot: main_hand
-weapon_type: melee
-attack_type: slash
-stats:
- stab_attack: -2
- slash_attack: 18
- crush_attack: 14
- strength_bonus: 14
-speed: 5
-tool_type: axe
-tool_speed: 2.5
-```
-
-**Mithril Axe** (`data/items/mithril_axe.yaml`):
-```yaml
-id: mithril_axe
-name: mithril axe
-color: "75"
-description: "A sturdy mithril axe, good for woodcutting."
-value: 200
-stackable: false
-equip_slot: main_hand
-weapon_type: melee
-attack_type: slash
-stats:
- stab_attack: -2
- slash_attack: 21
- crush_attack: 16
- strength_bonus: 17
-speed: 5
-tool_type: axe
-tool_speed: 2.5
-```
-
-**Adamant Axe** (`data/items/adamant_axe.yaml`):
-```yaml
-id: adamant_axe
-name: adamant axe
-color: "120"
-description: "A sturdy adamant axe, good for woodcutting."
-value: 500
-stackable: false
-equip_slot: main_hand
-weapon_type: melee
-attack_type: slash
-stats:
- stab_attack: -2
- slash_attack: 29
- crush_attack: 22
- strength_bonus: 24
-speed: 5
-tool_type: axe
-tool_speed: 2
-```
-
-**Rune Axe** (`data/items/rune_axe.yaml`):
-```yaml
-id: rune_axe
-name: rune axe
-color: "87"
-description: "A sturdy rune axe, good for woodcutting."
-value: 5000
-stackable: false
-equip_slot: main_hand
-weapon_type: melee
-attack_type: slash
-stats:
- stab_attack: -2
- slash_attack: 38
- crush_attack: 29
- strength_bonus: 32
-speed: 5
-tool_type: axe
-tool_speed: 1.5
-```
-
-**Dragon Axe** (`data/items/dragon_axe.yaml`):
-```yaml
-id: dragon_axe
-name: dragon axe
-color: "196"
-description: "A powerful dragon axe."
-value: 50000
-stackable: false
-equip_slot: main_hand
-weapon_type: melee
-attack_type: slash
-stats:
- stab_attack: -2
- slash_attack: 43
- crush_attack: 32
- strength_bonus: 36
-speed: 5
-tool_type: axe
-tool_speed: 1
-```
-
-### 11.4 Melee Weapons — Pickaxes (attack_type: stab)
-
-Pickaxes stab/pierce. Tool items with moderate combat stats.
-
-**Bronze Pickaxe** (`data/items/bronze_pickaxe.yaml`):
-```yaml
-id: bronze_pickaxe
-name: bronze pickaxe
-color: "178"
-description: "A sturdy bronze pickaxe, good for mining."
-value: 10
-stackable: false
-equip_slot: main_hand
-weapon_type: melee
-attack_type: stab
-stats:
- stab_attack: 4
- slash_attack: -2
- crush_attack: 2
- strength_bonus: 3
-speed: 5
-tool_type: pickaxe
-tool_speed: 2
-```
-
-**Iron Pickaxe** (`data/items/iron_pickaxe.yaml`):
-```yaml
-id: iron_pickaxe
-name: iron pickaxe
-color: "250"
-description: "A sturdy iron pickaxe, good for mining."
-value: 25
-stackable: false
-equip_slot: main_hand
-weapon_type: melee
-attack_type: stab
-stats:
- stab_attack: 7
- slash_attack: -2
- crush_attack: 3
- strength_bonus: 5
-speed: 5
-tool_type: pickaxe
-tool_speed: 1.5
-```
-
-**Steel Pickaxe** (`data/items/steel_pickaxe.yaml`):
-```yaml
-id: steel_pickaxe
-name: steel pickaxe
-color: "253"
-description: "A sturdy steel pickaxe, good for mining."
-value: 75
-stackable: false
-equip_slot: main_hand
-weapon_type: melee
-attack_type: stab
-stats:
- stab_attack: 10
- slash_attack: -2
- crush_attack: 4
- strength_bonus: 7
-speed: 5
-tool_type: pickaxe
-tool_speed: 1.25
-```
-
-**Black Pickaxe** (`data/items/black_pickaxe.yaml`):
-```yaml
-id: black_pickaxe
-name: black pickaxe
-color: "240"
-description: "A black pickaxe, good for mining."
-value: 150
-stackable: false
-equip_slot: main_hand
-weapon_type: melee
-attack_type: stab
-stats:
- stab_attack: 14
- slash_attack: -2
- crush_attack: 6
- strength_bonus: 9
-speed: 5
-tool_type: pickaxe
-tool_speed: 1
-```
-
-**Mithril Pickaxe** (`data/items/mithril_pickaxe.yaml`):
-```yaml
-id: mithril_pickaxe
-name: mithril pickaxe
-color: "75"
-description: "A sturdy mithril pickaxe, good for mining."
-value: 200
-stackable: false
-equip_slot: main_hand
-weapon_type: melee
-attack_type: stab
-stats:
- stab_attack: 17
- slash_attack: -2
- crush_attack: 8
- strength_bonus: 12
-speed: 5
-tool_type: pickaxe
-tool_speed: 1
-```
-
-**Adamant Pickaxe** (`data/items/adamant_pickaxe.yaml`):
-```yaml
-id: adamant_pickaxe
-name: adamant pickaxe
-color: "120"
-description: "A sturdy adamant pickaxe, good for mining."
-value: 500
-stackable: false
-equip_slot: main_hand
-weapon_type: melee
-attack_type: stab
-stats:
- stab_attack: 23
- slash_attack: -2
- crush_attack: 10
- strength_bonus: 16
-speed: 5
-tool_type: pickaxe
-tool_speed: 0.75
-```
-
-**Rune Pickaxe** (`data/items/rune_pickaxe.yaml`):
-```yaml
-id: rune_pickaxe
-name: rune pickaxe
-color: "87"
-description: "A sturdy rune pickaxe, good for mining."
-value: 5000
-stackable: false
-equip_slot: main_hand
-weapon_type: melee
-attack_type: stab
-stats:
- stab_attack: 30
- slash_attack: -2
- crush_attack: 14
- strength_bonus: 22
-speed: 5
-tool_type: pickaxe
-tool_speed: 0.5
-```
-
-**Dragon Pickaxe** (`data/items/dragon_pickaxe.yaml`):
-```yaml
-id: dragon_pickaxe
-name: dragon pickaxe
-color: "196"
-description: "A powerful dragon pickaxe."
-value: 50000
-stackable: false
-equip_slot: main_hand
-weapon_type: melee
-attack_type: stab
-stats:
- stab_attack: 34
- slash_attack: -2
- crush_attack: 16
- strength_bonus: 26
-speed: 5
-tool_type: pickaxe
-tool_speed: 0.25
-```
-
-### 11.5 Armor — Med Helms
-
-Med helms have moderate defense, balanced across melee types. Slightly negative science defense (metal conducts energy), neutral ranged.
-
-**Bronze Med Helm** (`data/items/bronze_med_helm.yaml`):
-```yaml
-id: bronze_med_helm
-name: bronze med helm
-color: "178"
-description: "A bronze medium helmet."
-value: 8
-stackable: false
-equip_slot: head
-stats:
- stab_defense: 3
- slash_defense: 4
- crush_defense: 2
- science_defense: -1
- ranged_defense: 3
-```
-
-**Iron Med Helm** (`data/items/iron_med_helm.yaml`):
-```yaml
-id: iron_med_helm
-name: iron med helm
-color: "250"
-description: "An iron medium helmet."
-value: 20
-stackable: false
-equip_slot: head
-stats:
- stab_defense: 5
- slash_defense: 6
- crush_defense: 3
- science_defense: -1
- ranged_defense: 5
-```
-
-**Steel Med Helm** (`data/items/steel_med_helm.yaml`):
-```yaml
-id: steel_med_helm
-name: steel med helm
-color: "253"
-description: "A steel medium helmet."
-value: 60
-stackable: false
-equip_slot: head
-stats:
- stab_defense: 7
- slash_defense: 9
- crush_defense: 5
- science_defense: -2
- ranged_defense: 7
-```
-
-**Mithril Med Helm** (`data/items/mithril_med_helm.yaml`):
-```yaml
-id: mithril_med_helm
-name: mithril med helm
-color: "75"
-description: "A mithril medium helmet."
-value: 150
-stackable: false
-equip_slot: head
-stats:
- stab_defense: 10
- slash_defense: 12
- crush_defense: 7
- science_defense: -3
- ranged_defense: 10
-```
-
-**Adamant Med Helm** (`data/items/adamant_med_helm.yaml`):
-```yaml
-id: adamant_med_helm
-name: adamant med helm
-color: "120"
-description: "An adamant medium helmet."
-value: 400
-stackable: false
-equip_slot: head
-stats:
- stab_defense: 14
- slash_defense: 16
- crush_defense: 10
- science_defense: -3
- ranged_defense: 14
-```
-
-**Rune Med Helm** (`data/items/rune_med_helm.yaml`):
-```yaml
-id: rune_med_helm
-name: rune med helm
-color: "87"
-description: "A rune medium helmet."
-value: 5000
-stackable: false
-equip_slot: head
-stats:
- stab_defense: 19
- slash_defense: 22
- crush_defense: 13
- science_defense: -4
- ranged_defense: 19
-```
-
-### 11.6 Armor — Full Helms
-
-Full helms have higher defense than med helms. Larger science penalty.
-
-**Bronze Full Helm** (`data/items/bronze_full_helm.yaml`):
-```yaml
-id: bronze_full_helm
-name: bronze full helm
-color: "178"
-description: "A bronze full helmet."
-value: 20
-stackable: false
-equip_slot: head
-stats:
- stab_defense: 5
- slash_defense: 6
- crush_defense: 4
- science_defense: -3
- ranged_defense: 5
-```
-
-**Iron Full Helm** (`data/items/iron_full_helm.yaml`):
-```yaml
-id: iron_full_helm
-name: iron full helm
-color: "250"
-description: "An iron full helmet."
-value: 50
-stackable: false
-equip_slot: head
-stats:
- stab_defense: 8
- slash_defense: 9
- crush_defense: 6
- science_defense: -3
- ranged_defense: 8
-```
-
-**Steel Full Helm** (`data/items/steel_full_helm.yaml`):
-```yaml
-id: steel_full_helm
-name: steel full helm
-color: "253"
-description: "A steel full helmet."
-value: 150
-stackable: false
-equip_slot: head
-stats:
- stab_defense: 12
- slash_defense: 13
- crush_defense: 9
- science_defense: -5
- ranged_defense: 12
-```
-
-**Mithril Full Helm** (`data/items/mithril_full_helm.yaml`):
-```yaml
-id: mithril_full_helm
-name: mithril full helm
-color: "75"
-description: "A mithril full helmet."
-value: 400
-stackable: false
-equip_slot: head
-stats:
- stab_defense: 16
- slash_defense: 18
- crush_defense: 12
- science_defense: -6
- ranged_defense: 16
-```
-
-**Adamant Full Helm** (`data/items/adamant_full_helm.yaml`):
-```yaml
-id: adamant_full_helm
-name: adamant full helm
-color: "120"
-description: "An adamant full helmet."
-value: 1000
-stackable: false
-equip_slot: head
-stats:
- stab_defense: 22
- slash_defense: 24
- crush_defense: 16
- science_defense: -8
- ranged_defense: 22
-```
-
-**Rune Full Helm** (`data/items/rune_full_helm.yaml`):
-```yaml
-id: rune_full_helm
-name: rune full helm
-color: "87"
-description: "A rune full helmet."
-value: 12000
-stackable: false
-equip_slot: head
-stats:
- stab_defense: 30
- slash_defense: 33
- crush_defense: 22
- science_defense: -11
- ranged_defense: 30
-```
-
-### 11.7 Armor — Platebodies
-
-Platebodies are the highest-defense torso armor. Heavy science penalty, strong melee defense.
-
-**Bronze Platebody** (`data/items/bronze_platebody.yaml`):
-```yaml
-id: bronze_platebody
-name: bronze platebody
-color: "178"
-description: "A bronze platebody."
-value: 60
-stackable: false
-equip_slot: torso
-stats:
- stab_defense: 12
- slash_defense: 15
- crush_defense: 10
- science_defense: -10
- ranged_defense: 12
-```
-
-**Iron Platebody** (`data/items/iron_platebody.yaml`):
-```yaml
-id: iron_platebody
-name: iron platebody
-color: "250"
-description: "An iron platebody."
-value: 150
-stackable: false
-equip_slot: torso
-stats:
- stab_defense: 18
- slash_defense: 22
- crush_defense: 14
- science_defense: -10
- ranged_defense: 18
-```
-
-**Steel Platebody** (`data/items/steel_platebody.yaml`):
-```yaml
-id: steel_platebody
-name: steel platebody
-color: "253"
-description: "A steel platebody."
-value: 500
-stackable: false
-equip_slot: torso
-stats:
- stab_defense: 27
- slash_defense: 32
- crush_defense: 22
- science_defense: -15
- ranged_defense: 27
-```
-
-**Mithril Platebody** (`data/items/mithril_platebody.yaml`):
-```yaml
-id: mithril_platebody
-name: mithril platebody
-color: "75"
-description: "A mithril platebody."
-value: 1500
-stackable: false
-equip_slot: torso
-stats:
- stab_defense: 36
- slash_defense: 42
- crush_defense: 30
- science_defense: -20
- ranged_defense: 36
-```
-
-**Adamant Platebody** (`data/items/adamant_platebody.yaml`):
-```yaml
-id: adamant_platebody
-name: adamant platebody
-color: "120"
-description: "An adamant platebody."
-value: 5000
-stackable: false
-equip_slot: torso
-stats:
- stab_defense: 49
- slash_defense: 55
- crush_defense: 40
- science_defense: -25
- ranged_defense: 49
-```
-
-**Rune Platebody** (`data/items/rune_platebody.yaml`):
-```yaml
-id: rune_platebody
-name: rune platebody
-color: "87"
-description: "A rune platebody."
-value: 40000
-stackable: false
-equip_slot: torso
-stats:
- stab_defense: 65
- slash_defense: 72
- crush_defense: 52
- science_defense: -30
- ranged_defense: 65
-```
-
-### 11.8 Ranged Weapons — Bows
-
-Bows use the `ranged_attack` field. The bug where they used `attack:` (which was silently ignored since ItemStats has no `attack` YAML tag) is fixed. Longbows have higher accuracy than shortbows but are slower.
-
-**Shortbow** (`data/items/shortbow.yaml`):
-```yaml
-id: shortbow
-name: shortbow
-color: "137"
-description: "A shortbow."
-value: 10
-equip_slot: main_hand
-weapon_type: ranged
-attack_type: ranged
-speed: 4
-stats:
- ranged_attack: 8
-```
-
-**Oak Shortbow** (`data/items/oak_shortbow.yaml`):
-```yaml
-id: oak_shortbow
-name: oak shortbow
-color: "136"
-description: "An oak shortbow."
-value: 40
-equip_slot: main_hand
-weapon_type: ranged
-attack_type: ranged
-speed: 4
-stats:
- ranged_attack: 14
-```
-
-**Willow Shortbow** (`data/items/willow_shortbow.yaml`):
-```yaml
-id: willow_shortbow
-name: willow shortbow
-color: "107"
-description: "A willow shortbow."
-value: 160
-equip_slot: main_hand
-weapon_type: ranged
-attack_type: ranged
-speed: 4
-stats:
- ranged_attack: 20
-```
-
-**Maple Shortbow** (`data/items/maple_shortbow.yaml`):
-```yaml
-id: maple_shortbow
-name: maple shortbow
-color: "172"
-description: "A maple shortbow."
-value: 640
-equip_slot: main_hand
-weapon_type: ranged
-attack_type: ranged
-speed: 4
-stats:
- ranged_attack: 29
-```
-
-**Yew Shortbow** (`data/items/yew_shortbow.yaml`):
-```yaml
-id: yew_shortbow
-name: yew shortbow
-color: "94"
-description: "A yew shortbow."
-value: 1600
-equip_slot: main_hand
-weapon_type: ranged
-attack_type: ranged
-speed: 4
-stats:
- ranged_attack: 47
-```
-
-**Magic Shortbow** (`data/items/magic_shortbow.yaml`):
-```yaml
-id: magic_shortbow
-name: magic shortbow
-color: "63"
-description: "A magic shortbow."
-value: 4000
-equip_slot: main_hand
-weapon_type: ranged
-attack_type: ranged
-speed: 4
-stats:
- ranged_attack: 69
-```
-
-**Longbow** (`data/items/longbow.yaml`):
-```yaml
-id: longbow
-name: longbow
-color: "137"
-description: "A longbow."
-value: 20
-equip_slot: main_hand
-weapon_type: ranged
-attack_type: ranged
-speed: 6
-stats:
- ranged_attack: 8
-```
-
-**Oak Longbow** (`data/items/oak_longbow.yaml`):
-```yaml
-id: oak_longbow
-name: oak longbow
-color: "136"
-description: "An oak longbow."
-value: 80
-equip_slot: main_hand
-weapon_type: ranged
-attack_type: ranged
-speed: 6
-stats:
- ranged_attack: 14
-```
-
-**Willow Longbow** (`data/items/willow_longbow.yaml`):
-```yaml
-id: willow_longbow
-name: willow longbow
-color: "107"
-description: "A willow longbow."
-value: 320
-equip_slot: main_hand
-weapon_type: ranged
-attack_type: ranged
-speed: 6
-stats:
- ranged_attack: 20
-```
-
-**Maple Longbow** (`data/items/maple_longbow.yaml`):
-```yaml
-id: maple_longbow
-name: maple longbow
-color: "172"
-description: "A maple longbow."
-value: 1280
-equip_slot: main_hand
-weapon_type: ranged
-attack_type: ranged
-speed: 6
-stats:
- ranged_attack: 29
-```
-
-**Yew Longbow** (`data/items/yew_longbow.yaml`):
-```yaml
-id: yew_longbow
-name: yew longbow
-color: "94"
-description: "A yew longbow."
-value: 2000
-equip_slot: main_hand
-weapon_type: ranged
-attack_type: ranged
-speed: 6
-stats:
- ranged_attack: 47
-```
-
-**Magic Longbow** (`data/items/magic_longbow.yaml`):
-```yaml
-id: magic_longbow
-name: magic longbow
-color: "63"
-description: "A magic longbow."
-value: 6000
-equip_slot: main_hand
-weapon_type: ranged
-attack_type: ranged
-speed: 6
-stats:
- ranged_attack: 69
-```
-
-### 11.9 Ranged Ammo — Arrows
-
-Arrows now use `ranged_strength` instead of the broken `attack:` field. Arrow accuracy (ranged_attack) is 0 — all accuracy comes from the bow. Damage comes from the arrow's `ranged_strength`.
-
-**Bronze Arrow** (`data/items/bronze_arrow.yaml`):
-```yaml
-id: bronze_arrow
-name: bronze arrow
-color: "178"
-description: "A bronze-tipped arrow."
-value: 1
-stackable: true
-equip_slot: ammo
-stats:
- ranged_strength: 7
-```
-
-**Iron Arrow** (`data/items/iron_arrow.yaml`):
-```yaml
-id: iron_arrow
-name: iron arrow
-color: "250"
-description: "An iron-tipped arrow."
-value: 2
-stackable: true
-equip_slot: ammo
-stats:
- ranged_strength: 10
-```
-
-**Steel Arrow** (`data/items/steel_arrow.yaml`):
-```yaml
-id: steel_arrow
-name: steel arrow
-color: "253"
-description: "A steel-tipped arrow."
-value: 5
-stackable: true
-equip_slot: ammo
-stats:
- ranged_strength: 16
-```
-
-**Mithril Arrow** (`data/items/mithril_arrow.yaml`):
-```yaml
-id: mithril_arrow
-name: mithril arrow
-color: "75"
-description: "A mithril-tipped arrow."
-value: 10
-stackable: true
-equip_slot: ammo
-stats:
- ranged_strength: 22
-```
-
-**Adamant Arrow** (`data/items/adamant_arrow.yaml`):
-```yaml
-id: adamant_arrow
-name: adamant arrow
-color: "120"
-description: "An adamant-tipped arrow."
-value: 20
-stackable: true
-equip_slot: ammo
-stats:
- ranged_strength: 31
-```
-
-**Rune Arrow** (`data/items/rune_arrow.yaml`):
-```yaml
-id: rune_arrow
-name: rune arrow
-color: "87"
-description: "A rune-tipped arrow."
-value: 40
-stackable: true
-equip_slot: ammo
-stats:
- ranged_strength: 49
-```
-
-### 11.10 Ranged Ammo — Bolts
-
-Same pattern as arrows. `ranged_strength` for damage.
-
-**Bronze Bolts** (`data/items/bronze_bolts.yaml`):
-```yaml
-id: bronze_bolts
-name: bronze bolts
-color: "178"
-description: "Bronze crossbow bolts."
-value: 1
-stackable: true
-equip_slot: ammo
-stats:
- ranged_strength: 10
-```
-
-**Iron Bolts** (`data/items/iron_bolts.yaml`):
-```yaml
-id: iron_bolts
-name: iron bolts
-color: "250"
-description: "Iron crossbow bolts."
-value: 3
-stackable: true
-equip_slot: ammo
-stats:
- ranged_strength: 17
-```
-
-**Steel Bolts** (`data/items/steel_bolts.yaml`):
-```yaml
-id: steel_bolts
-name: steel bolts
-color: "253"
-description: "Steel crossbow bolts."
-value: 6
-stackable: true
-equip_slot: ammo
-stats:
- ranged_strength: 25
-```
-
-**Mithril Bolts** (`data/items/mithril_bolts.yaml`):
-```yaml
-id: mithril_bolts
-name: mithril bolts
-color: "75"
-description: "Mithril crossbow bolts."
-value: 12
-stackable: true
-equip_slot: ammo
-stats:
- ranged_strength: 32
-```
-
-**Adamant Bolts** (`data/items/adamant_bolts.yaml`):
-```yaml
-id: adamant_bolts
-name: adamant bolts
-color: "120"
-description: "Adamant crossbow bolts."
-value: 24
-stackable: true
-equip_slot: ammo
-stats:
- ranged_strength: 43
-```
-
-**Rune Bolts** (`data/items/rune_bolts.yaml`):
-```yaml
-id: rune_bolts
-name: rune bolts
-color: "87"
-description: "Rune crossbow bolts."
-value: 48
-stackable: true
-equip_slot: ammo
-stats:
- ranged_strength: 55
-```
-
-**Sapphire Bolts** (`data/items/sapphire_bolts.yaml`):
-```yaml
-id: sapphire_bolts
-name: sapphire bolts
-color: "69"
-description: "Mithril bolts tipped with sapphire."
-value: 40
-stackable: true
-equip_slot: ammo
-stats:
- ranged_strength: 36
-```
-
-**Emerald Bolts** (`data/items/emerald_bolts.yaml`):
-```yaml
-id: emerald_bolts
-name: emerald bolts
-color: "83"
-description: "Mithril bolts tipped with emerald."
-value: 65
-stackable: true
-equip_slot: ammo
-stats:
- ranged_strength: 39
-```
-
-**Ruby Bolts** (`data/items/ruby_bolts.yaml`):
-```yaml
-id: ruby_bolts
-name: ruby bolts
-color: "196"
-description: "Adamant bolts tipped with ruby."
-value: 130
-stackable: true
-equip_slot: ammo
-stats:
- ranged_strength: 49
-```
-
-**Diamond Bolts** (`data/items/diamond_bolts.yaml`):
-```yaml
-id: diamond_bolts
-name: diamond bolts
-color: "255"
-description: "Adamant bolts tipped with diamond."
-value: 230
-stackable: true
-equip_slot: ammo
-stats:
- ranged_strength: 52
-```
-
-### 11.11 Ranged Armor — Leather
-
-Leather armor provides ranged defense and slight melee defense. Positive ranged defense, negative science defense.
-
-**Leather Cowl** (`data/items/leather_cowl.yaml`):
-```yaml
-id: leather_cowl
-name: leather cowl
-color: "130"
-description: "A leather cowl."
-value: 15
-equip_slot: head
-stats:
- stab_defense: 1
- slash_defense: 2
- crush_defense: 1
- science_defense: 2
- ranged_defense: 4
-```
-
-**Leather Body** (`data/items/leather_body.yaml`):
-```yaml
-id: leather_body
-name: leather body
-color: "130"
-description: "A leather body armour."
-value: 25
-equip_slot: torso
-stats:
- stab_defense: 4
- slash_defense: 7
- crush_defense: 5
- science_defense: 4
- ranged_defense: 10
-```
-
-**Leather Chaps** (`data/items/leather_chaps.yaml`):
-```yaml
-id: leather_chaps
-name: leather chaps
-color: "130"
-description: "A pair of leather chaps."
-value: 20
-equip_slot: legs
-stats:
- stab_defense: 2
- slash_defense: 4
- crush_defense: 3
- science_defense: 3
- ranged_defense: 6
-```
-
-**Leather Gloves** (`data/items/leather_gloves.yaml`):
-```yaml
-id: leather_gloves
-name: leather gloves
-color: "130"
-description: "A pair of leather gloves."
-value: 10
-equip_slot: hands
-stats:
- stab_defense: 1
- slash_defense: 1
- crush_defense: 1
- science_defense: 1
- ranged_defense: 2
-```
-
-**Leather Vambraces** (`data/items/leather_vambraces.yaml`):
-```yaml
-id: leather_vambraces
-name: leather vambraces
-color: "130"
-description: "A pair of leather vambraces."
-value: 18
-equip_slot: hands
-stats:
- stab_defense: 2
- slash_defense: 2
- crush_defense: 2
- science_defense: 2
- ranged_defense: 4
- ranged_attack: 4
-```
-
-**Leather Boots** (`data/items/leather_boots.yaml`):
-```yaml
-id: leather_boots
-name: leather boots
-color: "130"
-description: "A pair of leather boots."
-value: 12
-equip_slot: feet
-stats:
- stab_defense: 1
- slash_defense: 1
- crush_defense: 1
- science_defense: 1
- ranged_defense: 2
-```
-
-**Coif** (`data/items/coif.yaml`):
-```yaml
-id: coif
-name: coif
-color: "94"
-description: "A hard leather coif."
-value: 45
-equip_slot: head
-stats:
- stab_defense: 2
- slash_defense: 4
- crush_defense: 2
- science_defense: 4
- ranged_defense: 6
- ranged_attack: 2
-```
-
-**Hard Leather Body** (`data/items/hard_leather_body.yaml`):
-```yaml
-id: hard_leather_body
-name: hard leather body
-color: "94"
-description: "A hardened leather body armour."
-value: 60
-equip_slot: torso
-stats:
- stab_defense: 8
- slash_defense: 12
- crush_defense: 8
- science_defense: 6
- ranged_defense: 14
-```
-
-**Hard Leather Shield** (`data/items/hard_leather_shield.yaml`):
-```yaml
-id: hard_leather_shield
-name: hard leather shield
-color: "94"
-description: "A shield made of hardened leather."
-value: 55
-equip_slot: off_hand
-stats:
- stab_defense: 5
- slash_defense: 7
- crush_defense: 5
- science_defense: 4
- ranged_defense: 8
-```
-
-### 11.12 Non-Combat Equipment (no changes needed)
-
-These items have no combat stats and need no changes:
-- Graceful set (hat, torso, legs, gloves, boots, cape) — movement only
-- Cape of Agility — movement only
-- Jewelry (rings, necklaces, amulets, bracelets) — currently no stats
-- Tools without equip (needle, chisel, etc.)
-
-### 11.13 Unfinished Bow Items (no combat stats)
-
-These are fletching intermediates with no combat purpose:
-- `shortbow_u`, `longbow_u`, `oak_shortbow_u`, `oak_longbow_u`, `willow_shortbow_u`, `willow_longbow_u`, `maple_shortbow_u`, `maple_longbow_u`, `yew_shortbow_u`, `yew_longbow_u`, `magic_shortbow_u`, `magic_longbow_u`
-- `arrow_shaft`, `headless_arrow`, all `*_arrowtips`, all `*_bolts_unf`, all `*_bolt_tips`
-
-These have no equip slot or stats and need no changes.
-
----
-
-## 12. Mob YAML Updates
-
-### 12.1 Cow (`data/mobs/cow.yaml`)
-
-```yaml
-id: cow
-name: cow
-description: "A placid dairy cow, chewing cud."
-attack: 1
-strength: 1
-defense: 1
-hp: 8
-speed: 5
-aggressive: false
-respawn_ticks: 30
-attack_type: crush
-stab_defense: 1
-slash_defense: 1
-crush_defense: 1
-science_defense: 0
-ranged_defense: 0
-idle_descriptions:
- - "moos softly"
- - "chews on some grass"
- - "swishes its tail lazily"
- - "stares at you with big brown eyes"
-drops:
- remains: bones
- loot:
- - item_id: cowhide
- weight: 100
- - item_id: raw_beef
- weight: 100
-```
-
-### 12.2 Man (`data/mobs/man.yaml`)
-
-```yaml
-id: man
-name: man
-description: "A shabby-looking man loitering in the town square."
-combat_descriptions:
- - "is engaged in a fight to the death with %s"
- - "is getting pummelled by %s"
- - "is locked in combat with %s"
- - "trades blows with %s"
- - "circles warily around %s"
-idle_descriptions:
- - "scribbles something in a small notebook"
- - "gazes skyward at the clouds"
- - "leans against a wall, looking bored"
- - "scratches his head thoughtfully"
- - "stares off into the distance"
- - "adjusts his tunic and stretches"
-attack: 1
-strength: 1
-defense: 1
-hp: 7
-speed: 5
-aggressive: false
-respawn_ticks: 30
-attack_type: crush
-stab_defense: 0
-slash_defense: 0
-crush_defense: 0
-science_defense: 0
-ranged_defense: 0
-drops:
- remains: "bones"
- loot:
- - item_id: "credits"
- weight: 98
- quantity: 10
- - item_id: "credits"
- weight: 2
- quantity: 150
-```
-
-### 12.3 Guard (`data/mobs/guard.yaml`)
-
-```yaml
-id: guard
-name: Guard
-description: "A stern-looking guard in weathered armor."
-behavior: guard_talk
-unique: true
-protected: true
-attack: 5
-strength: 5
-defense: 5
-hp: 30
-speed: 5
-aggressive: false
-respawn_ticks: 60
-attack_type: slash
-attack_bonus: 8
-strength_bonus: 6
-stab_defense: 12
-slash_defense: 15
-crush_defense: 10
-science_defense: -5
-ranged_defense: 12
-idle_descriptions:
- - "scans the area with a watchful eye"
- - "adjusts the grip on his weapon"
- - "nods curtly at passersby"
- - "leans against the gate, arms folded"
-```
-
-### 12.4 Newbie Trainer (`data/mobs/newbie_trainer.yaml`)
-
-```yaml
-id: newbie_trainer
-name: Newbie Trainer
-description: "A friendly-looking instructor ready to help new adventurers."
-unique: true
-protected: true
-attack: 1
-strength: 1
-defense: 1
-hp: 50
-speed: 5
-aggressive: false
-respawn_ticks: 30
-attack_type: crush
-stab_defense: 0
-slash_defense: 0
-crush_defense: 0
-science_defense: 0
-ranged_defense: 0
-idle_descriptions:
- - "reviews a training manual"
- - "adjusts a practice dummy"
- - "demonstrates a sword stance to no one in particular"
- - "offers a friendly nod to passersby"
- - "polishes a wooden shield"
- - "checks a stopwatch and jots something down"
-```
-
-### 12.5 Tanner (`data/mobs/tanner.yaml`)
-
-```yaml
-id: tanner
-name: Tanner
-description: "A weathered craftsman with stained hands and a leather apron."
-behavior: tanner_talk
-unique: true
-protected: true
-hp: 50
-attack: 1
-strength: 1
-defense: 1
-speed: 5
-aggressive: false
-respawn_ticks: 30
-attack_type: crush
-stab_defense: 0
-slash_defense: 0
-crush_defense: 0
-science_defense: 0
-ranged_defense: 0
-idle_descriptions:
- - "scrapes at a piece of hide"
- - "examines a stack of leathers"
- - "sharpens a tanning knife"
- - "wipes sweat from his brow"
-```
-
----
-
-## 13. Example New Mobs
-
-These new mob YAMLs demonstrate the full stat spectrum. Place in `data/mobs/`.
-
-### 13.1 Rat (Level 1)
-
-```yaml
-id: rat
-name: rat
-description: "A large, mangy rat with beady red eyes."
-attack: 1
-strength: 1
-defense: 1
-hp: 2
-speed: 4
-aggressive: false
-respawn_ticks: 20
-attack_type: crush
-stab_defense: 0
-slash_defense: 0
-crush_defense: 0
-science_defense: 0
-ranged_defense: 0
-idle_descriptions:
- - "sniffs around the ground"
- - "nibbles on something"
- - "scurries in circles"
-drops:
- remains: bones
-```
-
-### 13.2 Goblin (Level 5)
-
-Weak to crush — goblins wear thin leather that resists slashing poorly and does nothing against blunt force.
-
-```yaml
-id: goblin
-name: goblin
-description: "A small green-skinned goblin with a rusty blade."
-attack: 1
-strength: 3
-defense: 3
-hp: 12
-speed: 5
-aggressive: true
-respawn_ticks: 25
-attack_type: slash
-attack_bonus: 3
-strength_bonus: 2
-stab_defense: 4
-slash_defense: 3
-crush_defense: -2
-science_defense: 0
-ranged_defense: 3
-idle_descriptions:
- - "mutters something unintelligible"
- - "waves a rusty blade around"
- - "picks its nose"
- - "kicks a pebble"
-drops:
- remains: bones
- loot:
- - item_id: credits
- weight: 80
- quantity: 5
- - item_id: credits
- weight: 20
- quantity: 25
-```
-
-### 13.3 Skeleton (Level 22)
-
-Skeletons have high slash defense (blade passes through gaps in bones), weak to crush (bones shatter).
-
-```yaml
-id: skeleton
-name: skeleton
-description: "An animated pile of bones, held together by dark energy."
-attack: 8
-strength: 6
-defense: 8
-hp: 22
-speed: 5
-aggressive: true
-respawn_ticks: 30
-attack_type: stab
-attack_bonus: 6
-strength_bonus: 4
-stab_defense: 10
-slash_defense: 18
-crush_defense: -5
-science_defense: -8
-ranged_defense: 10
-idle_descriptions:
- - "rattles ominously"
- - "clicks its jaw open and shut"
- - "stares with empty eye sockets"
-drops:
- remains: bones
- loot:
- - item_id: credits
- weight: 70
- quantity: 30
- - item_id: credits
- weight: 30
- quantity: 100
-```
-
-### 13.4 Zombie (Level 28)
-
-High slash defense (rotting flesh gives way), weak to crush and solar (sci-fi fire equivalent).
-
-```yaml
-id: zombie
-name: zombie
-description: "A shambling corpse reanimated by residual asteroid radiation."
-attack: 10
-strength: 8
-defense: 8
-hp: 30
-speed: 6
-aggressive: true
-respawn_ticks: 35
-attack_type: crush
-attack_bonus: 4
-strength_bonus: 6
-stab_defense: 8
-slash_defense: 20
-crush_defense: -8
-science_defense: -15
-ranged_defense: 8
-weakness: solar
-idle_descriptions:
- - "groans and shuffles forward"
- - "reaches out with decaying arms"
- - "stumbles and catches itself"
- - "stares blankly ahead"
-drops:
- remains: bones
- loot:
- - item_id: credits
- weight: 60
- quantity: 50
- - item_id: credits
- weight: 40
- quantity: 200
-```
-
-### 13.5 Moss Giant (Level 42)
-
-High HP, moderate defense across the board. Big and slow.
-
-```yaml
-id: moss_giant
-name: moss giant
-description: "A towering creature covered in moss and vines, its rocky skin dripping with moisture."
-attack: 12
-strength: 14
-defense: 10
-hp: 60
-speed: 7
-aggressive: true
-respawn_ticks: 45
-attack_type: crush
-attack_bonus: 10
-strength_bonus: 12
-stab_defense: 15
-slash_defense: 12
-crush_defense: 18
-science_defense: -5
-ranged_defense: 15
-idle_descriptions:
- - "surveys its territory with dull eyes"
- - "pulls a vine from its shoulder"
- - "stamps the ground, sending tremors"
- - "scratches its mossy hide"
-drops:
- remains: bones
- loot:
- - item_id: credits
- weight: 50
- quantity: 120
- - item_id: credits
- weight: 50
- quantity: 500
-```
-
-### 13.6 Lesser Drone (Level 53)
-
-A science-based mob. High melee defense, weak to ranged. Uses science attacks.
-
-```yaml
-id: lesser_drone
-name: lesser drone
-description: "A floating metallic drone with a pulsing energy core. Its surface crackles with electric discharge."
-attack: 1
-strength: 1
-defense: 18
-hp: 55
-ranged: 0
-science: 20
-speed: 4
-aggressive: true
-respawn_ticks: 50
-attack_type: science
-attack_bonus: 0
-science_bonus: 22
-strength_bonus: 0
-stab_defense: 35
-slash_defense: 35
-crush_defense: 30
-science_defense: 20
-ranged_defense: -10
-idle_descriptions:
- - "hovers silently, scanning the area"
- - "emits a low electronic hum"
- - "projects a thin beam of light across the floor"
- - "rotates slowly in place"
-drops:
- loot:
- - item_id: scrap_metal
- weight: 60
- - item_id: credits
- weight: 40
- quantity: 300
-```
-
-### 13.7 Greater Drone (Level 83)
-
-Stronger version of the lesser drone.
-
-```yaml
-id: greater_drone
-name: greater drone
-description: "A large, heavily armored drone with multiple energy emitters. Red warning lights pulse along its hull."
-attack: 1
-strength: 1
-defense: 30
-hp: 120
-ranged: 0
-science: 40
-speed: 4
-aggressive: true
-respawn_ticks: 80
-attack_type: science
-attack_bonus: 0
-science_bonus: 45
-strength_bonus: 0
-stab_defense: 55
-slash_defense: 55
-crush_defense: 50
-science_defense: 40
-ranged_defense: -20
-idle_descriptions:
- - "projects a defensive energy shield"
- - "recalibrates its targeting array"
- - "emits a warning klaxon"
- - "deploys sensor probes"
-drops:
- loot:
- - item_id: scrap_metal
- weight: 40
- quantity: 3
- - item_id: credits
- weight: 60
- quantity: 1500
-```
-
-### 13.8 Iron Sentinel (Level 92)
-
-A heavily armored mechanical guardian. Very high melee defense, weak to science attacks.
-
-```yaml
-id: iron_sentinel
-name: iron sentinel
-description: "A massive bipedal automaton forged from pre-regression alloys. Its joints grind with each deliberate step."
-attack: 25
-strength: 30
-defense: 45
-hp: 180
-speed: 6
-aggressive: true
-respawn_ticks: 100
-attack_type: crush
-attack_bonus: 40
-strength_bonus: 35
-stab_defense: 80
-slash_defense: 80
-crush_defense: 70
-science_defense: -30
-ranged_defense: 50
-idle_descriptions:
- - "stands motionless, servos whining softly"
- - "turns its armored head with a mechanical grind"
- - "vents steam from exhaust ports"
- - "scans the area with a red optical sensor"
-drops:
- loot:
- - item_id: scrap_metal
- weight: 30
- quantity: 5
- - item_id: runite_bar
- weight: 10
- - item_id: credits
- weight: 60
- quantity: 5000
-```
-
----
-
-## 14. Ranged Combat Integration
-
-### 14.1 Attack Flow
-
-When `weapon_type == "ranged"`:
-
-1. **Ammo check** (in `doAttack`, before `startCombat`):
- ```go
- if weaponDef.WeaponType == object.WeaponRanged {
- if _, hasAmmo := p.Equipment[object.SlotAmmo]; !hasAmmo || p.AmmoQty <= 0 {
- sess.WriteLine("You don't have any ammo equipped.")
- return
- }
- }
- ```
-
-2. **Attack roll**: Uses `Ranged` level + `RangedStyleBonus` + total `ranged_attack` from all equipment (bow + ammo + any ranged-boosting armor).
-
-3. **Max hit**: Uses `Ranged` level + `RangedStyleBonus` (strength portion) + total `ranged_strength` from equipment (primarily the ammo).
-
-4. **Mob defense**: Uses mob's `ranged_defense` value.
-
-5. **Ammo consumption**: After each attack (hit or miss), decrement `p.AmmoQty` by 1. If ammo reaches 0, unequip it and end combat.
-
-6. **XP**: 75% Ranged, 25% Hitpoints (all ranged styles).
-
-### 14.2 RangedStyleBonus
-
-| Style | Ranged Level Bonus | Defense Level Bonus | XP |
-|-------|-------------------|--------------------|----|
-| Accurate | +3 | +0 | 75% rng, 25% hp |
-| Aggressive | +3 | +0 | 75% rng, 25% hp |
-| Defensive | +0 | +3 | 75% rng, 25% hp |
-| Balanced | +1 | +1 | 75% rng, 25% hp |
-
-### 14.3 Ranged Max Hit Formula
-
-```
-effective_ranged = Ranged_level + style_bonus + 8
-max_hit = (effective_ranged * (total_ranged_strength + 64)) / 512
-```
-
-The `ranged_strength` comes primarily from ammo (arrows/bolts). Some equipment might also add ranged_strength in the future.
-
----
-
-## 15. Science Combat Integration
-
-Science (magic) combat is covered in a separate plan (`science.md`). Key integration points:
-
-- `attack_type: "science"` — uses Science level + `science_attack` bonus for accuracy
-- Max hit is determined by the equipped "mod" (spell/ability), NOT by equipment
-- Mob defense against science uses `science_defense`
-- XP: 75% Science, 25% Hitpoints
-- Science-based mobs (like drones) use `science` level + `science_bonus` for their attacks
-
-For this combat overhaul, the struct fields (`ScienceAttack`, `ScienceDefense`, `ScienceDamage`) are added but the science combat flow implementation is deferred.
-
----
-
-## 16. Backward Compatibility
-
-### Approach: Full YAML rewrite (recommended)
-
-All item YAML files are updated to use the new field names. The old `attack_bonus`, `defense_bonus`, and `attack` YAML tags are simply removed from the Go struct. Since `gopkg.in/yaml.v3` silently ignores unknown fields during unmarshalling, any YAML files accidentally left with old tags will simply have those values ignored (zeroed).
-
-**No custom `UnmarshalYAML`** is needed because:
-1. We control all the YAML files — they're in the repo under `data/`
-2. Player data (accounts/characters) doesn't store `ItemStats` — equipment is stored as item IDs
-3. There's no external API consuming these fields
-
-**Migration checklist:**
-- [x] All `attack_bonus: N` → replaced by `stab_attack`/`slash_attack`/`crush_attack` per weapon type
-- [x] All `defense_bonus: N` → replaced by per-type defense fields
-- [x] All `attack: N` (bows/arrows/bolts) → replaced by `ranged_attack` or `ranged_strength`
-- [x] All `strength_bonus: N` → kept as-is (same YAML tag)
-
-### What if old-format items are loaded?
-
-If someone has a custom item YAML with the old format, all combat stats will be 0. The item will have no combat effectiveness. This is acceptable — the items were already broken (bows used `attack:` which was silently ignored).
-
----
-
-## 17. Help Files
-
-### 17.1 Combat Help (`data/help/combat.yaml`)
-
-```yaml
-id: combat
-name: Combat
-aliases:
- - fighting
- - fight
-content: |
- COMBAT
-
- Attack a mob with: attack <mob>
-
- Your accuracy depends on your attack type (stab, slash, crush, ranged,
- or science) and your total equipment bonus for that type. Your weapon
- determines the attack type.
-
- Mobs have per-type defense bonuses. A skeleton with high slash defense
- but weak crush defense takes more hits from a mace than a sword.
-
- Use the 'style' command to change your combat style:
- accurate - +3 attack level, XP to attack
- aggressive - +3 strength level, XP to strength
- defensive - +3 defense level, XP to defense
- balanced - +1 to all, XP split evenly
-
- Use 'stats' to see your total equipment bonuses and current attack roll.
- Use 'look <item>' to see an item's combat stats.
-```
-
-### 17.2 Stats Help (`data/help/stats.yaml`)
-
-```yaml
-id: stats
-name: Stats
-aliases:
- - bonuses
- - equipment stats
-content: |
- STATS
-
- The 'stats' command shows your total equipment bonuses from all worn
- items, your current weapon and attack type, and your effective attack
- roll and max hit.
-
- Attack bonuses affect accuracy. The relevant bonus is determined by
- your weapon's attack type (stab, slash, crush, ranged, or science).
-
- Defense bonuses reduce incoming damage. When a mob attacks you, the
- game uses your defense bonus matching the mob's attack type.
-
- Strength bonus increases your max melee hit.
- Ranged strength increases your max ranged hit.
- Science damage increases your max science hit.
- Technology bonus will affect technology abilities (future).
-```
-
-### 17.3 Style Help (`data/help/style.yaml`)
-
-If this file already exists, update it. If not, create it:
-
-```yaml
-id: style
-name: Style
-aliases:
- - combat style
- - attack style
-content: |
- STYLE
-
- Usage: style <name>
-
- Changes your combat style. Prefix matching is supported.
-
- Styles:
- accurate - +3 to attack level, XP goes to Attack
- aggressive - +3 to strength level, XP goes to Strength
- defensive - +3 to defense level, XP goes to Defense
- balanced - +1 to all three, XP split evenly
-
- For ranged weapons:
- accurate - +3 to ranged level
- aggressive - +3 to ranged level (same as accurate for ranged)
- defensive - +3 to defense level
- balanced - +1 to ranged and defense
-
- Your style does NOT change your attack type. The attack type is
- determined by your weapon (e.g., swords use slash, daggers use stab).
-
- Use 'stats' to see how your current style affects your attack roll.
-```
-
----
-
-## 18. Implementation Order
-
-Step-by-step checklist. Each step should compile and pass `make vet` before moving to the next.
-
-### Phase 1: Struct Changes (no behavior change yet)
-
-- [ ] **Step 1:** Update `ItemStats` struct in `internal/object/item.go:67-73`
- - Replace the 5 fields with the 14 new fields
- - Add `AttackType string` field to `ItemDef` after line 41
-
-- [ ] **Step 2:** Update `MobDef` struct in `internal/world/mob.go:20-37`
- - Add: `Ranged`, `Science`, `AttackBonus`, `StrengthBonus`, `RangedBonus`, `ScienceBonus`, `AttackType`
- - Add: `StabDefense`, `SlashDefense`, `CrushDefense`, `ScienceDefense`, `RangedDefense`
- - Add: `Weakness`
-
-- [ ] **Step 3:** Update `MobInstance` struct in `internal/world/mob.go:39-62`
- - Mirror all new fields from MobDef
-
-- [ ] **Step 4:** Update `SeedMobs` in `internal/world/mob.go:213-259`
- - Copy all new fields from def to instance
-
-- [ ] **Step 5:** Fix all compilation errors from removed `AttackBonus`/`DefenseBonus`/`ScienceBonus` fields
- - `cmd_attack.go:187` — references `def.Stats.AttackBonus` → temporarily use `def.Stats.SlashAttack`
- - `cmd_attack.go:188` — references `def.Stats.StrengthBonus` → OK, field still exists
- - `cmd_attack.go:245` — references `def.Stats.DefenseBonus` → temporarily use sum of all defense types
- - Any other references to removed fields
-
-- [ ] **Step 6:** Run `make vet` — should pass with no errors
-
-### Phase 2: Item YAML Updates
-
-- [ ] **Step 7:** Update all 6 sword YAMLs (Section 11.1)
-- [ ] **Step 8:** Update all 6 dagger YAMLs (Section 11.2)
-- [ ] **Step 9:** Update all 8 axe YAMLs (Section 11.3)
-- [ ] **Step 10:** Update all 8 pickaxe YAMLs (Section 11.4)
-- [ ] **Step 11:** Update all 6 med helm YAMLs (Section 11.5)
-- [ ] **Step 12:** Update all 6 full helm YAMLs (Section 11.6)
-- [ ] **Step 13:** Update all 6 platebody YAMLs (Section 11.7)
-- [ ] **Step 14:** Update all 12 bow YAMLs (Section 11.8)
-- [ ] **Step 15:** Update all 6 arrow YAMLs (Section 11.9)
-- [ ] **Step 16:** Update all 10 bolt YAMLs (Section 11.10)
-- [ ] **Step 17:** Update all 9 leather/ranged armor YAMLs (Section 11.11)
-
-### Phase 3: Mob YAML Updates
-
-- [ ] **Step 18:** Update all 5 existing mob YAMLs (Section 12)
-- [ ] **Step 19:** Create 8 new mob YAMLs (Section 13)
-
-### Phase 4: Formula & Combat Logic
-
-- [ ] **Step 20:** Rewrite `internal/combat/formulas.go` (Section 5)
- - New `HitChance` function
- - Updated `HitCheck` to use probability curve
- - Add `RangedStyleBonus`
- - Add `SelectAttackBonus` and `SelectDefenseBonus`
-
-- [ ] **Step 21:** Add `playerEquipBonuses` helper (Section 8)
- - New file `internal/game/equip_stats.go` or add to `cmd_attack.go`
-
-- [ ] **Step 22:** Update `playerAttack` in `cmd_attack.go` (Section 6.1)
- - Determine attack type from weapon
- - Use `playerEquipBonuses` for totals
- - Use `SelectAttackBonus` for the right attack bonus
- - Use `SelectDefenseBonus` for mob's matching defense
- - Melee path: use Attack level + melee style bonus
- - Ranged path: use Ranged level + ranged style bonus + ammo consumption
-
-- [ ] **Step 23:** Update `mobAttack` in `cmd_attack.go` (Section 6.2)
- - Use mob's `AttackType` (default "crush")
- - Use mob's `AttackBonus` in attack roll
- - Use mob's `StrengthBonus` in max hit
- - Use player's matching defense bonus for the mob's attack type
-
-- [ ] **Step 24:** Update `awardCombatXP` (Section 6.3)
- - Add `isRanged` parameter
- - Ranged path: 75% Ranged, 25% Hitpoints
-
-- [ ] **Step 25:** Update `mobCombatLevel` in `utils.go` (Section 7.4)
- - New formula accounting for Ranged/Science levels
-
-- [ ] **Step 26:** Add ammo check in `doAttack` (Section 6.4)
-
-- [ ] **Step 27:** Run `make vet` and `make test`
-
-### Phase 5: Display Changes
-
-- [ ] **Step 28:** Add `showItemStats` helper to `cmd_look.go` (Section 9.1)
-- [ ] **Step 29:** Call `showItemStats` in item examination paths in `doLookTarget`
-- [ ] **Step 30:** Update mob examination in `doLookTarget` (Section 9.2)
-- [ ] **Step 31:** Create `cmd_stats.go` with `doStats` command (Section 10)
-- [ ] **Step 32:** Register `stats` command in `classifyCommand` and `executeCommand` in `game.go`
-- [ ] **Step 33:** Create help YAML files (Section 17)
-
-### Phase 6: Final Verification
-
-- [ ] **Step 34:** Run `make build`
-- [ ] **Step 35:** Run `make test`
-- [ ] **Step 36:** Run `make vet`
-- [ ] **Step 37:** Manual testing: equip weapons, check `stats`, `look <item>`, attack mobs, verify damage/accuracy feel reasonable
-- [ ] **Step 38:** Verify ranged combat works with ammo consumption
-- [ ] **Step 39:** Verify `look <mob>` shows defense bonuses
-
----
-
-## Appendix A: Complete Item Stats Reference Table
-
-### Melee Weapons
-
-| Item | Type | Stab | Slash | Crush | Str | Speed |
-|------|------|------|-------|-------|-----|-------|
-| bronze_dagger | stab | +5 | +3 | -1 | +4 | 3 |
-| iron_dagger | stab | +8 | +5 | -1 | +7 | 3 |
-| steel_dagger | stab | +12 | +7 | -1 | +10 | 3 |
-| mithril_dagger | stab | +17 | +10 | -1 | +14 | 3 |
-| adamant_dagger | stab | +23 | +14 | -1 | +19 | 3 |
-| rune_dagger | stab | +30 | +18 | -1 | +24 | 3 |
-| bronze_sword | slash | +4 | +10 | -2 | +7 | 4 |
-| iron_sword | slash | +7 | +15 | -2 | +10 | 4 |
-| steel_sword | slash | +10 | +22 | -2 | +14 | 4 |
-| mithril_sword | slash | +14 | +30 | -2 | +20 | 4 |
-| adamant_sword | slash | +20 | +40 | -2 | +27 | 4 |
-| rune_sword | slash | +27 | +52 | -2 | +36 | 4 |
-| bronze_axe | slash | -2 | +7 | +5 | +5 | 5 |
-| iron_axe | slash | -2 | +10 | +7 | +8 | 5 |
-| steel_axe | slash | -2 | +15 | +11 | +12 | 5 |
-| black_axe | slash | -2 | +18 | +14 | +14 | 5 |
-| mithril_axe | slash | -2 | +21 | +16 | +17 | 5 |
-| adamant_axe | slash | -2 | +29 | +22 | +24 | 5 |
-| rune_axe | slash | -2 | +38 | +29 | +32 | 5 |
-| dragon_axe | slash | -2 | +43 | +32 | +36 | 5 |
-| bronze_pickaxe | stab | +4 | -2 | +2 | +3 | 5 |
-| iron_pickaxe | stab | +7 | -2 | +3 | +5 | 5 |
-| steel_pickaxe | stab | +10 | -2 | +4 | +7 | 5 |
-| black_pickaxe | stab | +14 | -2 | +6 | +9 | 5 |
-| mithril_pickaxe | stab | +17 | -2 | +8 | +12 | 5 |
-| adamant_pickaxe | stab | +23 | -2 | +10 | +16 | 5 |
-| rune_pickaxe | stab | +30 | -2 | +14 | +22 | 5 |
-| dragon_pickaxe | stab | +34 | -2 | +16 | +26 | 5 |
-
-### Metal Armor (Defense Bonuses)
-
-| Item | Slot | Stab | Slash | Crush | Science | Ranged |
-|------|------|------|-------|-------|---------|--------|
-| bronze_med_helm | head | +3 | +4 | +2 | -1 | +3 |
-| iron_med_helm | head | +5 | +6 | +3 | -1 | +5 |
-| steel_med_helm | head | +7 | +9 | +5 | -2 | +7 |
-| mithril_med_helm | head | +10 | +12 | +7 | -3 | +10 |
-| adamant_med_helm | head | +14 | +16 | +10 | -3 | +14 |
-| rune_med_helm | head | +19 | +22 | +13 | -4 | +19 |
-| bronze_full_helm | head | +5 | +6 | +4 | -3 | +5 |
-| iron_full_helm | head | +8 | +9 | +6 | -3 | +8 |
-| steel_full_helm | head | +12 | +13 | +9 | -5 | +12 |
-| mithril_full_helm | head | +16 | +18 | +12 | -6 | +16 |
-| adamant_full_helm | head | +22 | +24 | +16 | -8 | +22 |
-| rune_full_helm | head | +30 | +33 | +22 | -11 | +30 |
-| bronze_platebody | torso | +12 | +15 | +10 | -10 | +12 |
-| iron_platebody | torso | +18 | +22 | +14 | -10 | +18 |
-| steel_platebody | torso | +27 | +32 | +22 | -15 | +27 |
-| mithril_platebody | torso | +36 | +42 | +30 | -20 | +36 |
-| adamant_platebody | torso | +49 | +55 | +40 | -25 | +49 |
-| rune_platebody | torso | +65 | +72 | +52 | -30 | +65 |
-
-### Leather/Ranged Armor (Defense Bonuses)
-
-| Item | Slot | Stab | Slash | Crush | Science | Ranged | Other |
-|------|------|------|-------|-------|---------|--------|-------|
-| leather_cowl | head | +1 | +2 | +1 | +2 | +4 | |
-| leather_body | torso | +4 | +7 | +5 | +4 | +10 | |
-| leather_chaps | legs | +2 | +4 | +3 | +3 | +6 | |
-| leather_gloves | hands | +1 | +1 | +1 | +1 | +2 | |
-| leather_vambraces | hands | +2 | +2 | +2 | +2 | +4 | ranged_attack: +4 |
-| leather_boots | feet | +1 | +1 | +1 | +1 | +2 | |
-| coif | head | +2 | +4 | +2 | +4 | +6 | ranged_attack: +2 |
-| hard_leather_body | torso | +8 | +12 | +8 | +6 | +14 | |
-| hard_leather_shield | off_hand | +5 | +7 | +5 | +4 | +8 | |
-
-### Ranged Weapons (Attack Bonuses)
-
-| Item | Ranged Attack | Ranged Str | Speed |
-|------|--------------|------------|-------|
-| shortbow | +8 | 0 | 4 |
-| oak_shortbow | +14 | 0 | 4 |
-| willow_shortbow | +20 | 0 | 4 |
-| maple_shortbow | +29 | 0 | 4 |
-| yew_shortbow | +47 | 0 | 4 |
-| magic_shortbow | +69 | 0 | 4 |
-| longbow | +8 | 0 | 6 |
-| oak_longbow | +14 | 0 | 6 |
-| willow_longbow | +20 | 0 | 6 |
-| maple_longbow | +29 | 0 | 6 |
-| yew_longbow | +47 | 0 | 6 |
-| magic_longbow | +69 | 0 | 6 |
-
-### Ranged Ammo (Ranged Strength)
-
-| Item | Ranged Str |
-|------|-----------|
-| bronze_arrow | +7 |
-| iron_arrow | +10 |
-| steel_arrow | +16 |
-| mithril_arrow | +22 |
-| adamant_arrow | +31 |
-| rune_arrow | +49 |
-| bronze_bolts | +10 |
-| iron_bolts | +17 |
-| steel_bolts | +25 |
-| mithril_bolts | +32 |
-| adamant_bolts | +43 |
-| rune_bolts | +55 |
-| sapphire_bolts | +36 |
-| emerald_bolts | +39 |
-| ruby_bolts | +49 |
-| diamond_bolts | +52 |
-
----
-
-## Appendix B: OSRS Accuracy Formula Explanation
-
-The true OSRS accuracy formula is:
-
-```
-if attack_roll > defense_roll:
- hit_chance = 1 - (defense_roll + 2) / (2 * (attack_roll + 1))
-else:
- hit_chance = attack_roll / (2 * (defense_roll + 1))
-```
-
-This produces a smooth curve rather than the current binary hit/miss:
-- Equal rolls → ~50% hit chance
-- 2x attack vs defense → ~75% hit chance
-- 0.5x attack vs defense → ~25% hit chance
-- Very high attack → approaches ~100% but never reaches it
-- Very low attack → approaches ~0% but never reaches it
-
-This is more balanced than the current system where `attackRoll > defenseRoll` is always a hit and `<` is always a miss.
-
----
-
-## Appendix C: Files Modified (Summary)
-
-| File | Changes |
-|------|---------|
-| `internal/object/item.go` | `ItemStats` struct rewrite (14 fields), `AttackType` field on `ItemDef` |
-| `internal/world/mob.go` | New fields on `MobDef`, `MobInstance`, `SeedMobs` propagation |
-| `internal/combat/formulas.go` | Full rewrite: `HitChance`, `HitCheck`, `RangedStyleBonus`, `SelectAttackBonus`, `SelectDefenseBonus` |
-| `internal/game/cmd_attack.go` | `playerAttack` rewrite, `mobAttack` rewrite, `awardCombatXP` ranged support, ammo consumption |
-| `internal/game/equip_stats.go` | New file: `playerEquipBonuses` helper |
-| `internal/game/cmd_stats.go` | New file: `doStats` command |
-| `internal/game/cmd_look.go` | `showItemStats` helper, item/mob examination updates |
-| `internal/game/game.go` | Register `stats` in `classifyCommand` and `executeCommand` |
-| `internal/game/utils.go` | Updated `mobCombatLevel` formula |
-| `data/items/*.yaml` | ~66 item files updated with per-type stats |
-| `data/mobs/*.yaml` | 5 existing mobs updated, 8 new mobs added |
-| `data/help/combat.yaml` | New help file |
-| `data/help/stats.yaml` | New help file |
-| `data/help/style.yaml` | New/updated help file |
generated by cgit v1.2.3 (git 2.25.1) at 2026-09-08 20:34:33 +0000