OuchRPGBETAv0.39

⚔️ Combat

• To Hit: d20 + floor(DEX÷4) + weapon proficiency (0 or −2) ≥ enemy AC (10 + enemy DEF)
• Your Damage: floor(STR÷2) + ATK Bonus + Weapon ATK − floor(enemy DEF÷2) + d6
• Your AC: Based on armor type — Light (base+DEX), Medium (base+min(DEX,cap)), Heavy (flat). Unarmored = 10+DEX÷4. Cloth adds flat DEF on top. Shields add +1 to +4.
• Critical Hit: Natural 20 = double damage, always hits
• Flee: d20 + floor(DEX÷3) ≥ 12 (fail = free enemy attack)
• Enemy Counter-Attack: After every player action (attack or spell), the enemy attacks back if alive

📊 Stats Bar

Your stats bar shows your core attributes and derived combat values:

❤️ Resources

• ❤️ HP — Health Points. Reaches 0 = death. Restore with potions, resting, or tavern stays.
• 💎 MP — Magic Points. Needed to cast spells. Restores after combat (floor(WIS÷4)) and with potions.
• ⭐ XP — Experience Points. Earn from combat and exploration. Level up at threshold for new stats and spells.

📈 Base Stats

• ⚔ STR — Strength. Affects damage: floor(STR÷2) contributes to ATK.
• 🏃 DEX — Dexterity. Affects to-hit (DEX÷4), AC (DEX÷4), flee (DEX÷3), and base DEF (DEX÷4).
• 🛡 CON — Constitution. Affects maximum HP.
• 🧠 INT — Intelligence. Scales spell damage and healing for Mage and Healer spells.
• 👁 WIS — Wisdom. Scales Ranger utility spells. Restores MP after combat (floor(WIS÷4)).
• 🎭 CHA — Charisma. Scales Bard spell damage and healing.

⚔️ Derived Stats

• 🗡 ATK — Effective attack power: floor(STR÷2) + class bonus + weapon ATK + buffs − proficiency penalty.
• 🛡 AC — Armor Class: calculated from your armor type + DEX + shields. Higher = harder to hit.
• 💰 Gold — Currency for buying/selling in towns.

📦 Gear Slots (Paperdoll)

• ⛑️ Head — Helmets, crowns, hoods (flat DEF bonus)
• 🦺 Chest — Armor (Light/Medium/Heavy/Cloth) + armor type determines AC
• ⚔️ Right Hand — Weapons (swords, bows, staves, wands, maces)
• 🛡️ Left Hand — Shields (+1 to +4 AC)
• 👢 Feet — Boots, greaves (flat DEF bonus)
• 📿 Necklace — Amulets, orbs (flat DEF bonus)
• 💍 Ring 1 & 2 — Rings (flat DEF bonus, two slots)

💡 Hover over gear slots to see slot names. Click ✕ to unequip.

👾 Monster Traits

Enemies have traits that affect how your weapons and spells interact with them. Trait labels appear next to enemy names in combat.

• 🫧 Slime — Slashing/piercing weapons deal only 25% damage (blades pass through). Bludgeoning (maces, warhammers) deal 1.5×. Lightning spells deal 2×.
• 🦴 Undead — Non-magic weapons deal only 25% damage. Magic weapons bypass this. Sacred Flame deals 2× (stacks with holy weakness for up to 3×).
• 🔥 Fire Elemental — Immune to fire damage (0 dmg). Ice spells deal 2×.
• ❄️ Ice — Fire damage deals 1.5×. Resists ice.
• 🔥 Fire Affinity — Fire damage reduced to 50%.
• ☠️ Toxic — On a successful hit, may poison you (damage over several turns).
• 🛡️ Armored — Reduces all physical weapon damage by 2 points (after trait modifiers). Spells unaffected.
• 🐉 Dragon — Resists fire damage (50%). High natural defense.

⚡ Weaknesses & Resistances

Beyond traits, every enemy has elemental weaknesses and resistances that modify damage. Weaknesses deal 1.5× damage, resistances deal 0.5×. These stack multiplicatively with trait effects.

