@edgemodders/redcode-mcp 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 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.

package/README.md

@@ -37,7 +37,7 @@ The server needs REDbridge.exe and the game folder. It looks for them in order:
 
 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.
+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`.
 
@@ -54,8 +54,10 @@ To build from source, run `npm install` and `npm run mcp:build` in the [REDcode
 | `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 |
 | `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 |

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.3.0 bundles the following packages into dist/server.cjs. Their notices follow.
 
 ------------------------------------------------------------------------------
 

package/dist/server.cjs

@@ -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,30 @@ var BridgeClient = class extends import_node_events.EventEmitter {
   tweakNames(ids) {
     return this.call("tweakdb.names", { ids });
   }
+  // ---- 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,7 +25526,7 @@ var BridgeClient = class extends import_node_events.EventEmitter {
 };
 
 // src/server.ts
-var Version = "0.2.0";
+var Version = "0.3.0";
 function arg(name) {
   const i = process.argv.indexOf(name);
   return i >= 0 ? process.argv[i + 1] : void 0;
@@ -25645,12 +25673,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 +25722,19 @@ 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));
+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 +25755,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,6 +1,6 @@
 {
   "name": "@edgemodders/redcode-mcp",
-  "version": "0.2.0",
+  "version": "0.3.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",
@@ -10,7 +10,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/Edgemodders/REDcode",
+    "url": "git+https://github.com/Edgemodders/REDcode.git",
     "directory": "packages/redcode-mcp"
   },
   "keywords": [