Puzzle Forge Arena

A strategic puzzle-combat RPG that fuses match 3 exchanger mechanics with auto-battle army building, persistent progression, and cloud-based asynchronous PvP. Built with Phaser 3 and TypeScript.

🎮 Game Status

Version  - v0.17.0 - Stability Update

 - 🛡️ Critical stability improvements
 - 🧠 Fixed memory leaks for smooth performance
 - 💾 Resolved save corruption issues
 - 🌐 Added network retry logic
 - 🎮 No more crashes during extended play!

✅ Core Features

Puzzle Mechanics

• Match-3 Merging: 3+ identical materials connect vertically to merge
• 6×8 Grid: Strategic puzzle space with upward gravity
• 6 Material Tiers: Copper → Bronze → Iron → Steel → Mithril → Adamantine 
• Cascade System: Chain reactions grant 2×, 4×, 8×+ multipliers
• Multi-grab: Hold up to 3 materials simultaneously

Battle System

• 288 Unique Units (48 per character)
• Auto-Battle: Armies clash every 30 seconds
• Unit Creation: Merge size determines unit type (3 = base, 4+ = advanced)
• Star System: Units upgrade via accumulated power
• Portrait Grid: Clean 2×3 layout showing highest-tier units

Game Modes

• Campaign: 20 progressive AI battles
     - Unlock Characters by winning 5 battles in a row
• Ranked: Asynchronous PvP vs. player ghosts
• Ghost System: Your runs are recorded for others to fight
• Leaderboards: Global top 100

Character System

• 6 Playable Characters (12 planned):
  • Warrior – Balanced starter
  • Blacksmith – Weapons & armor
  • Pyromancer – Fire magic
  • Rogue – Stealth & poison
  • Frost Queen – Ice & crystal
  • Necromancer – Undead legion
• Levels 1–50 per character
• Unique sprites for every character, material, and unit - (currently using placeholder art generated by Midjourney)

Cloud Integration (LootLocker)

• Guest & email auth with 24-hour persistent login
• Automatic cloud saves & cross-device sync
• Ghost storage & real-time leaderboards
• Offline play with later sync

🎮 Controls

Desktop

• Move: A/D or ←/→ or mouse click
• Grab: S, ↓, or Left-click
• Shoot: W, ↑, or Right-click
• Fast 600 px/s movement, input buffering, visual cues

Mobile

• Touch joystick + grab/shoot buttons
• Responsive layout for any screen

🏆 Progression Systems

Experience & Levels

• Account Level 1–99
• Character Levels 1–50
• Polynomial XP curve: 50 × (N-1)^1.5 / 1.5
• XP from wins, streaks, and bonuses
• Animated post-battle breakdown

Unlocks

• Characters, units, and material tiers via gameplay
• No pay-to-win elements

🌐 Online Features

Ghost PvP

• Fight recorded ghosts of real players
• Matchmaking within ±300 rating
• Hold multiple ranks seeing the leaderboard with your ghosts
• Win-streak tracking

Leaderboards

• Global top 100 with real-time updates
• Your rank highlighted

🎯 How to Play

1. Grab materials from column bases (S / Left-click)
2. Shoot materials into columns (W / Right-click)
3. Match 3+ vertically to merge
4. Create units via merges—bigger = stronger
5. Battle triggers every 30 seconds automatically

Material Merge Table

• 5 Copper → 1 Bronze
• 2 Bronze → 1 Iron
• 5 Iron → 1 Steel
• 2 Steel → 1 Mithril
• 5 Mithril → 1 Adamantine
• 2 Adamantine → Legendary

Strategy Tips

• Plan cascades for huge multipliers
• Large merges spawn elite units
• Build before the 30-second timer hits
• Pick characters that fit your style

📚 Documentation

• Tutorial Guide
• Character Guide
• Unit Reference
• Feature Overview
• Roadmap
• Changelog

🚀 Recent Updates (v0.16.5)

• 24-hour persistent login
• Password fields masked
• Polynomial XP scaling + data migration
• Victory screen sync fix
• Switched to DebugLogger – zero console.log noise

📄 License

All rights reserved  @echoswarm2025

---

Forge Blitz – Where puzzle strategy meets epic battles!