ue-mcp 0.4.0-alpha

package/dist/instructions.js

@@ -0,0 +1,150 @@
+export const SERVER_INSTRUCTIONS = `UE-MCP: Unreal Engine editor bridge (C++ plugin) — 19 category tools covering 300+ actions.
+
+Every tool takes an "action" parameter that selects the operation. Call project(action="get_status") first.
+
+═══ QUICK START ═══
+1. project(action="get_status") — check if the editor is connected
+2. If not connected: editor(action="start_editor") to launch UE
+3. level(action="get_outliner") — see what's in the current level
+4. asset(action="list") — browse project assets
+5. reflection(action="reflect_class", className="StaticMeshActor") — understand any UE class
+6. demo(action="step", stepIndex=1) through 19 — run the Neon Shrine demo to see the bridge in action
+7. demo(action="cleanup") — clean up after the demo
+
+═══ TOOLS & ACTIONS ═══
+
+project — Project status, config INI, C++ source
+  get_status, set_project, get_info, read_config, search_config, list_config_tags,
+  set_config, read_cpp_header, read_module, list_modules, search_cpp
+
+asset — Assets: list, search, CRUD, import, datatables, textures
+  list, search, read, read_properties, duplicate, rename, move, delete, save,
+  import_static_mesh, import_skeletal_mesh, import_animation, import_texture,
+  read_datatable, create_datatable, reimport_datatable, list_textures,
+  get_texture_info, set_texture_settings
+
+blueprint — Blueprint reading, authoring, compilation
+  read, list_variables, list_functions, read_graph, create, add_variable,
+  set_variable_properties, create_function, delete_function, rename_function,
+  add_node, delete_node, set_node_property, connect_pins, add_component,
+  compile, list_node_types, search_node_types, create_interface, add_interface,
+  add_event_dispatcher
+
+level — Level actors, selection, components, volumes, lights, splines
+  get_outliner, place_actor, delete_actor, get_actor_details, move_actor,
+  select, get_selected, add_component, set_component_property,
+  get_current, load, save, list, create,
+  spawn_volume, list_volumes, set_volume_properties,
+  spawn_light, set_light_properties, build_lighting,
+  get_spline_info, set_spline_points
+
+material — Materials, shading, and graph authoring
+  read, list_parameters, set_parameter, create_instance, create,
+  set_shading_model, set_base_color, connect_texture,
+  add_expression, connect_expressions, connect_to_property,
+  list_expressions, delete_expression, list_expression_types, recompile
+
+animation — Anim assets, skeletons, montages, blendspaces
+  read_anim_blueprint, read_montage, read_sequence, read_blendspace, list,
+  create_montage, create_anim_blueprint, create_blendspace, add_notify,
+  get_skeleton_info, list_sockets, list_skeletal_meshes, get_physics_asset
+
+landscape — Terrain sculpting, painting, layers
+  get_info, list_layers, sample, list_splines, get_component,
+  sculpt, paint_layer, set_material, add_layer_info, import_heightmap
+
+pcg — Procedural Content Generation graphs
+  list_graphs, read_graph, read_node_settings, get_components,
+  get_component_details, create_graph, add_node, connect_nodes,
+  set_node_settings, remove_node, execute, add_volume
+
+foliage — Foliage painting and types
+  list_types, get_settings, sample, paint, erase, create_type, set_settings
+
+niagara — VFX systems and graph authoring
+  list, get_info, spawn, set_parameter, create,
+  create_emitter, add_emitter, list_emitters, set_emitter_property,
+  list_modules, get_emitter_info
+
+audio — Sound assets and playback
+  list, play_at_location, spawn_ambient, create_cue, create_metasound
+
+widget — UMG widgets and editor utilities
+  read_tree, get_details, set_property, list, read_animations, create,
+  create_utility_widget, run_utility_widget,
+  create_utility_blueprint, run_utility_blueprint
+
+editor — Console, Python, PIE, viewport, sequencer, perf, build pipeline, logs
+  execute_command, execute_python, set_property, play_in_editor,
+  get_runtime_value, hot_reload, undo, redo,
+  get_perf_stats, run_stat, set_scalability, capture_screenshot,
+  get_viewport, set_viewport, focus_on_actor,
+  create_sequence, get_sequence_info, add_sequence_track, play_sequence,
+  build_all, build_geometry, build_hlod, validate_assets,
+  get_build_status, cook_content,
+  get_log, search_log, get_message_log,
+  set_dialog_policy, clear_dialog_policy, get_dialog_policy,
+  list_dialogs, respond_to_dialog
+
+reflection — UE class/struct/enum reflection, gameplay tags
+  reflect_class, reflect_struct, reflect_enum, list_classes,
+  list_tags, create_tag
+
+gameplay — Physics, collision, navigation, input, behavior trees, AI, game framework
+  set_collision_profile, set_simulate_physics, set_collision_enabled,
+  set_physics_properties, rebuild_navigation, get_navmesh_info,
+  project_to_nav, spawn_nav_modifier,
+  create_input_action, create_input_mapping, list_input_assets,
+  list_behavior_trees, get_behavior_tree_info,
+  create_blackboard, create_behavior_tree,
+  create_eqs_query, list_eqs_queries,
+  add_perception, configure_sense,
+  create_state_tree, list_state_trees, add_state_tree_component,
+  create_smart_object_def, add_smart_object_component,
+  create_game_mode, create_game_state, create_player_controller,
+  create_player_state, create_hud, set_world_game_mode, get_framework_info
+
+gas — Gameplay Ability System
+  add_asc, create_attribute_set, add_attribute,
+  create_ability, set_ability_tags,
+  create_effect, set_effect_modifier,
+  create_cue, get_info
+
+networking — Replication and networking
+  set_replicates, set_property_replicated, configure_net_frequency,
+  set_dormancy, set_net_load_on_client, set_always_relevant,
+  set_only_relevant_to_owner, configure_cull_distance,
+  set_priority, set_replicate_movement, get_info
+
+demo — Neon Shrine demo scene
+  step, cleanup
+
+feedback — Agent feedback submission
+  submit
+
+═══ TIPS ═══
+• Start with level(action="get_outliner") or asset(action="list") to discover what's in the project.
+• Use reflection(action="reflect_class") to understand any UE class's properties.
+• asset(action="search", query="/Game/Characters/*") accepts wildcards.
+• For BP scripting: blueprint(action="search_node_types") → blueprint(action="add_node") → blueprint(action="connect_pins").
+• editor(action="execute_python") is the escape hatch for any Unreal Python API call.
+• Animation tools need a skeleton path — use animation(action="list_skeletal_meshes") to find it.
+• Editor lifecycle: editor(action="stop_editor") / editor(action="start_editor") / editor(action="restart_editor") manage the UE process.
+• editor(action="hot_reload") triggers Live Coding compilation without restarting the editor.
+• editor(action="focus_on_actor", actorLabel="MyActor") snaps the viewport to any actor.
+• Log output: editor(action="get_log", category="LogMCPBridge") to see bridge-specific logs.
+
+═══ FEEDBACK ═══
+If you had to use editor(action="execute_python") as a workaround because a native tool
+couldn't handle the task, keep a mental note of what you did and why. When your task is
+complete, tell the user:
+  "I had to use custom Python scripts to [describe what]. Would you like to submit
+   feedback to help improve ue-mcp?"
+If the user agrees, call feedback(action="submit") with:
+  • title — short, generic description of the gap (no project-specific details)
+  • summary — what was attempted and why the native tool fell short
+  • pythonWorkaround — the Python code that was used
+  • idealTool — what tool/action should handle this natively
+This creates a GitHub issue so the maintainers can add proper support.
+`;
+//# sourceMappingURL=instructions.js.map

