Enemies, Waves and Bosses

Enemy reward categories

EnemyController.RewardCategory (byte enum) sets the XP multiplier tier applied server-side when a player kills the enemy:

ValueNameEnemyForge archetype default
0GruntRanged, Melee (default)
1Brute— (set manually)
2EliteElite archetype
3Boss— (set manually)

The rewardCategory field on EnemyController is assigned per-prefab in the Inspector and written by Enemy Forge from EnemyForgeDefinition.rewardCategory at build time. The server owns the XP calculation on /api/combat/kill.

Kill reporting

When an enemy dies, EnemyController.RpcNotifyEnemyKilled(enemyLevel, categoryValue, enemyInstanceId) is called on all clients. Only the local player's client sends the API call to avoid duplicate reports.

Payload sent to POST /api/combat/kill:

{ "characterId": <int>, "enemyLevel": <int>, "enemyCategory": "<string>", "enemyInstanceId": <uint> }

enemyCategory is the lowercase RewardCategory name (e.g. "grunt", "elite"). enemyInstanceId is the Mirror netId of the enemy at the time of death.

CombatSessionTracker.PostKill() handles the request when available; EnemyController.DirectPostKill() fires as a fallback. See Combat Core & Loop.

Per-hit reporting

Each authenticated player hit triggers POST /api/combat/hit from the hitting client. Only hits where the server can identify a PlayerIdentity on the attacker generate this call — the nearest-player aggro fallback does not. Payload includes characterId, enemyLevel, enemyCategory, enemyInstanceId, and damageDealt. This endpoint does not grant kill XP.

World bosses

Iron Warden (IronWardenController) is a world boss. It is not a player class.

Enemy Forge constraints

See Editor Tooling for full Enemy Forge documentation.

  • enemyLevel must be at least 1. The validator rejects values below 1, since the kill endpoint uses enemy level for XP calculation.
  • rewardCategory must be a valid EnemyController.RewardCategory value; the validator blocks deployment on an invalid category.
  • Enemy Forge runtime profile version: 28. Prefabs built with an earlier profile show a validator warning and need one Deploy pass to upgrade.

Enemy Forge enemies (not player classes)

Templar, Wizard, Chaos Weaver, Devastator, Pummeler, and Instigator are enemies authored in Enemy Forge. None are player classes.


Related: Editor Tooling · Combat Core & Loop · Loot, Inventory & Crafting