8000 GitHub - alicomert/hero-arena · GitHub
[go: up one dir, main page]

Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

HERO ARENA

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

Modes

  • 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).

Concept

  • 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.

Architecture

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)

Included heroes (all original)

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.

Extensibility

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 procedurally

Project layout

tools/            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

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

0