package/dist/instructions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../src/instructions.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoJlC,CAAC"}

package/dist/project.d.ts

@@ -0,0 +1,32 @@
+export interface PluginInfo {
+    name: string;
+    contentDir: string;
+    mountPoint: string;
+}
+export interface UeMcpConfig {
+    /** Content roots to search by default (e.g. ["/Game/", "/GASP/", "/MyPlugin/"]) */
+    contentRoots?: string[];
+    /** Tool categories to disable (e.g. ["gas", "networking", "pcg"]) */
+    disable?: string[];
+}
+export declare class ProjectContext {
+    projectPath: string | null;
+    projectName: string | null;
+    contentDir: string | null;
+    engineAssociation: string | null;
+    config: UeMcpConfig;
+    get isLoaded(): boolean;
+    setProject(inputPath: string): void;
+    ensureLoaded(): void;
+    resolveContentPath(assetPath: string): string;
+    resolveContentDir(dirPath: string): string;
+    getRelativeContentPath(absolutePath: string): string;
+    get projectDir(): string | null;
+    get configDir(): string | null;
+    get pluginsDir(): string | null;
+    discoverPlugins(): PluginInfo[];
+    resolvePluginPath(mountPath: string): string | null;
+    getRelativePluginPath(absolutePath: string): string | null;
+    private parseUProject;
+    private loadConfig;
+}

