Active Stats, Survival, Damage & Durability

4.1 Health (HP)

4.2 Stamina (STA pool)

Run multiplier: stamina_drain_run >> stamina_drain_walk — cannot sprint forever.

4.3 Mana (MP)

4.4 Hunger & thirst

Long-horizon satiety pools (0 = empty, max = full):

Not instant death at 0 — escalating debuffs while low:

Sustained critical state is required before HP loss — not one tick at 0%.

Auto-consume: when hunger or thirst falls below vitals.survival.auto_consume_ratio (default 0.5 of max), the player automatically eats or drinks one matching item from inventory or worn bags — loose food, nested bag contents, or water in a bottle/flask. Health/mana potions are not auto-used. Set the ratio to 0 to disable. Same idea as hired-worker meal_need_ratio.

4.5 Food sources & economy (decided)

Player-crafted food is a major economy pillar (09, 10). NPC stands sell crafted instances from settlement workers (18) — minimal stats, shelves deplete until workers replenish.

# example tuning (ruleset)
npc_bread:
  hunger_restore: 8          # of 100
  thirst_restore: 0
  stamina_bonus: 0
  buffs: []
  stand_price_copper: 5      # expensive per point restored

iron_stew:                   # player crafted (`09`)
  hunger_restore: 45
  stamina_regen_bonus: 10%
  buff_duration_ticks: 600
  typical_stall_price_silver: 2   # much better value

Design intent: Rational players buy from player stalls/brokers or craft; NPC stands prevent hard starvation in town without undercutting cooks.

5. Activity & biome modifiers

Per-tick drain multipliers stack:

hunger_drain = base_hunger_drain
             × activity_mult
             × biome_hunger_mult
             × encumbrance_mult

thirst_drain = base_thirst_drain
             × activity_mult
             × biome_thirst_mult

Authored in segment zone_metadata (01).

6. Rest & sleep

Workers must sleep at lodging when stamina low (13). Players cannot substitute infinite sprint for sleep without penalties.

7. Damage pipeline

Server-authoritative order (12):

1. Hit valid? (range, LoS, hit roll vs evasion)
2. Block active? ──yes──► 0 damage (stamina cost)
3. Dodge i-frames? ──yes──► 0 damage
4. Compute raw_damage (§7.1)
5. Apply mitigation (§7.2)
6. Apply resist by damage_type
7. Clamp: final = max(min_damage, final)
8. Apply to target HP
9. Wear durability on weapon (attacker) and armor (defender) (§8)

7.1 Raw damage (offense)

Physical (weapon / melee ability):

raw = uniform(damage_min, damage_max) × weapon_skill_factor × (1 + STR_scale)
      × crit_multiplier?

Spell:

raw = spell_base × spell_skill_factor × (1 + INT_scale + WIS_scale) × spell_power_gear

Skills (swords, evocation, …) and primaries both contribute — see 12 skill_scaling.

7.2 Mitigation (defense)

mitigation_rating = armor_physical
                  + stat_contribution(VIT, STR)
                  + shield_block_value (if blocking)
                  + sum(defensive_buff_modifiers)

damage_after_armor = raw × penetration_factor(armor_pen)
                   - mitigation_rating × mitigation_curve(raw)

# Or proportional formula — tune in ruleset:
damage_after_armor = raw × (1 - mitigation_rating / (mitigation_rating + K))

Mitigation does not apply on blocked or i-frame avoided hits.

7.3 Minimum damage (decided)

Any hit that connects (not blocked, not dodged, not immune) deals:

final_damage = max(min_damage_global, damage_after_resists)

min_damage may be 1 or scaled by weapon tier — ensures armor never grants full immunity to sustained attacks without immunity buffs.

7.4 Damage types & resists

8. Item durability

Tool wear on craft and paid NPC repair are in the game. Combat wear below (weapons, armor, shields, repair kits, self-repair) is still open.

8.1 Equipment wear

durability_loss = base_wear × hit_intensity × material_hardness_factor

8.2 Break states

On player death: corpse gear keeps current durability — no extra wear penalty (07).

8.3 Repair

Broken items remain in inventory — dead weight until repaired or salvaged.

8.4 Monster loot durability

Dropped equipment durability is per loot table entry — some templates roll worn (durability_pct range), others pristine. Not global random on every drop.

9. Combat resource interaction (12)

In combat (in_combat flag): STA/MP regen reduced; hunger/thirst mult applied.

10. NPC pool profiles

Typical npc_definition presets (19) — all configurable per def:

11. the terminal client / agent

flatland status                    # HP, STA, MP, hunger, thirst, debuffs
flatland eat <item>
flatland drink <item>
flatland rest | sleep
flatland repair <item> --at smith_northhold
flatland stand buy meal --stand market_stall_3

Agent JSON: pool values, drain multipliers, broken equipment flags.

12. Phasing

14. Cross-references

Mitigation uses modifier system from 08 §6.