• 🔥 Fire: Flametongue Blade, Firebolt
• ❄️ Ice: Frost Nova, Frost Blade, Frosthammer
• ⚡ Lightning: Chain Lightning, Thunder Glaive
• ✨ Arcane: Magic Missile, Staff of Stars, Arcane Wand
• ☀️ Holy: Sacred Flame, Holy Cudgel, Mace of Smiting
• 🔊 Sonic: Echoing Chord, Rousing Finale, Bardic Warhorn

💡 Use 📖 Folk & Fable in combat to reveal an enemy's weaknesses and resistances. Example: Frost Nova (ice) vs Fire Elemental = trait 2× × weakness 1.5× = 3× total!

🗺️ Biomes

The world is divided into 6 biomes that grow harder the farther you travel from Crossroads. Each biome has unique enemies, loot, and a boss or two to test your strength. Difficulty determines enemy stat scaling and loot rarity; Encounters is the chance of finding an enemy per move. Biomes 3 (Crystal Caverns and Forgotten Ruins) share the same distance range — you'll find both.

💡 Enemy stats scale with distance: base × (1 + (difficulty − 1) × 0.15). Arcane Wastes enemies start at 1.75× — a Void Stalker (ATK 18) hits like ATK 31 right at the biome border.

Healers shine in the Forgotten Ruins (most undead are weak to ☀️ Sacred Flame). Arcane Wastes is the hardest biome — elementals resist common damage types and have high stats. Bring the right weapons.

☠️ Boss Fights

Tier-4 bosses are the most dangerous enemies in the world. Each has unique special abilities that trigger on cooldown during combat:

• 🌳 Ancient Treant (Forest, Arcane Wastes) — Root Bind: Damage + Root (−DEX for 2 turns). Seed Barrage: 3 hits of area damage.
• 🐉 Ancient Dragon (Mountains, Arcane Wastes) — Inferno Breath: Massive fire damage + Burn DoT (3 turns).
• 👑 Lich Lord Malachar (Ruins, Arcane Wastes) — Soul Drain: Damage + heals for half the amount.
• 👑 Lich King Azaroth (Ruins) — Soul Siphon: Drain life. Army of the Dead: 4 hits of undead energy.
• 🐍 World Serpent Jörmungandr (Swamp, Arcane Wastes) — Constrict: Damage + −DEX for 3 turns.
• 🐍 Mega-Hydra (Swamp) — Venom Spit: Poison DoT. Regeneration: Heals 15% max HP on cooldown.
• 💎 Crystal Golem (Caverns) — Crystal Shard: 3 hits of piercing damage. Petrifying Aura: −DEX for 3 turns.
• 🔥 Inferno Drake (Mountains) — Inferno Breath: Fire damage + Burn. Wing Buffet: Stun (skip your turn).
• 😈 Demon Lord Belphagor (Mountains, Arcane Wastes) — Hellfire Nova: 3 rapid hits that shred armor.
• ❄️ Frost Titan (Mountains) — Glacial Slam: Heavy damage + Freeze (skip your turn).
• 🕳️ Void Weaver Nyx (Arcane Wastes only) — Void Rift: Raw void energy damage. Phase Shift: Disorient (stun for 1 turn). Weak to ☀️ Holy and 🔥 Fire.

Boss fights award significantly better loot than regular enemies, including guaranteed rare+ items and increased gold.

🧙 Spells & Feats

Spells are available to Dropout Wizard, Stressed Apothecary with a Mace, and Out-of-Work Busker. Each has 6 spells unlocking at levels 1–5. Spells cost MP and scale with INT (Mage/Healer) or CHA (Bard) + dice rolls (d4–d8) for variance.

• Damage: Magic Missile, Firebolt, Frost Nova, Chain Lightning, Sacred Flame, Echoing Chord, Rousing Finale
• Heal: Mending Light, Second Wind (also grants death immunity)
• Buff: Arcane Shield (+DEF), Holy Ward (+DEF), Inspire Self (+STR), Dazzling Aria (+DEX)
• Debuff: Ankle Song (-DEX to enemy), Frost Nova slow
• Utility: Arcane Sight (reveal items), Detect Undead, Scavenge Song (+gold+items), Purify (remove debuffs)

