@edgemodders/redcode-mcp 0.2.0 → 0.4.0

package/CHANGELOG.md

@@ -1,15 +1,30 @@
-# Changelog
-
-## 0.2.0 (2026-10-16)
-
-The first version on npm, as `@edgemodders/redcode-mcp`. It needs REDbridge 0.8.0.
-
-- Run it with `npx -y @edgemodders/redcode-mcp`. Everything is bundled into one file, so an install pulls no other package. The bundled packages' notices are in `dist/ThirdPartyNotices.txt`.
-- TweakDB tools: `tweakdb_types`, `tweakdb_records`, `tweakdb_record`, `tweakdb_flat`, `tweakdb_search`, `tweakdb_names`.
-- Game sound tools: `sound_events`, `sound_extract`.
-- Project tools: `project_export`, `project_import`, `project_pack`.
-- Mod archive tools: `archive_open_mod`, `archive_extract_from_mod`.
-
-## 0.1.0 (2026-10-12)
-
-Not published. The first tools were the archives, CR2W to JSON and back, textures, hashes, and document sessions with patches.
+# Changelog
+
+## 0.4.0 (2026-10-27)
+
+The new tool needs REDbridge 0.11.0, the bridge for game 2.5; the rest work as in 0.3.0.
+
+- `mesh_items`: the TweakDB item records whose look shows a mesh, with the `.app` look, root entity and mesh appearance on the way. Needs REDbridge 0.11.0 or later.
+- An empty `REDBRIDGE_EXE`, `REDCODE_GAME_PATH` or `DOTNET_ROOT` counts as unset, so REDcode's VS Code settings still apply. A Claude Code plugin passes an option left blank as an empty variable, which hid them before.
+
+## 0.3.0 (2026-10-16)
+
+The new tools need REDbridge 0.10.0 (`loc_*`) and 0.9.0 (`sound_import`, `template`); the rest still work with 0.8.0.
+
+- `loc_languages`, `loc_search` and `loc_get`: the game's on-screen texts (LocKeys), with a project's own over them. Each `loc_search` result names its onscreens file and row, for `cr2w_open` and `cr2w_get_node`. Needs REDbridge 0.10.0.
+- `project_import` takes `template`, a game path or `.mesh` to start a new mesh from when a GLB has no mesh to import over, and a mesh import returns `mesh`: submeshes, the GLB's material names per submesh, material entries, appearances and what was resized. Needs REDbridge 0.9.0.
+- `sound_import`: override game sound effects in a project from `<hash>.wav` files. Needs REDbridge 0.9.0.
+
+## 0.2.0 (2026-10-16)
+
+The first version on npm, as `@edgemodders/redcode-mcp`. It needs REDbridge 0.8.0.
+
+- Run it with `npx -y @edgemodders/redcode-mcp`. Everything is bundled into one file, so an install pulls no other package. The bundled packages' notices are in `dist/ThirdPartyNotices.txt`.
+- TweakDB tools: `tweakdb_types`, `tweakdb_records`, `tweakdb_record`, `tweakdb_flat`, `tweakdb_search`, `tweakdb_names`.
+- Game sound tools: `sound_events`, `sound_extract`.
+- Project tools: `project_export`, `project_import`, `project_pack`.
+- Mod archive tools: `archive_open_mod`, `archive_extract_from_mod`.
+
+## 0.1.0 (2026-10-12)
+
+Not published. The first tools were the archives, CR2W to JSON and back, textures, hashes, and document sessions with patches.

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Edgemodders
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Edgemodders
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,80 +1,83 @@
-# @edgemodders/redcode-mcp
-
-Cyberpunk 2077 modding tools for AI assistants, over the Model Context Protocol (MCP). An assistant such as Claude Code gets the same engine as REDcode, the Cyberpunk 2077 modding workspace for Visual Studio Code. It can:
-- search and extract from the game's archives
-- read CR2W files as WolvenKit JSON, write them back, and edit them node by node with patches
-- decode textures
-- read TweakDB
-- find and extract game sounds
-- export, import and pack a WolvenKit project
-
-The server starts [REDbridge](https://github.com/Edgemodders/REDbridge), which runs [WolvenKit](https://github.com/WolvenKit/WolvenKit)'s libraries, and talks to it over stdio. Nothing links WolvenKit into this package, so it stays MIT. Credit for the file formats and the engine belongs to the WolvenKit team.
-
-## What you need
-
-- Windows, and Cyberpunk 2077 installed.
-- REDbridge. REDcode's **Install REDbridge** command fetches it, or you can unzip a [REDbridge release](https://github.com/Edgemodders/REDbridge/releases) anywhere.
-- The .NET 10 runtime: `winget install Microsoft.DotNet.Runtime.10`.
-- Node.js 20 or newer.
-
-## Setup
-
-Register it with Claude Code:
-
-```
-claude mcp add redcode -- npx -y @edgemodders/redcode-mcp
-```
-
-Any other MCP client takes the same command: `npx -y @edgemodders/redcode-mcp`.
-
-The server needs REDbridge.exe and the game folder. It looks for them in order: the command line, then the environment, then the VS Code settings REDcode uses. So on a machine where REDcode is set up, it needs no configuration.
-
-| Setting | Command line | Environment | VS Code setting |
-|---|---|---|---|
-| REDbridge.exe, or the folder containing it | `--bridge <path>` | `REDBRIDGE_EXE` | `redcode.bridgePath` |
-| Game folder | `--game <path>` | `REDCODE_GAME_PATH` | `redcode.gamePath` |
-| Per-user .NET runtime | `--dotnet-root <path>` | `DOTNET_ROOT` | `redcode.dotnetRoot` |
-
-For example: `claude mcp add redcode -- npx -y @edgemodders/redcode-mcp --bridge "D:\Tools\REDbridge" --game "D:\Games\Cyberpunk 2077"`.
-
-The bridge starts on the first tool call and loads the archive index in about three seconds, then stays up for the session. If it dies, the next call restarts it, and any open document sessions are lost. The tools need REDbridge 0.8.0 or newer; TweakDB and the sound names need 0.8.0 and 0.7.2.
-
-To build from source, run `npm install` and `npm run mcp:build` in the [REDcode repository](https://github.com/Edgemodders/REDcode), then point the client at `packages/redcode-mcp/dist/server.cjs` with `node`.
-
-## Tools
-
-| Tool | What it does |
-|---|---|
-| `bridge_info` | Versions, game folder, archive and file counts |
-| `archive_search`, `archive_list`, `archive_tree` | Find game files by substring, by prefix or archive with paging, or one folder level at a time |
-| `archive_extract`, `archive_extract_many` | Copy game files to disk as they are |
-| `cr2w_to_json`, `cr2w_file_to_json` | A game file or a file on disk as WolvenKit JSON, inline (cut at `maxChars`, 200,000 by default) or written to `outFile` |
-| `cr2w_from_json` | Write a CR2W file from WolvenKit JSON |
-| `texture_to_png`, `texture_file_to_png` | Decode an `.xbm` to PNG |
-| `hash_fnv1a64`, `hash_resolve` | Hash a string; look a hash up |
-| `archive_open_mod`, `archive_extract_from_mod` | List the resources in a mod's `.archive` on disk; extract them, by game path or hash. No game needed |
-| `project_export`, `project_import`, `project_pack` | WolvenKit's exporter (a mesh to glTF, a texture to an image, a `.wem` to Ogg) and importer between `source/archive` and `source/raw`; pack a folder into `<modName>.archive` |
-| `tweakdb_types`, `tweakdb_records`, `tweakdb_record`, `tweakdb_flat`, `tweakdb_search`, `tweakdb_names` | TweakDB as the game ships it, read offline from `tweakdb_ep1.bin` (the first call loads it, about 12 s). Records by type (subtypes included) or prefix with the flats you name, one record with every flat, one flat, a search by path words, and ids to paths. Record links come back as paths, LocKeys as `{ key, text }`. Bridge 0.8.0 |
-| `sound_events` | Find the game's sound effect events by words in their name or tags, each with the hashes of its sounds (its variations). Names from WolvenKit's event list, game 1.6. Bridge 0.7.2 |
-| `sound_extract` | Write an event's sounds, by name or hash, or single sounds by hash, as `.opus` files (Ogg Opus, 48 kHz) |
-| `cr2w_open`, `cr2w_get_node`, `cr2w_get_nodes`, `cr2w_search`, `cr2w_patch`, `cr2w_save`, `cr2w_close`, `cr2w_documents` | A document session: parse once, read one node or several at a time with arrays paged, search values and property names below a path, apply JSON Patch operations atomically with inverse operations returned, write through WolvenKit's writer |
-| `cr2w_describe_type`, `cr2w_create_instance` | A type's properties, defaults and enum values; a default instance to add |
-| `cr2w_read` | Open, read several paths, close, in one call |
-| `cr2w_edit_file` | Open, patch, save, close, in one call. With a game path and `outFile`, a modified copy; the archives are never changed |
-
-Paths are dotted from the root chunk and match WolvenKit's JSON: property names, array indices, `Data` under a handle or a buffer, `Chunks` under a package. The tool descriptions carry the three format rules an assistant has to know: numbers are 32-bit floats, `compiledData` is rebuilt from `components` on save, and defaults are not stored. The design is in [docs/design/cr2w-editor.md](../../docs/design/cr2w-editor.md).
-
-## Example
-
-Make a copy of a game light with a bigger radius, in one call:
-
-```json
-{
-  "tool": "cr2w_edit_file",
-  "path": "base\\entities\\lights\\photomode_arealight.ent",
-  "outFile": "E:\\mods\\mymod\\source\\archive\\base\\entities\\lights\\photomode_arealight.ent",
-  "ops": [{ "op": "replace", "path": "components.0.radius", "value": 12 }]
-}
-```
-
-The result names the file written, its size, and the inverse operation that would undo the edit.
+# @edgemodders/redcode-mcp
+
+Cyberpunk 2077 modding tools for AI assistants, over the Model Context Protocol (MCP). An assistant such as Claude Code gets the same engine as REDcode, the Cyberpunk 2077 modding workspace for Visual Studio Code. It can:
+- search and extract from the game's archives
+- read CR2W files as WolvenKit JSON, write them back, and edit them node by node with patches
+- decode textures
+- read TweakDB
+- find and extract game sounds
+- export, import and pack a WolvenKit project
+
+The server starts [REDbridge](https://github.com/Edgemodders/REDbridge), which runs [WolvenKit](https://github.com/WolvenKit/WolvenKit)'s libraries, and talks to it over stdio. Nothing links WolvenKit into this package, so it stays MIT. Credit for the file formats and the engine belongs to the WolvenKit team.
+
+## What you need
+
+- Windows, and Cyberpunk 2077 installed.
+- REDbridge. REDcode's **Install REDbridge** command fetches it, or you can unzip a [REDbridge release](https://github.com/Edgemodders/REDbridge/releases) anywhere.
+- The .NET 10 runtime: `winget install Microsoft.DotNet.Runtime.10`.
+- Node.js 20 or newer.
+
+## Setup
+
+Register it with Claude Code:
+
+```
+claude mcp add redcode -- npx -y @edgemodders/redcode-mcp
+```
+
+Any other MCP client takes the same command: `npx -y @edgemodders/redcode-mcp`.
+
+The server needs REDbridge.exe and the game folder. It looks for them in order: the command line, then the environment, then the VS Code settings REDcode uses. So on a machine where REDcode is set up, it needs no configuration.
+
+| Setting | Command line | Environment | VS Code setting |
+|---|---|---|---|
+| REDbridge.exe, or the folder containing it | `--bridge <path>` | `REDBRIDGE_EXE` | `redcode.bridgePath` |
+| Game folder | `--game <path>` | `REDCODE_GAME_PATH` | `redcode.gamePath` |
+| Per-user .NET runtime | `--dotnet-root <path>` | `DOTNET_ROOT` | `redcode.dotnetRoot` |
+
+For example: `claude mcp add redcode -- npx -y @edgemodders/redcode-mcp --bridge "D:\Tools\REDbridge" --game "D:\Games\Cyberpunk 2077"`.
+
+The bridge starts on the first tool call and loads the archive index in about three seconds, then stays up for the session. If it dies, the next call restarts it, and any open document sessions are lost. Most tools work with REDbridge 0.8.0 or newer; `sound_import` and `project_import`'s `template` need 0.9.0, and the `loc_*` tools 0.10.0.
+
+To build from source, run `npm install` and `npm run mcp:build` in the [REDcode repository](https://github.com/Edgemodders/REDcode), then point the client at `packages/redcode-mcp/dist/server.cjs` with `node`.
+
+## Tools
+
+| Tool | What it does |
+|---|---|
+| `bridge_info` | Versions, game folder, archive and file counts |
+| `archive_search`, `archive_list`, `archive_tree` | Find game files by substring, by prefix or archive with paging, or one folder level at a time |
+| `archive_extract`, `archive_extract_many` | Copy game files to disk as they are |
+| `cr2w_to_json`, `cr2w_file_to_json` | A game file or a file on disk as WolvenKit JSON, inline (cut at `maxChars`, 200,000 by default) or written to `outFile` |
+| `cr2w_from_json` | Write a CR2W file from WolvenKit JSON |
+| `texture_to_png`, `texture_file_to_png` | Decode an `.xbm` to PNG |
+| `hash_fnv1a64`, `hash_resolve` | Hash a string; look a hash up |
+| `archive_open_mod`, `archive_extract_from_mod` | List the resources in a mod's `.archive` on disk; extract them, by game path or hash. No game needed |
+| `project_export`, `project_import`, `project_pack` | WolvenKit's exporter (a mesh to glTF, a texture to an image, a `.wem` to Ogg) and importer between `source/archive` and `source/raw`; pack a folder into `<modName>.archive` |
+| `loc_languages`, `loc_search`, `loc_get` | The game's on-screen texts (LocKeys) per language, base game and Phantom Liberty, read offline. Search by LocKey, secondary key or words of the text; get by LocKey or secondary key. With `projectDir`, the project's own onscreens entries win. Bridge 0.10.0 |
+| `tweakdb_types`, `tweakdb_records`, `tweakdb_record`, `tweakdb_flat`, `tweakdb_search`, `tweakdb_names` | TweakDB as the game ships it, read offline from `tweakdb_ep1.bin` (the first call loads it, about 12 s). Records by type (subtypes included) or prefix with the flats you name, one record with every flat, one flat, a search by path words, and ids to paths. Record links come back as paths, LocKeys as `{ key, text }`. Bridge 0.8.0 |
+| `mesh_items` | The TweakDB item records whose look shows a mesh, each with its display name, the mesh appearance it shows, the `.app` look and the root entity on the way. Covers items that pick their look by `appearanceName`, such as clothing. Bridge 0.11.0 |
+| `sound_events` | Find the game's sound effect events by words in their name or tags, each with the hashes of its sounds (its variations). Names from WolvenKit's event list, game 1.6. Bridge 0.7.2 |
+| `sound_import` | Override game sound effects in a project from `<hash>.wav` files: the changed `.opuspak` files and a new index go into its `source/archive`. Bridge 0.9.0 |
+| `sound_extract` | Write an event's sounds, by name or hash, or single sounds by hash, as `.opus` files (Ogg Opus, 48 kHz) |
+| `cr2w_open`, `cr2w_get_node`, `cr2w_get_nodes`, `cr2w_search`, `cr2w_patch`, `cr2w_save`, `cr2w_close`, `cr2w_documents` | A document session: parse once, read one node or several at a time with arrays paged, search values and property names below a path, apply JSON Patch operations atomically with inverse operations returned, write through WolvenKit's writer |
+| `cr2w_describe_type`, `cr2w_create_instance` | A type's properties, defaults and enum values; a default instance to add |
+| `cr2w_read` | Open, read several paths, close, in one call |
+| `cr2w_edit_file` | Open, patch, save, close, in one call. With a game path and `outFile`, a modified copy; the archives are never changed |
+
+Paths are dotted from the root chunk and match WolvenKit's JSON: property names, array indices, `Data` under a handle or a buffer, `Chunks` under a package. The tool descriptions carry the three format rules an assistant has to know: numbers are 32-bit floats, `compiledData` is rebuilt from `components` on save, and defaults are not stored. The design is in [the CR2W editor design page](https://edgemodders.github.io/REDcode/design/cr2w-editor.html).
+
+## Example
+
+Make a copy of a game light with a bigger radius, in one call:
+
+```json
+{
+  "tool": "cr2w_edit_file",
+  "path": "base\\entities\\lights\\photomode_arealight.ent",
+  "outFile": "E:\\mods\\mymod\\source\\archive\\base\\entities\\lights\\photomode_arealight.ent",
+  "ops": [{ "op": "replace", "path": "components.0.radius", "value": 12 }]
+}
+```
+
+The result names the file written, its size, and the inverse operation that would undo the edit.

package/dist/ThirdPartyNotices.txt

@@ -1,4 +1,4 @@
-@edgemodders/redcode-mcp 0.2.0 bundles the following packages into dist/server.cjs. Their notices follow.
+@edgemodders/redcode-mcp 0.4.0 bundles the following packages into dist/server.cjs. Their notices follow.
 
 ------------------------------------------------------------------------------
 

package/dist/server.cjs

@@ -2874,20 +2874,20 @@ var require_compile = __commonJS({
     var util_1 = require_util();
     var validate_1 = require_validate();
     var SchemaEnv = class {
-      constructor(env) {
+      constructor(env2) {
         var _a;
         this.refs = {};
         this.dynamicAnchors = {};
         let schema;
-        if (typeof env.schema == "object")
-          schema = env.schema;
-        this.schema = env.schema;
-        this.schemaId = env.schemaId;
-        this.root = env.root || this;
-        this.baseId = (_a = env.baseId) !== null && _a !== void 0 ? _a : (0, resolve_1.normalizeId)(schema === null || schema === void 0 ? void 0 : schema[env.schemaId || "$id"]);
-        this.schemaPath = env.schemaPath;
-        this.localRefs = env.localRefs;
-        this.meta = env.meta;
+        if (typeof env2.schema == "object")
+          schema = env2.schema;
+        this.schema = env2.schema;
+        this.schemaId = env2.schemaId;
+        this.root = env2.root || this;
+        this.baseId = (_a = env2.baseId) !== null && _a !== void 0 ? _a : (0, resolve_1.normalizeId)(schema === null || schema === void 0 ? void 0 : schema[env2.schemaId || "$id"]);
+        this.schemaPath = env2.schemaPath;
+        this.localRefs = env2.localRefs;
+        this.meta = env2.meta;
         this.$async = schema === null || schema === void 0 ? void 0 : schema.$async;
         this.refs = {};
       }
@@ -3071,15 +3071,15 @@ var require_compile = __commonJS({
           baseId = (0, resolve_1.resolveUrl)(this.opts.uriResolver, baseId, schId);
         }
       }
-      let env;
+      let env2;
       if (typeof schema != "boolean" && schema.$ref && !(0, util_1.schemaHasRulesButRef)(schema, this.RULES)) {
         const $ref = (0, resolve_1.resolveUrl)(this.opts.uriResolver, baseId, schema.$ref);
-        env = resolveSchema.call(this, root, $ref);
+        env2 = resolveSchema.call(this, root, $ref);
       }
       const { schemaId } = this.opts;
-      env = env || new SchemaEnv({ schema, schemaId, root, baseId });
-      if (env.schema !== env.root.schema)
-        return env;
+      env2 = env2 || new SchemaEnv({ schema, schemaId, root, baseId });
+      if (env2.schema !== env2.root.schema)
+        return env2;
       return void 0;
     }
   }
@@ -4877,8 +4877,8 @@ var require_ref = __commonJS({
       schemaType: "string",
       code(cxt) {
         const { gen, schema: $ref, it } = cxt;
-        const { baseId, schemaEnv: env, validateName, opts, self } = it;
-        const { root } = env;
+        const { baseId, schemaEnv: env2, validateName, opts, self } = it;
+        const { root } = env2;
         if (($ref === "#" || $ref === "#/") && baseId === root.baseId)
           return callRootRef();
         const schOrEnv = compile_1.resolveRef.call(self, root, baseId, $ref);
@@ -4888,8 +4888,8 @@ var require_ref = __commonJS({
           return callValidate(schOrEnv);
         return inlineRefSchema(schOrEnv);
         function callRootRef() {
-          if (env === root)
-            return callRef(cxt, validateName, env, env.$async);
+          if (env2 === root)
+            return callRef(cxt, validateName, env2, env2.$async);
           const rootName = gen.scopeValue("root", { ref: root });
           return callRef(cxt, (0, codegen_1._)`${rootName}.validate`, root, root.$async);
         }
@@ -4919,14 +4919,14 @@ var require_ref = __commonJS({
     exports2.getValidate = getValidate;
     function callRef(cxt, v, sch, $async) {
       const { gen, it } = cxt;
-      const { allErrors, schemaEnv: env, opts } = it;
+      const { allErrors, schemaEnv: env2, opts } = it;
       const passCxt = opts.passContext ? names_1.default.this : codegen_1.nil;
       if ($async)
         callAsyncRef();
       else
         callSyncRef();
       function callAsyncRef() {
-        if (!env.$async)
+        if (!env2.$async)
           throw new Error("async schema referenced by sync schema");
         const valid = gen.let("valid");
         gen.try(() => {
@@ -25307,12 +25307,12 @@ var BridgeClient = class extends import_node_events.EventEmitter {
       return;
     }
     const args = this.options.gamePath ? ["--game", this.options.gamePath] : [];
-    const env = { ...process.env };
+    const env2 = { ...process.env };
     if (this.options.dotnetRoot) {
-      env.DOTNET_ROOT = this.options.dotnetRoot;
+      env2.DOTNET_ROOT = this.options.dotnetRoot;
     }
     this.stopping = false;
-    const child = (0, import_node_child_process.spawn)(this.options.exe, args, { env, stdio: ["pipe", "pipe", "pipe"], windowsHide: true });
+    const child = (0, import_node_child_process.spawn)(this.options.exe, args, { env: env2, stdio: ["pipe", "pipe", "pipe"], windowsHide: true });
     this.process = child;
     readline.createInterface({ input: child.stderr }).on("line", (line) => this.emit("log", line));
     child.on("error", (error2) => {
@@ -25423,13 +25423,17 @@ var BridgeClient = class extends import_node_events.EventEmitter {
     return this.call("project.export", { file, archiveDir, rawDir, options: options ?? null });
   }
   /** Imports a raw file under rawDir back into archiveDir, through WolvenKit's importer. keep: an existing file keeps its settings. Bridge 0.7.0. */
-  importFile(file, rawDir, archiveDir, keep = true) {
-    return this.call("project.import", { file, rawDir, archiveDir, keep });
+  importFile(file, rawDir, archiveDir, keep = true, template) {
+    return this.call("project.import", { file, rawDir, archiveDir, keep, template: template ?? null });
   }
   /** The sound event names WolvenKit knows, with their Wwise hashes, which name the groups in an .opusinfo. Bridge 0.7.2. */
   soundEvents() {
     return this.call("sound.events", {});
   }
+  /** Overrides game sound effects in a project from <hash>.wav files: the changed packs and index go under archiveDir. Bridge 0.9.0. */
+  importWavs(wavFiles, archiveDir) {
+    return this.call("sound.importWavs", { wavFiles, archiveDir });
+  }
   // ---- tweakdb (bridge 0.8.0): read offline from the game's tweakdb.bin, loaded on the first call (about 12 s) ----
   tweakTypes() {
     return this.call("tweakdb.types", {});
@@ -25450,6 +25454,37 @@ var BridgeClient = class extends import_node_events.EventEmitter {
   tweakNames(ids) {
     return this.call("tweakdb.names", { ids });
   }
+  /**
+   * The item records whose look shows a mesh (a game path), and every .app look that shows it. With
+   * appearance, only the looks that show that mesh appearance. Loads TweakDB on the first call. Bridge 0.11.0.
+   */
+  meshItems(path4, appearance, language = "en-us") {
+    return this.call("mesh.items", { path: path4, appearance: appearance ?? null, language });
+  }
+  // ---- on-screen texts (bridge 0.10.0) ------------------------------------------------
+  /** The languages with on-screen texts in the game, and whether the base game and Phantom Liberty have them. */
+  locLanguages() {
+    return this.call("loc.languages");
+  }
+  /**
+   * On-screen texts: "LocKey#123" or a number finds that LocKey; otherwise every word must be in the
+   * secondary key or a text. With projectDir, the project's onscreens entries win over the game's.
+   */
+  locSearch(query, language = "en-us", limit = 200, projectDir) {
+    return this.call("loc.search", { query, language, limit, projectDir: projectDir ?? null });
+  }
+  /** Entries by LocKey number or secondary key, with or without "LocKey#"; null where there is no text. */
+  locGet(keys, language = "en-us", projectDir) {
+    return this.call("loc.get", { keys, language, projectDir: projectDir ?? null });
+  }
+  /** The project's onscreens files for a language: those its .xl files name, then any in source/archive under <language>\onscreens. */
+  locProjectFiles(projectDir, language = "en-us") {
+    return this.call("loc.projectFiles", { projectDir, language });
+  }
+  /** The project's onscreens file for a language, written empty (and named in an .xl) when it has none. */
+  locNewFile(projectDir, modName, language = "en-us") {
+    return this.call("loc.newFile", { projectDir, modName, language });
+  }
   // ---- cr2w document sessions (bridge 0.5.0) -------------------------------------------
   /** Parses a file once and keeps it open in the bridge. A game path opens read-only. */
   openDocument(source) {
@@ -25498,10 +25533,13 @@ var BridgeClient = class extends import_node_events.EventEmitter {
 };
 
 // src/server.ts
-var Version = "0.2.0";
+var Version = "0.4.0";
 function arg(name) {
   const i = process.argv.indexOf(name);
-  return i >= 0 ? process.argv[i + 1] : void 0;
+  return i >= 0 ? process.argv[i + 1] || void 0 : void 0;
+}
+function env(name) {
+  return process.env[name]?.trim() || void 0;
 }
 function vscodeSetting(key) {
   const base = process.platform === "win32" ? process.env.APPDATA : process.platform === "darwin" ? path3.join(process.env.HOME ?? "", "Library/Application Support") : path3.join(process.env.HOME ?? "", ".config");
@@ -25510,13 +25548,13 @@ function vscodeSetting(key) {
   try {
     const text = fs3.readFileSync(file, "utf8");
     const match = text.match(new RegExp(`"${key.replace(/\./g, "\\.")}"\\s*:\\s*"((?:[^"\\\\]|\\\\.)*)"`));
-    return match ? JSON.parse(`"${match[1]}"`) : void 0;
+    return match ? JSON.parse(`"${match[1]}"`) || void 0 : void 0;
   } catch {
     return void 0;
   }
 }
 function resolveBridgeExe() {
-  let exe = arg("--bridge") ?? process.env.REDBRIDGE_EXE ?? vscodeSetting("redcode.bridgePath") ?? "REDbridge.exe";
+  let exe = arg("--bridge") ?? env("REDBRIDGE_EXE") ?? vscodeSetting("redcode.bridgePath") ?? "REDbridge.exe";
   if (exe && fs3.existsSync(exe) && fs3.statSync(exe).isDirectory()) {
     exe = path3.join(exe, "REDbridge.exe");
   }
@@ -25524,8 +25562,8 @@ function resolveBridgeExe() {
 }
 var config2 = {
   exe: resolveBridgeExe(),
-  gamePath: arg("--game") ?? process.env.REDCODE_GAME_PATH ?? vscodeSetting("redcode.gamePath"),
-  dotnetRoot: arg("--dotnet-root") ?? process.env.DOTNET_ROOT ?? vscodeSetting("redcode.dotnetRoot") ?? void 0
+  gamePath: arg("--game") ?? env("REDCODE_GAME_PATH") ?? vscodeSetting("redcode.gamePath"),
+  dotnetRoot: arg("--dotnet-root") ?? env("DOTNET_ROOT") ?? vscodeSetting("redcode.dotnetRoot") ?? void 0
 };
 var log = (line) => process.stderr.write(`[redcode-mcp] ${line}
 `);
@@ -25645,12 +25683,13 @@ tool("project_export", "Export a game file under a project's source/archive to t
   meshBinary: external_exports.boolean().optional().describe("Meshes as .glb (true, default) or .gltf."),
   meshMaterials: external_exports.boolean().optional().describe("Export a mesh's materials and textures too; default true.")
 }, (a, b) => b.exportFile(a.file, a.archiveDir, a.rawDir, { textureFormat: a.textureFormat, meshBinary: a.meshBinary, meshMaterials: a.meshMaterials }));
-tool("project_import", "Import a raw file under a project's source/raw back into source/archive through WolvenKit's importer (images to .xbm, glTF or GLB to .mesh, WAV, CSV and so on). With keep (default), the file it replaces keeps its settings: a texture its group, format, compression and flags. Returns ok and the files written, relative to archiveDir. Bridge 0.7.0.", {
+tool("project_import", "Import a raw file under a project's source/raw back into source/archive through WolvenKit's importer (images to .xbm, glTF or GLB to .mesh, CSV and so on; sound effects go through sound_import). With keep (default), the file it replaces keeps its settings: a texture its group, format, compression and flags. A GLB imports only over an existing .mesh at the same path: for a new asset, pass template (a game path or .mesh to start from, bridge 0.9.0). A mesh import also returns mesh: submesh count, the GLB's material names per submesh, the mesh's material entries, appearances, and how appearances were sized to the new submeshes. Returns ok and the files written, relative to archiveDir. Bridge 0.7.0.", {
   file: external_exports.string().describe("The raw file, under rawDir."),
   rawDir: external_exports.string().describe("The project's source/raw folder."),
   archiveDir: external_exports.string().describe("The project's source/archive folder."),
-  keep: external_exports.boolean().optional().describe("Keep the replaced file's settings; default true.")
-}, (a, b) => b.importFile(a.file, a.rawDir, a.archiveDir, a.keep ?? true));
+  keep: external_exports.boolean().optional().describe("Keep the replaced file's settings; default true."),
+  template: external_exports.string().optional().describe("For a GLB with no mesh to import over: a game path (base\\...mesh) or a .mesh file to start the new mesh from.")
+}, (a, b) => b.importFile(a.file, a.rawDir, a.archiveDir, a.keep ?? true, a.template));
 tool("project_pack", "Pack a folder (a project's source/archive) into <modName>.archive in outDir through WolvenKit's packer. Returns the archive path, size, file count and warnings for paths with capital letters or spaces. Bridge 0.6.1.", {
   dir: external_exports.string().describe("The folder to pack, laid out as game paths (base/..., ep1/...)."),
   outDir: external_exports.string().describe("Where the archive goes, usually packed/archive/pc/mod."),
@@ -25693,6 +25732,24 @@ tool("tweakdb_search", `TweakDB records whose path contains every word, any case
 tool("tweakdb_names", "Paths for TweakDB ids (0x hex or decimal) from WolvenKit's names list, null when unknown. Only the low 40 bits count, so ids with a flat-buffer offset match. Needs no TweakDB load. Bridge 0.8.0.", {
   ids: external_exports.array(external_exports.string())
 }, (a, b) => b.tweakNames(a.ids));
+tool("mesh_items", "The TweakDB item records whose look shows a mesh: the reverse of record > factory .csv > root .ent > .app look > mesh. Each item has record, type, displayName ({ key, text }), appearanceName, meshAppearance (the mesh appearance its look shows), app and look, and entity with entityAppearances (one per body and camera, such as s1_casual_01_basic_01_&Male). looks lists every .app look that shows the mesh, also those no item reaches (NPC appearances). Covers items that pick their look by appearanceName, such as clothing; not weapons, nor a mesh only a part entity holds. Loads TweakDB on the first call (about 10 s); the index after it takes under a second. Bridge 0.11.0.", {
+  path: external_exports.string().describe("The mesh's game path, such as base\\characters\\garment\\player_equipment\\feet\\s1_055_shoe__converse\\s1_055_pma_shoe__converse.mesh."),
+  appearance: external_exports.string().optional().describe("Only the looks that show this mesh appearance, such as red_yellow_graphic."),
+  language: external_exports.string().optional().describe("Localization folder for display names, default en-us.")
+}, (a, b) => b.meshItems(a.path, a.appearance, a.language ?? "en-us"));
+var LocRules = "Languages are folder names such as en-us or de-de (default en-us). With projectDir, the project's onscreens entries replace the game's ones with the same key. The first call per language loads it, about 1 s. Bridge 0.10.0.";
+tool("loc_languages", "The languages the game has on-screen texts for, and whether Phantom Liberty has them too. Bridge 0.10.0.", {}, (_a, b) => b.locLanguages());
+tool("loc_search", `Find on-screen texts: 'LocKey#123' or a number finds that LocKey, otherwise every word must appear, any case, in the secondary key or the female or male text. Each result has key (the LocKey number as text), secondaryKey, female, male, source (base, ep1 or project), and file and index: its onscreens file (a game path, or relative to projectDir for a project entry) and its row there, for cr2w_open and cr2w_get_node. ${LocRules}`, {
+  query: external_exports.string().describe("LocKey#123, a secondary key, or words such as 'militech pistol'."),
+  language: external_exports.string().optional(),
+  limit: external_exports.number().optional().describe("Most results to return (default 200)."),
+  projectDir: external_exports.string().optional().describe("A REDcode or WolvenKit project folder whose own texts should count.")
+}, (a, b) => b.locSearch(a.query, a.language ?? "en-us", a.limit ?? 200, a.projectDir));
+tool("loc_get", `The texts for LocKeys, by number or secondary key, with or without 'LocKey#'; null where there is none. ${LocRules}`, {
+  keys: external_exports.array(external_exports.string()).describe("Such as ['LocKey#12345', 'Gameplay-Devices-Computers-Common-NewsFeed']."),
+  language: external_exports.string().optional(),
+  projectDir: external_exports.string().optional()
+}, (a, b) => b.locGet(a.keys, a.language ?? "en-us", a.projectDir));
 var soundCache = path3.join(os.tmpdir(), "redcode-mcp", "sounds");
 var soundIndex;
 async function gameSounds(b) {
@@ -25713,6 +25770,10 @@ tool("sound_events", "Find the game's sound effect events by name or tag (words
   const hits = events.events.filter((e) => groups.has(e.hash) && words.every((w) => `${e.name} ${e.tags.join(" ")}`.toLowerCase().includes(w)));
   return { total: hits.length, events: hits.slice(0, a.limit ?? 100).map((e) => ({ ...e, sounds: groups.get(e.hash).map((i) => index.hashes[i]) })) };
 });
+tool("sound_import", "Override game sound effects in a WolvenKit project from WAV files, each named after the sound's hash (832549876.wav; sound_events gives the hashes). Writes the changed .opuspak files and a new sfx_container.opusinfo under the project's source/archive; earlier overrides there stay. Any rate and 16-bit, 24-bit or float WAV; encoded at 48 kHz Opus. Bridge 0.9.0.", {
+  wavFiles: external_exports.array(external_exports.string()).describe("Absolute paths of <hash>.wav files."),
+  archiveDir: external_exports.string().describe("The project's source/archive folder.")
+}, (a, b) => b.importWavs(a.wavFiles, a.archiveDir));
 tool("sound_extract", "Write game sound effects as .opus files (Ogg Opus, 48 kHz) named by sound hash: every variation of an event, by name or hash, or single sounds by hash. Voice lines are .wem files instead: use project_export.", {
   event: external_exports.string().optional().describe("An event name, such as w_gun_npc_nova_reload, or its decimal hash."),
   sounds: external_exports.array(external_exports.number()).optional().describe("Or sound hashes."),

package/package.json

@@ -1,57 +1,57 @@
-{
-  "name": "@edgemodders/redcode-mcp",
-  "version": "0.2.0",
-  "description": "Cyberpunk 2077 modding tools for AI assistants over MCP: the game archives, CR2W files as JSON and node-by-node edits, textures, TweakDB, game sounds, export, import and pack, through REDbridge and WolvenKit's engine.",
-  "license": "MIT",
-  "author": "Edgemodders",
-  "homepage": "https://edgemodders.github.io/REDcode/mcp.html",
-  "bugs": {
-    "url": "https://github.com/Edgemodders/REDcode/issues"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/Edgemodders/REDcode",
-    "directory": "packages/redcode-mcp"
-  },
-  "keywords": [
-    "cyberpunk",
-    "cyberpunk2077",
-    "modding",
-    "wolvenkit",
-    "mcp",
-    "mcp-server",
-    "model-context-protocol",
-    "redcode",
-    "tweakdb"
-  ],
-  "bin": {
-    "redcode-mcp": "dist/server.cjs"
-  },
-  "files": [
-    "dist/server.cjs",
-    "dist/ThirdPartyNotices.txt",
-    "README.md",
-    "CHANGELOG.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "build": "node esbuild.mjs",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "start": "node dist/server.cjs"
-  },
-  "devDependencies": {
-    "@modelcontextprotocol/sdk": "^1.32.1",
-    "vscode-jsonrpc": "^9.0.3",
-    "zod": "^3.25.0",
-    "@types/node": "^24.0.0",
-    "esbuild": "^0.28.2",
-    "typescript": "~5.9.3"
-  },
-  "engines": {
-    "node": ">=20"
-  },
-  "publishConfig": {
-    "access": "public",
-    "provenance": true
-  }
-}
+{
+  "name": "@edgemodders/redcode-mcp",
+  "version": "0.4.0",
+  "description": "Cyberpunk 2077 modding tools for AI assistants over MCP: the game archives, CR2W files as JSON and node-by-node edits, textures, TweakDB, game sounds, export, import and pack, through REDbridge and WolvenKit's engine.",
+  "license": "MIT",
+  "author": "Edgemodders",
+  "homepage": "https://edgemodders.github.io/REDcode/mcp.html",
+  "bugs": {
+    "url": "https://github.com/Edgemodders/REDcode/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Edgemodders/REDcode.git",
+    "directory": "packages/redcode-mcp"
+  },
+  "keywords": [
+    "cyberpunk",
+    "cyberpunk2077",
+    "modding",
+    "wolvenkit",
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "redcode",
+    "tweakdb"
+  ],
+  "bin": {
+    "redcode-mcp": "dist/server.cjs"
+  },
+  "files": [
+    "dist/server.cjs",
+    "dist/ThirdPartyNotices.txt",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "node esbuild.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "start": "node dist/server.cjs"
+  },
+  "devDependencies": {
+    "@modelcontextprotocol/sdk": "^1.32.1",
+    "vscode-jsonrpc": "^9.0.3",
+    "zod": "^3.25.0",
+    "@types/node": "^24.0.0",
+    "esbuild": "^0.28.2",
+    "typescript": "~5.9.3"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  }
+}