Gameplay & combat

​

What it does

• Health & death — Health { current, max }; apply_damage_system drains health from queued DamageEvents each tick; death_check_system marks entities Dead and emits DeathEvent.
• Damage & healing — POST /entity/damage and POST /entity/heal take an entity_id and an amount; the change is queued as an event and applied on the next tick. The internal DamageEvent model also carries a damage type (Physical / Magical / Pure / HpRemoval) used by the ability and combat layer, but this HTTP endpoint applies untyped damage.
• Stats & mitigation — incoming damage is resolved through stat_resolution_system / combat_math: Armor mitigates Physical and MagicResistances mitigates Magical damage before it reaches Health. DamageEvent also carries a free-form category: String, so games can classify damage as data alongside the fixed DamageType enum.
• More genre-neutral systems — the same layer ships stamina_system (Stamina), weapon_system (Weapon — cooldown / ammo / reload / hitscan resolution), and perception_system (line-of-sight awareness) as opt-in components a game attaches where it needs them.
• Projectiles — POST /projectile/spawn (direction, speed, damage, lifetime, radius); the projectile system moves and collides them.
• Trigger zones — POST /trigger/create AABB volumes that damage, heal, or teleport on overlap, once or repeatedly.
• Teams & roles — Team and EntityRole (Minion / Hero / Tower / Structure) drive targeting and scoring.

​

Example — damage an entity

# Spawn a target with 100 health on team 1
curl -s -X POST http://localhost:3917/spawn \
  -H 'Content-Type: application/json' -d '{"position":[5,0,0],"health":100,"team":1}'
# {"id":1, ...}

curl -s -X POST http://localhost:3917/entity/damage \
  -H 'Content-Type: application/json' -d '{"entity_id":1,"amount":25}'
# {"ok":true,"message":"Applied 25 damage to entity 1"}

curl -s -X POST http://localhost:3917/step -H 'Content-Type: application/json' -d '{"ticks":1}'
curl -s http://localhost:3917/entities/1
# {"id":1,"health":[75.0,100.0], ...}

​

Endpoints

​

Status

• Shipped — health/death, damage and healing events, projectiles, trigger zones, teams, roles, and scoring. All headless.
• The richer ability and crowd-control layer is on Abilities & status effects.