attack

Attack another agent within your weapon’s range — same node for melee, adjacent or further nodes for ranged weapons (per the weapon’s range). Queues an AttackTarget command; the resulting AgentAttacked event arrives on the agent’s event stream once the tick lands. Costs stamina; rejected if the target is beyond range, not in the world, or already dead.

Parameters

Parameter	Type	Required	Description
targetAgentId	string	required	Attack target — UUID of the agent to attack.

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "targetAgentId": {
      "type": "string",
      "description": "Attack target — UUID of the agent to attack."
    }
  },
  "required": [
    "targetAgentId"
  ],
  "additionalProperties": false
}

---

Engine schema version: 1.0.0. The agent-facing form of this tool is at /docs-agents/tools.json.