HexTactics: Headless Grid, A* Pathfinding & Combat Engine

HexTactics: Headless Grid, A* Pathfinding & Combat Engine

A production-ready headless tactical grid, pathfinding, and combat mechanics engine written in TypeScript.

Built for turn-based strategy games, tactical RPGs, auto-battlers, and tabletop simulations. Designed to run completely headless with zero DOM or rendering dependencies so you can plug it directly into Godot, Unity, Electron, PixiJS, or backend game servers.

---

Key Features

• Cube Coordinate System: Mathematically elegant hex math (X, Y, Z cube coordinates) with axial coordinate helpers and distance calculation.
• Optimized A* Pathfinding: Heuristic A* with custom terrain movement costs, impassable obstacles, and dynamic unit collision avoidance.
• Line of Sight & Field of View: Bresenham-style hex raycasting, sight range calculation, and obstacle occlusion.
• Turn-Based Combat Logic: Action points (AP), attack range checking, damage mitigation, critical strikes, and status effects.
• Comprehensive Automated Test Suite: Verified with deterministic CLI tests ensuring 100% test pass rate.

---

Quick Start

npm install
npm test

---

Commercial License

Royalty-free commercial license included. You may use this engine in any number of personal, indie, or commercial games and applications.