universal-game-modder 0.1.4

package/dist/backends/mcp-child.js

@@ -0,0 +1,102 @@
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+import { logger } from '../utils/logger.js';
+import { eventBus } from '../core/event-bus.js';
+export class McpChild {
+    config;
+    client = null;
+    transport = null;
+    connected = false;
+    connecting = false;
+    pid;
+    constructor(config) {
+        this.config = config;
+    }
+    get name() {
+        return this.config.name;
+    }
+    get isConnected() {
+        return this.connected;
+    }
+    async ensureConnected() {
+        if (this.connected)
+            return;
+        if (this.connecting) {
+            // Wait for ongoing connection
+            while (this.connecting) {
+                await new Promise(r => setTimeout(r, 50));
+            }
+            if (this.connected)
+                return;
+        }
+        this.connecting = true;
+        try {
+            logger.info(`Spawning child MCP server: ${this.config.name}`, {
+                command: this.config.command,
+                args: this.config.args,
+            });
+            this.transport = new StdioClientTransport({
+                command: this.config.command,
+                args: this.config.args || [],
+                env: { ...process.env, ...this.config.env },
+                stderr: 'pipe',
+            });
+            this.client = new Client({ name: `ugm-${this.config.name}`, version: '1.0.0' }, { capabilities: {} });
+            await this.client.connect(this.transport);
+            this.connected = true;
+            eventBus.emit('child:status', {
+                name: this.config.name,
+                pid: this.pid,
+                status: 'spawned',
+            });
+            logger.info(`Child MCP server connected: ${this.config.name}`);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            logger.error(`Failed to connect child: ${this.config.name}`, msg);
+            eventBus.emit('child:status', {
+                name: this.config.name,
+                status: 'error',
+                error: msg,
+            });
+            throw err;
+        }
+        finally {
+            this.connecting = false;
+        }
+    }
+    async callTool(toolName, args) {
+        await this.ensureConnected();
+        if (!this.client)
+            throw new Error(`Child ${this.config.name} not connected`);
+        const result = await this.client.callTool({ name: toolName, arguments: args });
+        return result;
+    }
+    async listTools() {
+        await this.ensureConnected();
+        if (!this.client)
+            throw new Error(`Child ${this.config.name} not connected`);
+        const result = await this.client.listTools();
+        return result.tools;
+    }
+    async close() {
+        if (this.client && this.connected) {
+            try {
+                await this.client.close();
+            }
+            catch {
+                // Ignore close errors
+            }
+            this.connected = false;
+            eventBus.emit('child:status', {
+                name: this.config.name,
+                status: 'exited',
+                exitCode: 0,
+            });
+            logger.info(`Child MCP server closed: ${this.config.name}`);
+        }
+        this.client = null;
+        this.transport = null;
+    }
+}
+//# sourceMappingURL=mcp-child.js.map

package/dist/backends/mcp-child.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-child.js","sourceRoot":"","sources":["../../src/backends/mcp-child.ts"],"names":[],"mappings":"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"}

package/dist/core/config.d.ts

@@ -0,0 +1,10 @@
+export interface UgmConfig {
+    unityDecompilerExe: string;
+    unrealAssetExe: string;
+    pythonExe: string;
+    jarEditorScript: string;
+    webPort: number;
+    steamPaths: string[];
+    modTemplatesDir: string;
+}
+export declare function loadConfig(): UgmConfig;

package/dist/core/config.js

