Embark on a perilous journey into the depths of the dungeon, where romance and danger await.

Waifu Dungeon Crawler is a turn-based RPG that combines classic dungeon crawling with a unique relationship system. Assemble your party, battle fierce monsters, and forge bonds that grant power... or face permadeath together.

• Strategic Turn-Based Combat: Master a combat system where every decision counts. Player, Waifu, and enemy turns flow in real-time with visible health and mana bars.
• Waifu Party System: Recruit unique companions — each with their own class, personality, alignment, and combat AI. Waifus attack, heal, and use special abilities on their own.
• Permadeath & Save Deletion: Death is permanent. When you fall, your save file is obliterated — no reloading, no second chances. The dungeon mocks you on the way out. 💀
• Branching Dungeon Paths: Choose your route through procedurally generated dungeons. Multiple doors with cryptic hints lead to different encounters — treasure, traps, or terrors.
• Rich Dialogue System: Party members react to events, banter during exploration, warn of danger, and share romantic moments based on mood, alignment, and attraction level.
• Deep Itemization: Diablo-inspired equipment system with 10 gear slots, magical properties, rarity tiers, and class-specific loot drops.
• Save & Load System:
  • Auto-Save: Progress is saved when entering the dungeon, changing rooms, or buying items.
  • Manual Save: Save at any time from the top bar.
  • Continue Adventure: Resume exactly where you left off — if you're still alive.
• Starting Gear: New characters spawn with class-specific weapons and armor (e.g., Iron Sword & Chainmail for Warriors).
• Relationship Mechanics: Deepen bonds through dialogue choices and shared victories to unlock stat bonuses. Alignment compatibility creates party tension or harmony.
• Procedural Dungeons: Explore multiple floors of increasing difficulty with shops, mini-bosses, random events, traps, and final bosses.
• Class-Specific Resources: Warriors use Rage (red), Rogues use Energy (yellow), Mages and Healers use Mana (blue) — each displayed with unique resource bars in combat.
• Difficulty Settings: Easy, Normal, or Hard — affecting enemy stats, XP, and gold rewards.

No build tools, no dependencies — just open and play.

1. Download: Clone the repo or click Code → Download ZIP on GitHub.

   git clone https://github.com/linux4life1/Waifu-Dungeon-Crawler.git

2. Open: Navigate to the folder and open index.html in any modern browser (Chrome, Firefox, Edge).
3. Play: That's it — the game runs entirely in your browser with no server required.

Tip: For the best experience, use a Chromium-based browser (Chrome or Edge) at full screen.

1. Create Your Hero: Choose your starting class and difficulty.
2. Draft Your Party: Select up to 3 companions to join your quest.
3. Explore: Navigate branching dungeon paths, uncover events, and find treasure.
4. Fight: Engage in tactical battles. Use skills, items, and your party's synergy to survive.
5. Romance: Build relationships through dialogue choices. High attraction unlocks special moments.
6. Survive: Death is permanent and your save is deleted. How deep can you go?

The dungeon hungers for more. Here's what's planned:

• 🗺️ More Levels & Bosses — Additional dungeon floors with unique themes, mechanics, and fearsome boss encounters.
• 💘 More Waifus — Expand the roster with new companions, personalities, alignments, and backstories.
• 👥 Larger Parties — Increase the party size limit for even more strategic combat compositions.
• ⚔️ More Player Classes — New starting classes with unique abilities, resource types, and playstyles.
• 🎨 Waifu Avatars — Custom-generated character portraits to bring each companion to life.

• Pure HTML, CSS, and JavaScript — no framework dependencies
• Google Fonts (Cinzel, Outfit) for dark fantasy typography
• Local Storage for save/load persistence
• Event-driven architecture with custom EventEmitter

This project is licensed under the GNU General Public License v3.0.

See LICENSE for the full text.

Can you conquer the dungeon and find true love? Or will the darkness consume you — and your save file?