Cast via Spells/Feats panel or type cast [spell name].

💡 Feats are MP-based abilities for physical classes. They work like spells but are labeled "FEAT" in the UI and use "⚔️ Use" instead of "✨ Cast". See the Feats section below for details.

⚔️ Feats

Feats are class abilities for Disgruntled Guard, Pickpocket on Probation, and Lost Poacher — similar to spells but focused on physical combat and utility. Each costs MP, has cooldowns, and scales with a class-specific stat: STR (Guard), DEX (Pickpocket), WIS (Poacher).

• Disgruntled Guard: 💥 Power Strike (Lv1, STR damage), 📢 Battle Cry (Lv2, STR buff), 🛡️ Shield Bash (Lv3, stagger + damage), ⚔️ Revenge (Lv4, counter-attack), 🏔️ Last Stand (Lv5, damage resistance)
• Pickpocket on Probation: 🗡️ Sneak Attack (Lv1, DEX damage), 👤 Shadow Step (Lv2, evade), 🐍 Poison Blade (Lv3, poison DoT), 💨 Vanish (Lv4, AC boost + stealth), 💀 Backstab (Lv5, massive DEX damage)
• Lost Poacher: 🎯 Precise Shot (Lv1, WIS bonus damage), 🐾 Track Prey (Lv2, reveal enemies), 🌿 Nature's Grasp (Lv2, nature damage), 🦅 Hunter's Sight (Lv3, reveal items/traps), 🪤 Trap Springer (Lv4, trap damage), 🌲 Wilderness Endurance (Lv5, massive HP/MP restore)

Use via Spells/Feats panel or type cast [feat name] (e.g., cast power_strike).

🎒 Inventory & Gear

• Take items: Click items in the event log, or type take [item]
• Equip: Weapons and Armor from inventory. Replaces currently equipped gear.
• Use: Potions and consumables are used instantly.
• Maps: Click "View" to open an interactive fantasy-style map of your explored landmarks. Multiple maps can coexist, each charting a different day's discoveries.
• Drop: Remove unwanted items from your pack.
• Unequip: Click ✕ on paperdoll slots to return gear to inventory.

🛡️ Armor System (v2.0)

D&D 5e-style AC. Non-proficient armor = −5 penalty, no DEX bonus.

• Unarmored: 10 + floor(DEX÷4)
• Cloth (Mage Robes, Vestments): Unarmored AC + flat DEF bonus. Any class can wear.
• Light Armor: Base AC + full DEX bonus. Disgruntled Guard/Lost Poacher/Pickpocket on Probation/Stressed Apothecary with a Mace/Out-of-Work Busker proficient.
• Medium Armor: Base AC + capped DEX bonus. Disgruntled Guard/Lost Poacher/Pickpocket on Probation/Stressed Apothecary with a Mace proficient.
• Heavy Armor: Flat AC (no DEX). Disgruntled Guard/Lost Poacher proficient.
• Shields: Add +1 to +4 AC. All classes except Out-of-Work Busker and Dropout Wizard can use shields.

Accessories (head, feet, necklace, rings) add flat DEF on top of your armor AC.

⚔️ Weapon Proficiency

Using a weapon type your class isn't proficient with imposes −2 to hit rolls and −1 ATK:

• Disgruntled Guard: All types (melee, ranged, staff, wand, mace)
• Lost Poacher: melee, ranged, staff, mace
• Pickpocket on Probation: melee, ranged, wand
• Dropout Wizard: staff, wand only
• Stressed Apothecary with a Mace: mace, staff only
• Out-of-Work Busker: melee, ranged, wand, staff

🎯 Utility Skills

8 skills checked via d20 + bonus vs DC. Bonus = floor(stat÷3) + (proficient ? +5 : 0) + floor(level÷2).