@@ -0,0 +1,48 @@
+import { readFileSync, existsSync } from 'fs';
+import { resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+const DEFAULTS = {
+    unityDecompilerExe: '',
+    unrealAssetExe: '',
+    pythonExe: 'python',
+    jarEditorScript: '',
+    webPort: 7777,
+    steamPaths: [],
+    modTemplatesDir: '',
+};
+let cachedConfig = null;
+/**
+ * Config resolution order (privacy fix, 2026-09-02 -- Gatekeeper finding):
+ *   1. $UGM_CONFIG            explicit path, wins outright
+ *   2. ugm.config.local.json  developer / machine-specific paths (git-ignored, NEVER shipped)
+ *   3. ugm.config.json        the tracked, shippable file -- placeholders only
+ *   4. built-in defaults
+ * Every loaded file is merged OVER the defaults, so a partial file is fine.
+ */
+export function loadConfig() {
+    if (cachedConfig)
+        return cachedConfig;
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = dirname(__filename);
+    const projectRoot = resolve(__dirname, '..', '..');
+    const candidates = [
+        process.env.UGM_CONFIG,
+        resolve(projectRoot, 'ugm.config.local.json'),
+        resolve(projectRoot, 'ugm.config.json'),
+    ].filter((p) => !!p);
+    for (const configPath of candidates) {
+        if (!existsSync(configPath))
+            continue;
+        try {
+            const raw = readFileSync(configPath, 'utf-8');
+            cachedConfig = { ...DEFAULTS, ...JSON.parse(raw) };
+            return cachedConfig;
+        }
+        catch (err) {
+            // unreadable / malformed -> try the next candidate
+        }
+    }
+    cachedConfig = { ...DEFAULTS };
+    return cachedConfig;
+}
+//# sourceMappingURL=config.js.map

package/dist/core/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAYpC,IAAI,YAAY,GAAqB,IAAI,CAAC;AAE1C,MAAM,UAAU,UAAU;IACxB,IAAI,YAAY;QAAE,OAAO,YAAY,CAAC;IAEtC,+CAA+C;IAC/C,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACtC,MAAM,WAAW,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACnD,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC;IAE3D,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAC9C,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAc,CAAC;QAC5C,OAAO,YAAY,CAAC;IACtB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,oBAAoB;QACpB,YAAY,GAAG;YACb,kBAAkB,EAAE,EAAE;YACtB,cAAc,EAAE,EAAE;YAClB,SAAS,EAAE,QAAQ;YACnB,eAAe,EAAE,EAAE;YACnB,OAAO,EAAE,IAAI;YACb,UAAU,EAAE,EAAE;YACd,eAAe,EAAE,EAAE;SACpB,CAAC;QACF,OAAO,YAAY,CAAC;IACtB,CAAC;AACH,CAAC"}

package/dist/core/engine-detector.d.ts

@@ -0,0 +1,13 @@
+import { EngineType } from './session.js';
+export interface EngineDetectionResult {
+    engine: EngineType;
+    runtime: string;
+    confidence: 'verified' | 'inferred' | 'uncertain';
+    details: string;
+    primaryAssembly?: string;
+    metadataPath?: string;
+}
+/**
+ * Detect the game engine from a directory path.
+ */
+export declare function detectEngine(gamePath: string): EngineDetectionResult;

package/dist/core/engine-detector.js

@@ -0,0 +1,247 @@
+import { existsSync, readdirSync } from 'fs';
+import { join, basename, sep } from 'path';
+/**
+ * Recursively search for files matching patterns (shallow, max 3 levels deep).
+ */
+function findFiles(dir, patterns, maxDepth = 3, currentDepth = 0) {
+    if (currentDepth >= maxDepth)
+        return [];
+    const results = [];
+    try {
+        const entries = readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = join(dir, entry.name);
+            const nameLower = entry.name.toLowerCase();
+            if (entry.isFile()) {
+                for (const pattern of patterns) {
+                    if (nameLower === pattern.toLowerCase() || matchGlob(nameLower, pattern.toLowerCase())) {
+                        results.push(fullPath);
+                    }
+                }
+            }
+            else if (entry.isDirectory() && !nameLower.startsWith('.')) {
+                results.push(...findFiles(fullPath, patterns, maxDepth, currentDepth + 1));
+            }
+        }
+    }
+    catch {
+        // Permission denied or similar
+    }
+    return results;
+}
+function matchGlob(name, pattern) {
+    if (pattern.startsWith('*.')) {
+        return name.endsWith(pattern.slice(1));
+    }
+    return name === pattern;
+}
+function fileExists(dir, name) {
+    return existsSync(join(dir, name));
+}
+/**
+ * Find a file anywhere in the directory tree (limited depth).
+ */
+function findFileAnywhere(dir, name, maxDepth = 4) {
+    const results = findFiles(dir, [name], maxDepth);
+    return results.length > 0 ? results[0] : null;
+}
+/**
+ * Detect the game engine from a directory path.
+ */
+export function detectEngine(gamePath) {
+    if (!existsSync(gamePath)) {
+        return { engine: null, runtime: 'unknown', confidence: 'uncertain', details: `Path does not exist: ${gamePath}` };
+    }
+    // --- Unity Detection ---
+    // Unity is identified by its definitive data markers, NOT by UnityPlayer.dll alone:
+    // some Unity builds (older Mono titles, certain packagings) ship without UnityPlayer.dll
+    // while still carrying GameAssembly.dll / Assembly-CSharp.dll / a *_Data directory.
+    const unityPlayer = findFileAnywhere(gamePath, 'UnityPlayer.dll', 2);
+    const gameAssembly = findFileAnywhere(gamePath, 'GameAssembly.dll', 2);
+    const globalMetadata = findFileAnywhere(gamePath, 'global-metadata.dat', 4);
+    const assemblyCSharp = findFileAnywhere(gamePath, 'Assembly-CSharp.dll', 4);
+    // A "*_Data" directory sitting beside the executable is the Unity player layout.
+    let unityDataDir = null;
+    try {
+        for (const entry of readdirSync(gamePath, { withFileTypes: true })) {
+            if (entry.isDirectory() && entry.name.endsWith('_Data')) {
+                unityDataDir = join(gamePath, entry.name);
+                break;
+            }
+        }
+    }
+    catch {
+        // Permission denied or similar
+    }
+    const isUnity = Boolean(unityPlayer || gameAssembly || assemblyCSharp || unityDataDir);
+    if (isUnity) {
+        // IL2CPP: the native assembly plus its metadata blob.
+        if (gameAssembly && globalMetadata) {
+            return {
+                engine: 'unity-il2cpp',
+                runtime: 'IL2CPP',
+                confidence: 'verified',
+                details: `Unity IL2CPP game. GameAssembly.dll found at ${gameAssembly}`,
+                primaryAssembly: gameAssembly,
+                metadataPath: globalMetadata,
+            };
+        }
+        // Mono: managed Assembly-CSharp.dll.
+        if (assemblyCSharp) {
+            return {
+                engine: 'unity-mono',
+                runtime: 'Mono',
+                confidence: 'verified',
+                details: `Unity Mono game. Assembly-CSharp.dll found at ${assemblyCSharp}`,
+                primaryAssembly: assemblyCSharp,
+            };
+        }
+        // IL2CPP assembly present but metadata not located: still IL2CPP, lower confidence.
+        if (gameAssembly) {
+            return {
+                engine: 'unity-il2cpp',
+                runtime: 'IL2CPP',
+                confidence: 'inferred',
+                details: `Unity IL2CPP game. GameAssembly.dll found at ${gameAssembly}, but global-metadata.dat was not located.`,
+                primaryAssembly: gameAssembly,
+            };
+        }
+        // Unity layout confirmed, runtime undetermined.
+        return {
+            engine: 'unity-mono',
+            runtime: 'unknown',
+            confidence: 'inferred',
+            details: unityPlayer
+                ? 'UnityPlayer.dll found but could not locate Assembly-CSharp.dll or GameAssembly.dll'
+                : `Unity data directory found at ${unityDataDir}, but could not locate Assembly-CSharp.dll or GameAssembly.dll`,
+        };
+    }
+    // --- Unreal Detection ---
+    // Real Unreal titles name their shipping binary "<GameName>-Win64-Shipping.exe"
+    // (e.g. Subnautica2-Win64-Shipping.exe), NOT a literal "UE4-/UE5-" prefix, and it lives at
+    // <Game>/Binaries/Win64/ -- depth 3 from the install root. Match the pattern, search deep enough.
+    const shippingBinaries = findFiles(gamePath, ['*-win64-shipping.exe', '*-win32-shipping.exe', '*-winGDK-shipping.exe'], 4);
+    if (shippingBinaries.length > 0) {
+        return {
+            engine: 'unreal',
+            runtime: 'Native',
+            confidence: 'verified',
+            details: `Unreal Engine game detected via shipping binary ${basename(shippingBinaries[0])}`,
+            primaryAssembly: shippingBinaries[0],
+        };
+    }
+    // Content/Paks is the canonical Unreal cooked-content layout.
+    const unrealPaksDir = findFiles(gamePath, ['*.pak'], 4).find((f) => f.toLowerCase().split(sep).join('/').includes('content/paks'));
+    if (unrealPaksDir) {
+        return {
+            engine: 'unreal',
+            runtime: 'Native',
+            confidence: 'verified',
+            details: `Unreal Engine game detected via Content/Paks layout (${basename(unrealPaksDir)})`,
+            primaryAssembly: unrealPaksDir,
+        };
+    }
+    // Check for Engine/Binaries directory
+    if (existsSync(join(gamePath, 'Engine', 'Binaries'))) {
+        return {
+            engine: 'unreal',
+            runtime: 'Native',
+            confidence: 'verified',
+            details: 'Unreal Engine game detected via Engine/Binaries directory',
+        };
+    }
+    // Check for .pak files (common in Unreal)
+    const pakFiles = findFiles(gamePath, ['*.pak'], 3);
+    if (pakFiles.length > 0 && !findFileAnywhere(gamePath, 'UnityPlayer.dll', 2)) {
+        // Look for additional Unreal markers
+        const hasUnrealExe = findFiles(gamePath, ['*.exe'], 2).some(f => {
+            const name = basename(f).toLowerCase();
+            return name.includes('shipping') || name.includes('ue4') || name.includes('ue5');
+        });
+        if (hasUnrealExe || existsSync(join(gamePath, 'Engine'))) {
+            return {
+                engine: 'unreal',
+                runtime: 'Native',
+                confidence: 'inferred',
+                details: `Likely Unreal Engine game. Found ${pakFiles.length} .pak files`,
+            };
+        }
+    }
+    // --- Godot Detection ---
+    const pckFiles = findFiles(gamePath, ['*.pck'], 2);
+    if (pckFiles.length > 0) {
+        return {
+            engine: 'godot',
+            runtime: 'GDScript',
+            confidence: 'verified',
+            details: `Godot game detected. Found ${pckFiles.length} .pck file(s): ${pckFiles[0]}`,
+            primaryAssembly: pckFiles[0],
+        };
+    }
+    // Godot with embedded PCK (no .pck file, but Godot DLLs present)
+    const godotDlls = findFiles(gamePath, ['*.dll'], 2).filter(f => {
+        const name = basename(f).toLowerCase();
+        return name.includes('godot') || name.startsWith('libgd');
+    });
+    if (godotDlls.length > 0) {
+        // Resources are embedded in the exe
+        const exeFiles = findFiles(gamePath, ['*.exe'], 1);
+        const mainExe = exeFiles.find(f => !basename(f).toLowerCase().includes('crash'));
+        return {
+            engine: 'godot',
+            runtime: 'GDScript (embedded PCK)',
+            confidence: 'verified',
+            details: `Godot game detected via DLLs: ${godotDlls.map(f => basename(f)).join(', ')}. Resources embedded in executable.`,
+            primaryAssembly: mainExe || exeFiles[0],
+        };
+    }
+    // --- Java Detection ---
+    const jarFiles = findFiles(gamePath, ['*.jar'], 2);
+    if (jarFiles.length > 0) {
+        return {
+            engine: 'java',
+            runtime: 'JVM',
+            confidence: 'inferred',
+            details: `Java game detected. Found ${jarFiles.length} .jar file(s)`,
+            primaryAssembly: jarFiles[0],
+        };
+    }
+    // --- Electron/NW.js Detection ---
+    if (fileExists(gamePath, 'electron.exe') || fileExists(gamePath, 'nw.exe')) {
+        const runtime = fileExists(gamePath, 'electron.exe') ? 'Electron' : 'NW.js';
+        return {
+            engine: 'electron',
+            runtime,
+            confidence: 'verified',
+            details: `${runtime}-based game detected`,
+        };
+    }
+    // --- Lua Detection ---
+    const luaDlls = findFiles(gamePath, ['lua51.dll', 'lua52.dll', 'lua53.dll', 'lua54.dll'], 2);
+    if (luaDlls.length > 0) {
+        return {
+            engine: 'lua',
+            runtime: 'Lua',
+            confidence: 'inferred',
+            details: `Lua-scripted game detected. Found: ${basename(luaDlls[0])}`,
+        };
+    }
+    // --- Native/Unknown ---
+    const exeFiles = findFiles(gamePath, ['*.exe'], 1);
+    if (exeFiles.length > 0) {
+        return {
+            engine: 'native',
+            runtime: 'Native',
+            confidence: 'uncertain',
+            details: `Unknown engine. Found ${exeFiles.length} executable(s). Use analyze_pe_full for deeper inspection.`,
+            primaryAssembly: exeFiles[0],
+        };
+    }
+    return {
+        engine: null,
+        runtime: 'unknown',
+        confidence: 'uncertain',
+        details: 'Could not detect any known game engine in this directory.',
+    };
+}
+//# sourceMappingURL=engine-detector.js.map

package/dist/core/engine-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-detector.js","sourceRoot":"","sources":["../../src/core/engine-detector.ts"],"names":[],"mappings":"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"}

package/dist/core/event-bus.js

@@ -0,0 +1,18 @@
+import { EventEmitter } from 'events';
+class UgmEventBus {
+    emitter = new EventEmitter();
+    constructor() {
+        this.emitter.setMaxListeners(50);
+    }
+    on(event, listener) {
+        this.emitter.on(event, listener);
+    }
+    off(event, listener) {
+        this.emitter.off(event, listener);
+    }
+    emit(event, data) {
+        this.emitter.emit(event, data);
+    }
+}
+export const eventBus = new UgmEventBus();
+//# sourceMappingURL=event-bus.js.map