run_vtf_convert
Convert .tga, .png, .bmp, or .jpg images into engine-loadable .vtf files via VTFCmd, writing the output beside the source image.
Instructions
Converts an image (.tga, .png, .bmp, .jpg ...) into a .vtf the engine can load, written beside the source. The step that used to need a GUI: read_game_content finds what the game ships, this makes what it does not. Drives VTFCmd from ficool2's VTFEdit++, a separate download; health says whether it is installed. Reads the result back and reports its real format and size rather than the ones asked for.
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": {
"image": "<image>"
},
"name": "run_vtf_convert"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| flags | No | VTF flags to set, e.g. NOLOD, CLAMPS, CLAMPT. Passed through one by one. | |
| image | Yes | Path to the source image, absolute or relative to the repo root. | |
| format | No | Format for textures with no alpha: DXT1, BGR888, RGBA8888 ... VTFCmd's default is DXT1, which is what a wall texture should be. | |
| confirm | No | Required (true) to run this tool: it writes or executes. | |
| version | No | VTF version to write, e.g. 7.4. Left alone unless a target needs one. | |
| noMipmaps | No | Skip mipmaps. Right for a UI texture, wrong for anything in the world. | |
| alphaFormat | No | Format for textures that have an alpha channel. VTFCmd's default is DXT5. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| vtf | Yes | ||
| note | Yes | ||
| tool | Yes | ||
| bytes | Yes | ||
| image | Yes | ||
| header | Yes | ||
| written | Yes | ||
| exitCode | Yes | ||
| stdoutTail | Yes |