package/dist/project.js

@@ -0,0 +1,175 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+export class ProjectContext {
+    projectPath = null;
+    projectName = null;
+    contentDir = null;
+    engineAssociation = null;
+    config = {};
+    get isLoaded() {
+        return this.projectPath !== null;
+    }
+    setProject(inputPath) {
+        if (inputPath.endsWith(".uproject")) {
+            this.projectPath = path.resolve(inputPath);
+        }
+        else {
+            const files = fs
+                .readdirSync(inputPath)
+                .filter((f) => f.endsWith(".uproject"));
+            if (files.length === 0) {
+                throw new Error(`No .uproject file found in ${inputPath}`);
+            }
+            this.projectPath = path.resolve(inputPath, files[0]);
+        }
+        this.projectName = path.basename(this.projectPath, ".uproject");
+        this.contentDir = path.join(path.dirname(this.projectPath), "Content");
+        this.parseUProject();
+        this.loadConfig();
+    }
+    ensureLoaded() {
+        if (!this.isLoaded) {
+            throw new Error('No project loaded. Pass the .uproject path as an argument in your MCP config, e.g. "args": ["C:/path/to/MyGame.uproject"]');
+        }
+    }
+    resolveContentPath(assetPath) {
+        this.ensureLoaded();
+        if (isGamePath(assetPath)) {
+            let stripped = stripGamePrefix(assetPath);
+            if (!stripped.endsWith(".uasset") && !stripped.endsWith(".umap")) {
+                stripped += ".uasset";
+            }
+            return path.join(this.contentDir, ...stripped.split("/"));
+        }
+        if (path.isAbsolute(assetPath))
+            return assetPath;
+        let normalized = assetPath.replace(/\\/g, "/");
+        if (!normalized.endsWith(".uasset") && !normalized.endsWith(".umap")) {
+            normalized += ".uasset";
+        }
+        return path.join(this.contentDir, ...normalized.split("/"));
+    }
+    resolveContentDir(dirPath) {
+        this.ensureLoaded();
+        if (isGamePath(dirPath)) {
+            const stripped = stripGamePrefix(dirPath).replace(/\/+$/, "");
+            return path.join(this.contentDir, ...stripped.split("/"));
+        }
+        const pluginResolved = this.resolvePluginPath(dirPath);
+        if (pluginResolved)
+            return pluginResolved;
+        if (path.isAbsolute(dirPath))
+            return dirPath;
+        return path.join(this.contentDir, ...dirPath.replace(/\\/g, "/").replace(/\/+$/, "").split("/"));
+    }
+    getRelativeContentPath(absolutePath) {
+        if (!this.contentDir)
+            return absolutePath;
+        const normalized = absolutePath.replace(/\\/g, "/");
+        const contentNorm = this.contentDir.replace(/\\/g, "/");
+        if (normalized.startsWith(contentNorm)) {
+            const relative = normalized.slice(contentNorm.length + 1).replace(".uasset", "");
+            return "/Game/" + relative;
+        }
+        const pluginPath = this.getRelativePluginPath(absolutePath);
+        if (pluginPath)
+            return pluginPath;
+        return absolutePath;
+    }
+    get projectDir() {
+        return this.projectPath ? path.dirname(this.projectPath) : null;
+    }
+    get configDir() {
+        return this.projectDir ? path.join(this.projectDir, "Config") : null;
+    }
+    get pluginsDir() {
+        return this.projectDir ? path.join(this.projectDir, "Plugins") : null;
+    }
+    discoverPlugins() {
+        if (!this.pluginsDir || !fs.existsSync(this.pluginsDir))
+            return [];
+        const plugins = [];
+        function scan(dir) {
+            for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+                if (!entry.isDirectory())
+                    continue;
+                const full = path.join(dir, entry.name);
+                const contentDir = path.join(full, "Content");
+                const hasUplugin = fs.readdirSync(full).some((f) => f.endsWith(".uplugin"));
+                if (hasUplugin && fs.existsSync(contentDir)) {
+                    plugins.push({
+                        name: entry.name,
+                        contentDir,
+                        mountPoint: `/${entry.name}/`,
+                    });
+                }
+                else if (!hasUplugin) {
+                    scan(full);
+                }
+            }
+        }
+        scan(this.pluginsDir);
+        return plugins;
+    }
+    resolvePluginPath(mountPath) {
+        const plugins = this.discoverPlugins();
+        const normalized = mountPath.replace(/\\/g, "/");
+        for (const plugin of plugins) {
+            if (normalized.startsWith(plugin.mountPoint)) {
+                const rest = normalized.slice(plugin.mountPoint.length);
+                return path.join(plugin.contentDir, ...rest.split("/").filter(Boolean));
+            }
+            if (normalized === `/${plugin.name}` || normalized === `/${plugin.name}/`) {
+                return plugin.contentDir;
+            }
+        }
+        return null;
+    }
+    getRelativePluginPath(absolutePath) {
+        const normalized = absolutePath.replace(/\\/g, "/");
+        for (const plugin of this.discoverPlugins()) {
+            const contentNorm = plugin.contentDir.replace(/\\/g, "/");
+            if (normalized.startsWith(contentNorm)) {
+                const relative = normalized.slice(contentNorm.length + 1).replace(".uasset", "");
+                return plugin.mountPoint + relative;
+            }
+        }
+        return null;
+    }
+    parseUProject() {
+        if (!this.projectPath)
+            return;
+        try {
+            const json = JSON.parse(fs.readFileSync(this.projectPath, "utf-8"));
+            this.engineAssociation = json.EngineAssociation ?? null;
+        }
+        catch {
+            this.engineAssociation = null;
+        }
+    }
+    loadConfig() {
+        if (!this.projectDir)
+            return;
+        const configPath = path.join(this.projectDir, ".ue-mcp.json");
+        if (!fs.existsSync(configPath))
+            return;
+        try {
+            this.config = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+            console.error(`[ue-mcp] Loaded config from ${configPath}`);
+        }
+        catch (e) {
+            console.error(`[ue-mcp] Failed to parse .ue-mcp.json: ${e instanceof Error ? e.message : e}`);
+        }
+    }
+}
+function isGamePath(p) {
+    return (p.startsWith("/Game/") || p.toLowerCase() === "/game");
+}
+function stripGamePrefix(p) {
+    if (p.startsWith("/Game/"))
+        return p.slice(6);
+    if (p.toLowerCase() === "/game")
+        return "";
+    return p;
+}
+//# sourceMappingURL=project.js.map

