{"_id":"@carlos1402/codewalker-mcp","_rev":"2-0488022fc82665757584eeb22f16eef3","name":"@carlos1402/codewalker-mcp","dist-tags":{"latest":"0.1.1"},"versions":{"0.1.0":{"name":"@carlos1402/codewalker-mcp","version":"0.1.0","keywords":["mcp","model-context-protocol","codewalker","gta-v","rpf"],"license":"MIT","_id":"@carlos1402/codewalker-mcp@0.1.0","maintainers":[{"name":"carlos1402","email":"sbarcecarlos@gmail.com"}],"bin":{"codewalker-mcp":"bin/codewalker-mcp.js"},"dist":{"shasum":"83cac452923ab9e7d571e7d418a29d04d932f049","tarball":"https://registry.npmjs.org/@carlos1402/codewalker-mcp/-/codewalker-mcp-0.1.0.tgz","fileCount":13,"integrity":"sha512-OvYrrC29ujo2jO/xeQwBg3ypHI54LOk1FAGeNxIBE+MLlohvbUYZn4SV3gP+UnfN0K7PHBPdNJwLafBCEfBI2w==","signatures":[{"sig":"MEYCIQDldNvWDT36nN/n1d5HT3j1xe5A92yHyqaHBpn/+g/lOgIhAOyvIaYbgi3C9oNiPtKZnb4jj4xVkmP2KyTfliEOliaX","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":6106235},"type":"commonjs","engines":{"node":">=18"},"gitHead":"90fd86a2c6b00a0b35a4f9c46b75d5b7b292c36c","scripts":{"pack:check":"npm pack --dry-run","prepare-server":"powershell -NoProfile -ExecutionPolicy Bypass -File scripts/prepare-server.ps1"},"_npmUser":{"name":"carlos1402","email":"sbarcecarlos@gmail.com"},"_npmVersion":"11.16.0","description":"CodeWalker MCP server for GTA V RPF, map, model, texture and project workflows.","directories":{},"_nodeVersion":"24.18.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/codewalker-mcp_0.1.0_1785581685904_0.7007964144914214","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@carlos1402/codewalker-mcp","version":"0.1.1","description":"CodeWalker MCP server for GTA V RPF, map, model, texture and project workflows.","license":"MIT","type":"commonjs","publishConfig":{"access":"public"},"bin":{"codewalker-mcp":"bin/codewalker-mcp.js"},"scripts":{"prepare-server":"powershell -NoProfile -ExecutionPolicy Bypass -File scripts/prepare-server.ps1","pack:check":"npm pack --dry-run"},"engines":{"node":">=18"},"keywords":["mcp","model-context-protocol","codewalker","gta-v","rpf"],"gitHead":"90fd86a2c6b00a0b35a4f9c46b75d5b7b292c36c","_id":"@carlos1402/codewalker-mcp@0.1.1","_nodeVersion":"24.18.0","_npmVersion":"11.16.0","dist":{"integrity":"sha512-kczNxKg4BUmYmlKqrKtyeLfvHs2QgEWEWdxwsLCXeVsQq9sJlTue+nlENJpi0UlZF84hEh/i9TvyuF6RqEGWiQ==","shasum":"13bf40f0865d7e69c37807e5c7fd3550e22ea4cf","tarball":"https://registry.npmjs.org/@carlos1402/codewalker-mcp/-/codewalker-mcp-0.1.1.tgz","fileCount":13,"unpackedSize":6107397,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDu2pCmeRBhiu13zPh8lu4+LC7G+Iv2t189R9z/pR3cKwIgCOTuTcHtd4e+j+xSiJ3WZj+IH9pfcFXX1hJqct5OV0c="}]},"_npmUser":{"name":"carlos1402","email":"sbarcecarlos@gmail.com"},"directories":{},"maintainers":[{"name":"carlos1402","email":"sbarcecarlos@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/codewalker-mcp_0.1.1_1785581858394_0.9625076799217394"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-01T10:54:45.764Z","modified":"2026-08-01T10:57:38.794Z","0.1.0":"2026-08-01T10:54:46.119Z","0.1.1":"2026-08-01T10:57:38.647Z"},"license":"MIT","keywords":["mcp","model-context-protocol","codewalker","gta-v","rpf"],"description":"CodeWalker MCP server for GTA V RPF, map, model, texture and project workflows.","maintainers":[{"name":"carlos1402","email":"sbarcecarlos@gmail.com"}],"readme":"# CodeWalker MCP\n\nAn MCP server for working with Grand Theft Auto V assets through the\n[CodeWalker](https://www.codewalker.dev/) file formats and RPF archive model.\nIt is intended for MCP clients such as Codex and Claude Code.\n\n## Requirements\n\n- Windows\n- .NET 8 Runtime\n- Node.js 18 or later\n- A local CodeWalker installation when opening CodeWalker applications is needed\n\nThe server can inspect standalone RPF archives without a GTA V installation.\nFor game indexing and safe mod operations, provide the GTA V directory explicitly.\n\n## Configure an MCP client\n\nAdd the following server definition to the MCP configuration for your client.\nReplace the example paths with paths on your machine.\n\n```json\n{\n  \"mcpServers\": {\n    \"codewalker\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@carlos1402/codewalker-mcp\",\n        \"--workspace\",\n        \"C:\\\\GTA-Modding\\\\workspace\",\n        \"--codewalker-dir\",\n        \"C:\\\\Tools\\\\CodeWalker\"\n      ]\n    }\n  }\n}\n```\n\n`--workspace` is a writable directory used for exports, staging and backups.\nIt defaults to the current directory. `--codewalker-dir` is optional and enables\nthe tools that launch CodeWalker, RPF Explorer, Project Window, Vehicle Viewer\nand Ped Viewer.\n\nAlternatively, set `CODEWALKER_DIR` and `CODEWALKER_MCP_WORKSPACE` environment\nvariables.\n\n## Capabilities\n\n- Scan GTA V or standalone RPF archives and search their files and directories.\n- Export raw files and CodeWalker XML; recursively export RPF directories.\n- Inspect YMAP, YTYP, YCD, YTD, YDR, YDD, YFT, YBN, AWC, YND and YNV resources.\n- Export DDS textures and decoded WAV streams from supported source assets.\n- Create and inspect native `.cwproj` projects.\n- Generate and resolve GTA V Jenk/meta hashes.\n- Create, transform, organise and validate YMAP entities and LOD relationships.\n- Prepare RPF imports, directory imports, XML conversion, texture changes and\n  archive operations.\n\nWrite operations are deliberately two-phase: a `prepare` call describes the\nchange and returns a confirmation token; only an explicit matching `apply` call\nwrites to `mods` and first creates a backup of an existing mod archive. Original\nGTA V archives are never modified by this server.\n\n## Command line\n\nThe package normally runs under an MCP client. It can also be started directly:\n\n```powershell\nnpx -y @carlos1402/codewalker-mcp --workspace C:\\GTA-Modding\\workspace\n```\n\nThe server communicates by JSON-RPC over standard input/output.\n\n## Development and publishing\n\nThis repository contains the server source and packaging scripts. From the\n`npm/codewalker-mcp` directory:\n\n```powershell\nnpm run prepare-server\nnpm run pack:check\nnpm publish --access public\n```\n\nUse a new semantic version for every npm publication. If the publishing account\nuses two-factor authentication, npm may request a current authenticator code or\na granular token with permission to bypass 2FA.\n\n## Notes\n\nCodeWalker is a separate project. This package does not include GTA V game data\nor grant access to proprietary game files. Use it only with content you are\nauthorised to inspect or modify.\n","readmeFilename":"README.md"}