⚔️ Playing in Encounter Mode

Encounter Mode is the default play mode. In this mode, terrain and tile painting are completely locked so you can interact with tokens without accidentally drawing over walls or water.

• Select a Token: Left-click any token on the battle map or in the right-hand initiative panel.
• Move a Token: Click and drag any token to an unoccupied tile on the grid.
• Token Context Menu: Right-click on any token to initiate attacks, command AI agents, inspect details, or activate pathfinding.
• Initiative & Turn Order: The initiative list in the right panel displays turn order. Click Next Turn (or press Spacebar) to cycle turns. Each full round automatically advances time by 6 seconds!
• HP Controls: Use the +1, -1, +5, -5 buttons directly in the initiative list to adjust token health on the fly.
• Templates: Click the 🏰 Templates button in the top bar to load prebuilt starter dungeons like The Sunken Crypt.

🧙‍♂️ DM Console & AI Commands

The console at the bottom connects directly to the dual-engine AI backend. Type any of the following commands:

🏹 Ranged Attacks, Combat & Pathfinding

Encounter Forge implements authentic D&D 5e distance calculations and tactical A* pathfinding:

• Attacking: Right-click an active token and select ⚔️ Melee Attack (5ft reach), 🏹 Ranged Attack (Shortbow 80ft / 320ft), or 🏹 Longbow (150ft / 600ft).
• Range Overlay:
  • Green Circle & Rings: Targets within normal weapon range (100% effective).
  • Yellow Circle & Rings: Targets within long range (disadvantage applies).
  • Amber Ring: The attacking token.
• Target Selection: While targeting mode is active, left-click on any highlighted enemy token to confirm the attack. Press Escape to cancel targeting.
• Tactical AI Pathfinding (A*): Right-click any token and choose 🧠 Tactical Move to Target (A* Path). The agent uses an 8-directional A* pathfinding algorithm that navigates intelligently around solid walls (#) and closed doors to reach its objective!

⏱️ The 13-Month Fantasy Calendar

Encounter Forge operates on a symmetrical 13-month fantasy solar calendar:

• Structure: Exactly 13 months, each with 28 days (4 weeks of 7 days). Total: 364 days per year.
• Days of the Week: Unimera, Dumera, Trimera, Quadrimera, Quintimera, Sextimera, Septimera.
• Months: Monoann, Diann, Triann, Tetrann, Pentann, Hexann, Heptann, Octoann, Enneann, Decann, Monodecann, Diadecann, Tridecann.
• Combat Turn Progression: Every completed round in initiative advances the clock by 6 seconds.

🛠️ Build Mode (Map Designer)

Click 🛠️ Build Mode in the top navigation bar to unlock map creation tools:

• Tile Palette: Select Dungeon or Town tiles from the left sidebar to paint walls (#), floor tiles (.), water (~), doors (D), and chests (C).
• Brush Dragging: Click and drag across cells to quickly paint corridors or rooms.
• Rectangle Fill: Hold Shift and drag with the left mouse button to paint rectangular areas.
• Right-Click Cell Notes: Right-click any cell to attach custom DM notes and lore. Cells with notes display a subtle green dot and hover tooltips.
• Fog of War: Toggle Fog of War in the left panel to reveal or hide areas of the dungeon dynamically for players.