package/dist/project.js.map

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

package/dist/tools/animation.d.ts

@@ -0,0 +1,2 @@
+import { type ToolDef } from "../types.js";
+export declare const animationTool: ToolDef;

package/dist/tools/animation.js

@@ -0,0 +1,62 @@
+import { z } from "zod";
+import { categoryTool, bp } from "../types.js";
+export const animationTool = categoryTool("animation", "Animation assets, skeletons, montages, blendspaces, anim blueprints, physics assets.", {
+    read_anim_blueprint: bp("read_anim_blueprint"),
+    read_montage: bp("read_anim_montage", (p) => ({ assetPath: p.assetPath })),
+    read_sequence: bp("read_anim_sequence", (p) => ({ assetPath: p.assetPath })),
+    read_blendspace: bp("read_blendspace", (p) => ({ assetPath: p.assetPath })),
+    list: bp("list_anim_assets"),
+    create_montage: bp("create_anim_montage"),
+    create_anim_blueprint: bp("create_anim_blueprint"),
+    create_blendspace: bp("create_blendspace"),
+    add_notify: bp("add_anim_notify"),
+    get_skeleton_info: bp("get_skeleton_info"),
+    list_sockets: bp("list_sockets"),
+    list_skeletal_meshes: bp("list_skeletal_meshes"),
+    get_physics_asset: bp("get_physics_asset_info"),
+    create_sequence: bp("create_sequence"),
+    set_bone_keyframes: bp("set_bone_keyframes"),
+    get_bone_transforms: bp("get_bone_transforms"),
+    set_montage_sequence: bp("set_montage_sequence"),
+}, `- read_anim_blueprint: Read AnimBP structure. Params: assetPath
+- read_montage: Read montage. Params: assetPath
+- read_sequence: Read anim sequence. Params: assetPath
+- read_blendspace: Read blendspace. Params: assetPath
+- list: List anim assets. Params: directory?, recursive?
+- create_montage: Create montage. Params: animSequencePath, name?, packagePath?
+- create_anim_blueprint: Create AnimBP. Params: skeletonPath, name?, packagePath?
+- create_blendspace: Create blendspace. Params: skeletonPath, name?, packagePath?, axisHorizontal?, axisVertical?
+- add_notify: Add notify. Params: assetPath, notifyName, triggerTime, notifyClass?
+- get_skeleton_info: Read skeleton. Params: assetPath
+- list_sockets: List sockets. Params: assetPath
+- list_skeletal_meshes: List skeletal meshes. Params: directory?, recursive?
+- get_physics_asset: Read physics asset. Params: assetPath
+- create_sequence: Create blank AnimSequence. Params: name, skeletonPath, packagePath?, numFrames?, frameRate?
+- set_bone_keyframes: Set bone transform keyframes. Params: assetPath, boneName, keyframes (array of {frame, location?, rotation?, scale?})
+- get_bone_transforms: Read reference pose transforms. Params: skeletonPath, boneNames? (array filter)
+- set_montage_sequence: Replace animation sequence in a montage. Params: assetPath, animSequencePath, slotIndex?`, {
+    assetPath: z.string().optional(),
+    directory: z.string().optional(),
+    recursive: z.boolean().optional(),
+    animSequencePath: z.string().optional(),
+    skeletonPath: z.string().optional(),
+    name: z.string().optional(),
+    packagePath: z.string().optional(),
+    axisHorizontal: z.string().optional(),
+    axisVertical: z.string().optional(),
+    notifyName: z.string().optional(),
+    triggerTime: z.number().optional(),
+    notifyClass: z.string().optional(),
+    slotIndex: z.number().optional(),
+    numFrames: z.number().optional(),
+    frameRate: z.number().optional(),
+    boneName: z.string().optional(),
+    boneNames: z.array(z.string()).optional(),
+    keyframes: z.array(z.object({
+        frame: z.number(),
+        location: z.object({ x: z.number(), y: z.number(), z: z.number() }).optional(),
+        rotation: z.object({ x: z.number(), y: z.number(), z: z.number(), w: z.number() }).optional(),
+        scale: z.object({ x: z.number(), y: z.number(), z: z.number() }).optional(),
+    })).optional(),
+});
+//# sourceMappingURL=animation.js.map

