validate_io
Checks VMF/BSP entity output wiring against the game's FGD to catch missing targets or inputs that pass compile checks but silently do nothing in game.
Instructions
Checks a map's entity wiring against the game's own FGD. read_fgd_class has been able to say what inputs a class has since the beginning and nothing has ever used it to judge a map, so an output aimed at an entity that does not exist, or at an input its class does not have, passes every check here and every check vbsp makes -- and then does nothing in game. That is the quietest failure a map has. Targets the engine resolves at runtime (!activator, !self, !player) are reported as unresolvable rather than as broken, and a class with no FGD schema is not judged at all: absence of a definition is not evidence of a fault. Needs the Python sidecar and the game's FGD.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"path": "<path>"
},
"name": "validate_io"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| game | No | Game profile id. This fork supports only 'l4d2', which is also the default; any other id is refused rather than answered about the wrong game. | |
| path | Yes | Path to the .vmf or .bsp, absolute or relative to the repo root. | |
| limit | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| game | Yes | ||
| path | Yes | ||
| format | Yes | ||
| findings | Yes | ||
| nextStep | Yes | ||
| warnings | Yes | ||
| errorCount | Yes | ||
| warningCount | Yes | ||
| classesChecked | Yes | ||
| connectionCount | Yes | ||
| unresolvedTargets | Yes |