• 👟 Fancy Footwork (DEX, DC 12) — Dodge in combat (+5 DEF for 1 turn), or heal outside combat
• 💥 Rough & Tumble (STR, DC 13) — Grapple enemies (damage + stagger), workout for HP
• 🪄 Nimble Fingers (DEX, DC 14) — Pickpocket in combat/town, disarm traps
• 📖 Folk & Fable (INT, DC 13) — Identify enemy weaknesses, gain XP, find maps
• 🦅 Eagle Eye (INT, DC 11) — Scan rooms to reveal hidden items
• 🗣️ Fast Talk (INT, DC 12) — Charm travelers for gold, rarely talk down enemies
• 🥷 Sneak (DEX, DC 13) — Move silently, avoid enemies on your next move
• 🌿 Wilderness Wit (INT, DC 12) — Forage for food/water (heal HP + MP)

Click a skill button below the action bar to attempt a check. Combat skills work in and out of combat; non-combat skills are disabled during fights.

🗺️ Exploration

• Move: Click N/S/E/W on the direction pad, or type move [direction]
• Eagle Eye: Use the Eagle Eye skill to scan a room and reveal hidden items.
• Rest: Recover 30% max HP and MP (once per zone — must explore further to rest again).
• Find Town: Type "find town" or "town" for directions to the nearest settlement.
• Taverns: Stay the night for 3g (full restore, once per town).
• Maps: Buy a Hand-drawn Map (~20g) or Regional Atlas (~50g) from town shops. Click "View" in inventory to open an interactive fantasy-style map showing your charted landmarks, connected by paths, with towns labeled and a compass rose.
• Biomes: See the Biomes section below for details on each region's difficulty and enemies.

💾 Saving & Loading

• Save: Click 💾 Save or type save. Saves to a timestamped JSON file.
• Load: From Saves panel (in-game) or main page. Full state restored.
• Delete: Remove old saves from the Saves panel.

💀 Death

• Resurrect: Return to Crossroads at 50% HP. Lose 50% gold and 5% XP. All gear, inventory, and discovered rooms kept.
• Load Save: Restore from any previous save point.
• New Adventure: Start completely fresh.

📝 Text Commands

Type in the action box:

• move north/south/east/west — Travel
• attack — Fight enemy
• flee — Try to escape combat
• take [item] / get [item] — Pick up item
• equip [item] — Equip weapon/armor, use consumables/potions/maps
• drop [item] — Discard item
• rest / sleep — Recover HP/MP (once per zone)
• find town / town — Directions to nearest settlement
• skill [name] — Attempt a skill check (e.g., skill eagle_eye)
• inventory — List items
• save — Save game
• cast [spell] — Cast spell or use feat
• skill [name] — Attempt a utility skill check

🏅 Item Rarity

• ● Common — Basic gear
• ● Uncommon — Better stats
• ● Rare — Strong equipment (e.g., Flametongue Blade +12 ATK, Crystal Plate DEF 11)
• ● Epic — Powerful gear (e.g., Dragonfang Greatsword +18 ATK, Frosthammer bludgeoning/magic)
• ● Legendary — Ultimate gear (e.g., Staff of Stars +25 ATK, Celestial Plate DEF 18, Thunder Glaive +22)

🎵 Audio

Layered audio system using Web Audio API — procedural ambient loops, MP3 tracks for combat/town/boss music, and procedural combat SFX.

• Biome Ambient: Procedural loops unique to each biome — sweeping wind and birds (forest), murky drones (swamp), stone echoes (cave), howling winds (mountain), creaking FM (ruins), detuned pads (magical).
• Town Music: MP3 ambient track with layered SFX (fountain, birds, chatter). Crossfades in on town entry.
• Combat Music: MP3 battle theme at 0.65× volume. Starts on combat entry, crossfades on exit.
• Boss Music: Dramatic MP3 boss theme at 1.3× volume. Plays for tier-4 encounters only.
• Volume Control: Tap the 🔊 speaker icon for the volume slider (0–100%, persisted to localStorage).
• Combat SFX: Procedural one-shots — heavy thumps (hit), soft swooshes (miss), shimmering chimes (spells).

💡 Audio starts muted by default. Tap 🔊 to enable, then adjust volume to your preference.