run_pakfile_extract
Extract files from a compiled map's embedded pakfile ZIP into a directory, such as packed cubemaps or soundscripts, with glob filtering, safe path handling and overwrite control.
Instructions
Extracts files from a compiled map's embedded pakfile (lump 40, a plain ZIP) into a directory. read_pakfile lists what is in there; this is what gets it out -- a packed cubemap to convert, a soundscript to read, a custom material to inspect. Refuses an entry whose name would escape the destination rather than sanitising it, and never overwrites unless told to. Needs the Python sidecar; see health.
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": {
"bsp": "<bsp>",
"into": "<into>"
},
"name": "run_pakfile_extract"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bsp | Yes | Path to the .bsp, absolute or relative to the repo root. | |
| into | Yes | Directory to write into. Created if it is not there. | |
| limit | No | How many files to write. A production map packs ten thousand. | |
| confirm | No | Required (true) to run this tool: it writes or executes. | |
| pattern | No | Glob over the in-map path, case-insensitive: `materials/maps/*/c*.vtf` for the cubemaps. Absent extracts everything, up to `limit`. | |
| overwrite | No | Replace files that are already there. Off by default. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bsp | Yes | ||
| into | Yes | ||
| note | Yes | ||
| bytes | Yes | ||
| count | Yes | ||
| matched | Yes | ||
| refused | Yes | ||
| written | Yes | ||
| skippedOverLimit | Yes |