package/dist/tools/animation.js.map

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

package/dist/tools/asset.d.ts

@@ -0,0 +1,2 @@
+import { type ToolDef } from "../types.js";
+export declare const assetTool: ToolDef;

package/dist/tools/asset.js

@@ -0,0 +1,128 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { z } from "zod";
+import { categoryTool, bp } from "../types.js";
+export const assetTool = categoryTool("asset", "Asset management: list, search, read, CRUD, import meshes/textures, datatables.", {
+    list: {
+        handler: async (ctx, p) => {
+            ctx.project.ensureLoaded();
+            const dir = p.directory ? ctx.project.resolveContentDir(p.directory) : ctx.project.contentDir;
+            const recursive = p.recursive !== false;
+            const typeFilter = p.typeFilter?.toLowerCase();
+            if (!fs.existsSync(dir))
+                throw new Error(`Directory not found: ${dir}`);
+            const assets = [];
+            function scan(d) {
+                for (const entry of fs.readdirSync(d, { withFileTypes: true })) {
+                    const full = path.join(d, entry.name);
+                    if (entry.isDirectory()) {
+                        if (recursive)
+                            scan(full);
+                    }
+                    else {
+                        const ext = path.extname(entry.name).slice(1).toLowerCase();
+                        if (ext !== "uasset" && ext !== "umap")
+                            continue;
+                        if (typeFilter && ext !== typeFilter)
+                            continue;
+                        assets.push({ path: ctx.project.getRelativeContentPath(full), name: path.basename(entry.name, path.extname(entry.name)), extension: ext, sizeKB: Math.round(fs.statSync(full).size / 1024) });
+                    }
+                }
+            }
+            scan(dir);
+            const result = { directory: p.directory ?? "/Game/", recursive, assetCount: assets.length, assets: assets.slice(0, 2000) };
+            if (assets.length === 0) {
+                const plugins = ctx.project.discoverPlugins();
+                if (plugins.length > 0) {
+                    result.suggestion = `No assets found in ${p.directory ?? "/Game/"}. This project has plugin content — try listing one of these: ${plugins.map((pl) => pl.mountPoint).join(", ")}`;
+                    result.availablePlugins = plugins.map((pl) => ({ name: pl.name, mountPoint: pl.mountPoint }));
+                }
+            }
+            return result;
+        },
+    },
+    search: {
+        handler: async (ctx, p) => {
+            const { action: _, ...rest } = p;
+            const roots = ctx.project.config.contentRoots;
+            // If no directory specified and contentRoots configured, search each root and merge
+            if (!p.directory && roots && roots.length > 0) {
+                const maxResults = p.maxResults ?? 50;
+                const allResults = [];
+                for (const root of roots) {
+                    const res = await ctx.bridge.call("search_assets", { ...rest, directory: root });
+                    if (res.results && Array.isArray(res.results)) {
+                        allResults.push(...res.results);
+                    }
+                    if (allResults.length >= maxResults)
+                        break;
+                }
+                return {
+                    query: p.query ?? "",
+                    searchScope: roots,
+                    resultCount: Math.min(allResults.length, maxResults),
+                    results: allResults.slice(0, maxResults),
+                    success: true,
+                };
+            }
+            return ctx.bridge.call("search_assets", rest);
+        },
+    },
+    read: bp("read_asset", (p) => ({ path: p.assetPath })),
+    read_properties: bp("read_asset_properties"),
+    duplicate: bp("duplicate_asset"),
+    rename: bp("rename_asset"),
+    move: bp("move_asset"),
+    delete: bp("delete_asset"),
+    save: bp("save_asset"),
+    set_mesh_material: bp("set_mesh_material"),
+    recenter_pivot: bp("recenter_pivot"),
+    import_static_mesh: bp("import_static_mesh"),
+    import_skeletal_mesh: bp("import_skeletal_mesh"),
+    import_animation: bp("import_animation"),
+    import_texture: bp("import_texture"),
+    read_datatable: bp("read_datatable", (p) => ({ path: p.assetPath, rowFilter: p.rowFilter })),
+    create_datatable: bp("create_datatable"),
+    reimport_datatable: bp("reimport_datatable", (p) => ({ path: p.assetPath, jsonPath: p.jsonPath, jsonString: p.jsonString })),
+    list_textures: bp("list_textures"),
+    get_texture_info: bp("get_texture_info"),
+    set_texture_settings: bp("set_texture_settings"),
+}, `- list: List assets in directory. Params: directory?, typeFilter?, recursive?
+- search: Search by name/class/path. Params: query, directory?, maxResults?, searchAll? (set searchAll=true to search all content roots including plugin paths like /GASP/, not just /Game/)
+- read: Read asset via reflection. Params: assetPath
+- read_properties: Read specific properties. Params: assetPath, exportName?, propertyName?
+- duplicate: Duplicate asset. Params: sourcePath, destinationPath
+- rename: Rename asset. Params: assetPath, newName
+- move: Move asset. Params: sourcePath, destinationPath
+- delete: Delete asset. Params: assetPath
+- save: Save asset(s). Params: assetPath?
+- set_mesh_material: Assign material to static mesh slot. Params: assetPath, materialPath, slotIndex?
+- recenter_pivot: Move static mesh pivot to geometry center. Params: assetPath
+- import_static_mesh: Import from FBX/OBJ. Params: filePath, name?, packagePath?
+- import_skeletal_mesh: Import from FBX. Params: filePath, name?, packagePath?, skeletonPath?
+- import_animation: Import anim from FBX. Params: filePath, name?, packagePath?, skeletonPath?
+- import_texture: Import image. Params: filePath, name?, packagePath?
+- read_datatable: Read DataTable rows. Params: assetPath, rowFilter?
+- create_datatable: Create DataTable. Params: name, packagePath?, rowStruct
+- reimport_datatable: Reimport from JSON. Params: assetPath, jsonPath?, jsonString?
+- list_textures: List textures. Params: directory?, recursive?
+- get_texture_info: Get texture details. Params: assetPath
+- set_texture_settings: Set texture settings. Params: assetPath, settings`, {
+    assetPath: z.string().optional().describe("Asset path"),
+    directory: z.string().optional(), query: z.string().optional(),
+    maxResults: z.number().optional(), typeFilter: z.string().optional(),
+    searchAll: z.boolean().optional().describe("Search all content roots (plugins, engine content) not just /Game/"),
+    recursive: z.boolean().optional(),
+    sourcePath: z.string().optional(), destinationPath: z.string().optional(),
+    newName: z.string().optional(),
+    materialPath: z.string().optional().describe("Material asset path for set_mesh_material"),
+    slotIndex: z.number().optional().describe("Material slot index (default 0)"),
+    filePath: z.string().optional().describe("Absolute file path for imports"),
+    name: z.string().optional(), packagePath: z.string().optional(),
+    skeletonPath: z.string().optional(),
+    rowFilter: z.string().optional(), rowStruct: z.string().optional(),
+    jsonPath: z.string().optional(), jsonString: z.string().optional(),
+    exportName: z.string().optional(), propertyName: z.string().optional(),
+    settings: z.record(z.unknown()).optional(),
+});
+//# sourceMappingURL=asset.js.map

