A data-driven, AI-driven Hero Arena game. MOBA-inspired heroes auto-battle inside a circular arena using personality-driven AI brains. The engine never knows which hero it is running — every hero (stats, skills, AI personality, FX, sounds, voice, icons) is a single JSON data file. Nothing about a hero is hardcoded.
npm install # no dependencies; kept for convention
npm start # serve at http://localhost:4173
npm test # headless suite (config, ECS, skills, status, live matches, schemas)
npm run sim # run a 1v1 headless simulation with full agent log
npm run sim -- corsair-marshal lieutenant-4 30
- 1v1 Duel — you vs one opponent
- 2v2 Brawl — you and an ally vs two opponents
- Endless Survival — waves that scale forever
- Boss Rush — beat every boss in the roster
- Tournament — 8 fighters, single elimination
- Ranked — ELO ladder vs a graded opponent
- Training Grounds — endless practice, no rewards
- Sandbox — spawn any team you like
Press M to mute. Gold/xp are screens. Controls: M (mute), P (kick a match blank).
- Player picks a hero. The enemy is picked (by mode/rank/training).
- Heroes fight automatically: they move (chase / kite / dodge / retreat), cast skills, chain combos, and play to their own AI Brain personality.
- You watch the fight, read floating damage, and call tactics through the UI.
- Each hero is 100% JSON-delivered: stats, passives, 4 skills, animations, particles, sounds, voice lines, icons, portraits, AI behavior.
See docs/ARCHITECTURE.md for the full design.
- ECS datadriven entity graph + component-based simulation systems
- Data-driven skills — 35+ reusable skill behaviors (projectiles, beams, cones, dash/leap, shields, CC, DoTs, summons…)
- AI Brain — matrix of personality traits → decision utilities (GOAP-lite)
- Composition over inheritance everywhere; factories + strategy registry
- Official can add a hero by dropping one JSON file + art/audio
(see
docs/HOW-TO-ADD-A-HERO.md)
| Archetype | Characters |
|---|---|
| Tanky jumper/siege/split | Ironclad Marshal, Colossus Prime, Gilden Ward, Lance Imperator, Stormedge Warden |
| Brawler / fighter | Goliath Chief, Warden of the Dawn, Crimson Executioner, Stormblade Ronin, Jaws of Steel |
Every hero is distinct. Try the 1v1 matrix.
Adding Hero #501 requires only a JSON file in src/data/heroes/ plus any icon/art/audio
assets. No engine code changes.
npm run generate:hero -- --name "Your Hero" --class fighter --theme neon --personality reckless
npm run generate:hero -- --all # regenerate the whole roster procedurallytools/ dev server, hero generator CLI, headless sim
src/
core/ math, rng, object pool, event bus, config
ecs/ entity/component/system world
engine/ simulation loop, match, arena, game modes, leaderboard
ai/ AI brain, personality, targeting, combo planner
skills/ skill registry (35+ behaviors), factories, status effects
heroes/ schema, loader, validation, hero factory, generator
render/ canvas renderer, particles, procedural icons/portraits
audio/ procedural Web-Audio synth for effects, voice, music
ui/ menus, hero select, HUD, match log
data/heroes/*.json
main.js boot + wiring
tests/ node test runner based headless simulation
docs/ architecture + how-to-add-a-hero guides