package/dist/tools/asset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset.js","sourceRoot":"","sources":["../../src/tools/asset.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,EAAE,EAAgB,MAAM,aAAa,CAAC;AAE7D,MAAM,CAAC,MAAM,SAAS,GAAY,YAAY,CAC5C,OAAO,EACP,iFAAiF,EACjF;IACE,IAAI,EAAE;QACJ,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE;YACxB,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;YAC3B,MAAM,GAAG,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAmB,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,UAAW,CAAC;YACzG,MAAM,SAAS,GAAG,CAAC,CAAC,SAAS,KAAK,KAAK,CAAC;YACxC,MAAM,UAAU,GAAI,CAAC,CAAC,UAAiC,EAAE,WAAW,EAAE,CAAC;YACvE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,GAAG,EAAE,CAAC,CAAC;YACxE,MAAM,MAAM,GAA6E,EAAE,CAAC;YAC5F,SAAS,IAAI,CAAC,CAAS;gBACrB,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,WAAW,CAAC,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;oBAC/D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;oBACtC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;wBAAC,IAAI,SAAS;4BAAE,IAAI,CAAC,IAAI,CAAC,CAAC;oBAAC,CAAC;yBAClD,CAAC;wBACJ,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;wBAC5D,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,MAAM;4BAAE,SAAS;wBACjD,IAAI,UAAU,IAAI,GAAG,KAAK,UAAU;4BAAE,SAAS;wBAC/C,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,sBAAsB,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;oBAChM,CAAC;gBACH,CAAC;YACH,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,CAAC;YACV,MAAM,MAAM,GAA4B,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC;YACpJ,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACxB,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;gBAC9C,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACvB,MAAM,CAAC,UAAU,GAAG,sBAAsB,CAAC,CAAC,SAAS,IAAI,QAAQ,iEAAiE,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;oBAClL,MAAM,CAAC,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;gBAChG,CAAC;YACH,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;KACF;IACD,MAAM,EAAE;QACN,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE;YACxB,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,CAAC,CAAC;YACjC,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC;YAC9C,oFAAoF;YACpF,IAAI,CAAC,CAAC,CAAC,SAAS,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9C,MAAM,UAAU,GAAI,CAAC,CAAC,UAAqB,IAAI,EAAE,CAAC;gBAClD,MAAM,UAAU,GAAmC,EAAE,CAAC;gBACtD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAA4B,CAAC;oBAC5G,IAAI,GAAG,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;wBAC9C,UAAU,CAAC,IAAI,CAAC,GAAI,GAAG,CAAC,OAA0C,CAAC,CAAC;oBACtE,CAAC;oBACD,IAAI,UAAU,CAAC,MAAM,IAAI,UAAU;wBAAE,MAAM;gBAC7C,CAAC;gBACD,OAAO;oBACL,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,EAAE;oBACpB,WAAW,EAAE,KAAK;oBAClB,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC;oBACpD,OAAO,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC;oBACxC,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YACD,OAAO,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;QAChD,CAAC;KACF;IACD,IAAI,EAAY,EAAE,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;IAChE,eAAe,EAAE,EAAE,CAAC,uBAAuB,CAAC;IAC5C,SAAS,EAAO,EAAE,CAAC,iBAAiB,CAAC;IACrC,MAAM,EAAU,EAAE,CAAC,cAAc,CAAC;IAClC,IAAI,EAAY,EAAE,CAAC,YAAY,CAAC;IAChC,MAAM,EAAU,EAAE,CAAC,cAAc,CAAC;IAClC,IAAI,EAAY,EAAE,CAAC,YAAY,CAAC;IAChC,iBAAiB,EAAK,EAAE,CAAC,mBAAmB,CAAC;IAC7C,cAAc,EAAQ,EAAE,CAAC,gBAAgB,CAAC;IAC1C,kBAAkB,EAAI,EAAE,CAAC,oBAAoB,CAAC;IAC9C,oBAAoB,EAAE,EAAE,CAAC,sBAAsB,CAAC;IAChD,gBAAgB,EAAM,EAAE,CAAC,kBAAkB,CAAC;IAC5C,cAAc,EAAQ,EAAE,CAAC,gBAAgB,CAAC;IAC1C,cAAc,EAAQ,EAAE,CAAC,gBAAgB,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;IAClG,gBAAgB,EAAM,EAAE,CAAC,kBAAkB,CAAC;IAC5C,kBAAkB,EAAI,EAAE,CAAC,oBAAoB,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;IAC9H,aAAa,EAAS,EAAE,CAAC,eAAe,CAAC;IACzC,gBAAgB,EAAM,EAAE,CAAC,kBAAkB,CAAC;IAC5C,oBAAoB,EAAE,EAAE,CAAC,sBAAsB,CAAC;CACjD,EACD;;;;;;;;;;;;;;;;;;;;0EAoBwE,EACxE;IACE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;IACvD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9D,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpE,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oEAAoE,CAAC;IAChH,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACjC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACzE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;IACzF,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IAC5E,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;IAC1E,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/D,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACtE,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC3C,CACF,CAAC"}

package/dist/tools/audio.d.ts

@@ -0,0 +1,2 @@
+import { type ToolDef } from "../types.js";
+export declare const audioTool: ToolDef;

package/dist/tools/audio.js

@@ -0,0 +1,24 @@
+import { z } from "zod";
+import { categoryTool, bp } from "../types.js";
+export const audioTool = categoryTool("audio", "Audio: sound assets, playback, ambient sounds, SoundCues, MetaSounds.", {
+    list: bp("list_sound_assets"),
+    play_at_location: bp("play_sound_at_location"),
+    spawn_ambient: bp("spawn_ambient_sound"),
+    create_cue: bp("create_sound_cue"),
+    create_metasound: bp("create_metasound_source"),
+}, `- list: List sound assets. Params: directory?, recursive?
+- play_at_location: Play sound. Params: soundPath, location {x,y,z}, volumeMultiplier?, pitchMultiplier?
+- spawn_ambient: Place ambient sound. Params: soundPath, location {x,y,z}, label?
+- create_cue: Create SoundCue. Params: name, packagePath?, soundWavePath?
+- create_metasound: Create MetaSoundSource. Params: name, packagePath?`, {
+    directory: z.string().optional(), recursive: z.boolean().optional(),
+    soundPath: z.string().optional(),
+    location: z.object({ x: z.number(), y: z.number(), z: z.number() }).optional(),
+    volumeMultiplier: z.number().optional(),
+    pitchMultiplier: z.number().optional(),
+    label: z.string().optional(),
+    name: z.string().optional(),
+    packagePath: z.string().optional(),
+    soundWavePath: z.string().optional(),
+});
+//# sourceMappingURL=audio.js.map

package/dist/tools/audio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.js","sourceRoot":"","sources":["../../src/tools/audio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,EAAE,EAAgB,MAAM,aAAa,CAAC;AAE7D,MAAM,CAAC,MAAM,SAAS,GAAY,YAAY,CAC5C,OAAO,EACP,uEAAuE,EACvE;IACE,IAAI,EAAe,EAAE,CAAC,mBAAmB,CAAC;IAC1C,gBAAgB,EAAG,EAAE,CAAC,wBAAwB,CAAC;IAC/C,aAAa,EAAM,EAAE,CAAC,qBAAqB,CAAC;IAC5C,UAAU,EAAS,EAAE,CAAC,kBAAkB,CAAC;IACzC,gBAAgB,EAAG,EAAE,CAAC,yBAAyB,CAAC;CACjD,EACD;;;;uEAIqE,EACrE;IACE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACnE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC9E,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACvC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACtC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACrC,CACF,CAAC"}

package/dist/tools/blueprint.d.ts

@@ -0,0 +1,2 @@
+import { type ToolDef } from "../types.js";
+export declare const blueprintTool: ToolDef;