Tool Reference

Verify that the plugin server is running and responsive. Returns server version, uptime, registered tool count, and memory usage.

Get the current state of the editor and plugin. Reports open scene/level, active selection, connected providers, bridge status, and recent errors.

Search the project's asset database by name, type, path, or label. Supports glob patterns and regex filtering. Returns matching asset paths with metadata.

Read a value from the plugin's key-value cache. Used for storing intermediate results, session data, and user preferences between tool invocations.

Write or update a value in the plugin cache, or clear a specific key. Optionally set a TTL (time-to-live) for auto-expiration.

List recent editor transactions (tool operations) with timestamps, descriptions, and undo capability flags. Useful for reviewing what changes have been made.

Undo a specific transaction by ID or undo the most recent transaction. Reverts all editor changes made by that tool invocation.

Get a high-level summary of the current project plan. Returns phase count, task count, completion percentage, asset count, and active phase name.

Manage project phases. Get the list of phases, add new ones, update status, remove, or reorder. Each phase has a name, description, and completion state.

Manage tasks within phases. List, add, update status, remove, or move tasks between phases. Tasks have descriptions, status (pending/in_progress/complete), and phase assignment.

Track project assets in the plan. List, add, update, or remove asset entries with path, type, and generation status.

Manage target platform list for the project plan (e.g., Windows, macOS, Android, iOS, WebGL).

Track required plugins and packages for the project. List, add, or remove plugin entries.

Persistent key-value memory store for the AI agent. Store context, preferences, and intermediate results that survive between sessions.

Get plugin dashboard statistics. Returns version, registered tool count, uptime, session request count, and cache entries.

Submit user feedback about the plugin. Stores feedback type (bug, feature, general), message text, and optional rating for quality tracking.

In-editor documentation lookup. Search for help on any topic including tools, providers, settings, and workflow guidance.

Read or write plugin settings stored in EditorPrefs. Access TTS, STT, avatar, and general configuration values.

Get or set AI provider configurations. View available providers, their status, configured models, and endpoint settings.

Validate and test API keys. Shows masked key values and validation status for all configured providers. Does not expose raw keys.

View cache statistics (entries, size, hit rate) or clear the cache. Manage the plugin's internal caching layer for API responses and generated assets.

Extended transaction history with advanced filtering. View past tool operations filtered by date range, tool name, status, or category.

Generate a new C# script (Unity) or Blueprint class (UE5) from a natural language description or template. Supports MonoBehaviour, ScriptableObject, interface, and plain C# class types. Roslyn analysis validates the generated code before saving.

Edit an existing script by adding, removing, or changing code sections. Uses Roslyn for syntax-safe modifications in Unity. Describe the change in natural language or provide specific code to insert.

Delete a script file from the project. Removes the asset and cleans up any meta files. Registers a transaction for undo support.

Trigger a domain reload and recompilation of all scripts. Returns compile status, error count, and warning details. Useful after generating or modifying multiple scripts.

Add a serialized field, property, or constant to an existing script. Supports all C# types, default values, attributes ([SerializeField], [Header], [Range]), and access modifiers.

Change the type, default value, access modifier, or attributes of an existing variable in a script.

Remove a variable declaration from a script. Optionally removes references to the variable in the same file.

Add a new method to an existing script. Specify parameters, return type, body, and attributes. Generates properly formatted C# with XML documentation comments.

Edit the body, parameters, return type, or attributes of an existing method. Describe the change in natural language for AI-assisted modification.

Remove a method from a script. Cleans up associated comments and blank lines.

Create a new GameObject in the active scene (Unity) or spawn an Actor in the current level (UE5). Set name, position, rotation, scale, and parent. Optionally create from a prefab/Blueprint.

Set the world or local transform of an existing object. Supports absolute positioning, relative offsets, and look-at targeting.

Remove an object from the scene by name or path. Supports recursive deletion of child hierarchies. Registers a transaction for undo.

Set a serialized property value on a component or object by reflection. Works with any serializable field type including custom classes and arrays.

Add a component to a GameObject (Unity) or ActorComponent to an Actor (UE5). Supports built-in and custom component types. Optionally set initial property values.

Remove a component from a GameObject or Actor by type name. If multiple components of the same type exist, specify an index.

Save a scene object as a reusable prefab asset (Unity) or Blueprint class (UE5). Captures the full component hierarchy and property values.

Open a prefab in edit mode, apply changes (add/remove components, update properties), and save. Changes propagate to all instances.

Create a new material asset. Automatically selects the appropriate shader for the active render pipeline (Built-in Standard, URP Lit, HDRP Lit). Set color, metallic, smoothness, emission, and texture properties.

Assign a material to a renderer component on a scene object. Supports material slot indices for multi-material meshes.

Assign a mesh asset to a MeshFilter/MeshRenderer (Unity) or StaticMeshComponent (UE5) on a scene object.

Save the currently open scene (Unity) or level (UE5) to disk.

Open a scene or level file in the editor. Prompts to save unsaved changes before switching.

Execute a Unity menu item or UE5 editor command by path. Useful for triggering built-in editor operations like Play, Build, or custom menu extensions.

Configure input actions and bindings. Unity: creates Input Action Assets or legacy Input Manager entries. UE5: sets up Enhanced Input actions and mappings.

Execute multiple tool calls in a single transaction. All operations succeed or fail together, with a single undo point. Useful for complex multi-step operations.

Inspect an Animator controller (Unity) or Animation Blueprint (UE5). Returns the full structure: layers, state machines, states, transitions, parameters, and blend trees.

Create or modify a state machine within an Animator controller. Add a new layer with a sub-state machine, or restructure an existing one.

Add, modify, or remove a state in an Animator state machine. Configure state speed, motion time, mirror, cycle offset, and IK settings.

Create or edit transitions between states. Configure conditions (parameter comparisons), duration, offset, interruption source, and ordered interruption settings.

Assign an animation clip to a state, or configure a blend tree with multiple clips and blend parameters. Supports 1D, 2D Simple Directional, 2D Freeform, and Direct blend tree types.

Validate an Animator controller for common issues: missing clips, unreachable states, transitions without conditions, parameter mismatches, and orphaned blend trees. Returns a detailed report.

Send a message to an LLM provider (Claude, Gemini, or OpenRouter) and receive a response. Supports system prompts, conversation history, temperature, and max tokens. The AI Router selects the configured default provider or you can specify one.

Generate structured content (code, JSON, documentation) from a prompt. Returns the generated content in a specified format with optional schema validation.

Generate an image from a text prompt using DALL-E or Stable Diffusion. Save the result as a project asset (PNG or JPEG). Supports size, style, and quality parameters.

Generate a seamless tileable texture from a description. Optimized for game asset use -- includes normal map, roughness, and metallic map generation when requested.

Start a 3D mesh generation task using Meshy or Hyper3D. Generation is asynchronous -- use mesh_status to poll progress and mesh_import to bring the result into your project.

Check the progress of an active mesh generation task. Returns percentage complete, estimated time remaining, and preview URL when available.

Download and import a completed 3D mesh into the project. Handles format conversion (GLB/FBX), material setup, and asset registration.

Generate audio content -- voice dialogue (ElevenLabs), music tracks (Suno), or sound effects. Returns a WAV or MP3 asset imported into the project.

Establish a connection to a running Blender instance with the BlueprintForge Blender addon installed. Returns connection status and Blender version.

Execute a Blender Python command on the connected instance. Supports bpy operations, object manipulation, modifier application, and scene setup.

Export a model from Blender and import it directly into the game engine project. Handles FBX/GLB export, file transfer, and asset registration in one step.

Export an asset from the game engine project to the connected Blender instance for editing. Opens the model in Blender ready for modification.

Get or set AI provider configuration. View current API keys (masked), default models, rate limits, and endpoint overrides. Set new keys or change default provider selection.

Manually route a request to a specific provider, bypassing the auto-router. Useful for testing or when you need a specific model's capabilities.

Check the health and availability of all configured AI providers. Returns connection status, rate limit remaining, and last response latency for each provider.

Estimate the API cost for a planned operation before executing it. Returns estimated token count and dollar cost by provider.

List all available models for a provider, with capabilities (vision, function calling, long context), pricing, and context window sizes.

View API usage history with token counts, costs, and timestamps. Filter by provider, date range, or operation type. Useful for budget tracking.

Search across the entire project for scripts, GameObjects, assets, or hierarchy structures by pattern. Supports searching by name, type, component, or tag with glob patterns.

Query and modify Unity Input Action Assets (.inputactions). List action maps and bindings, add new bindings, remove existing ones, or add new actions to an existing asset.

Read Unity console log messages with filtering. View recent logs, errors, warnings, or clear the console. Useful for debugging tool operations.

Manage scenes and levels with multi-scene support. List open scenes, load/unload scenes additively, manage build settings, and set the active scene.

Scan the current project and build a manifest of all exportable assets. Identifies Blueprints/scripts, materials, levels/scenes, animations, and input configurations eligible for conversion.

Check the current Engine Swap session status. Returns conversion phase, progress percentage, processed asset count, and any warnings or errors encountered.

Analyze a project for cross-engine compatibility. Reports which features have direct equivalents, which require manual intervention, and estimated conversion complexity.

Export the entire project to IR format in a single operation. Processes scenes, scripts, materials, animations, and input configurations. Creates a complete conversion package.

Export scene hierarchy, actors/GameObjects, and components to the Intermediate Representation format. Converts transforms, component properties, and references to engine-neutral IR structures.

Export materials and textures to the IR format. Maps engine-specific shader properties (Material Expressions, Shader Graph nodes) to neutral material parameters.

Export Blueprint logic (UE5) or C# scripts (Unity) to IR code representation. Converts engine-specific APIs, events, and class hierarchies to neutral IR format.

Export animation assets, state machines, and blend trees to IR. Converts AnimBP (UE5) or Animator Controllers (Unity) to neutral animation data.

Export input configurations. Converts Enhanced Input (UE5) or Input Action Assets (Unity) to IR input mappings.

Export physics settings, colliders, and constraints to IR format. Maps PhysX (UE5) or Unity physics components to neutral representations.

Import IR data from another engine's export. Creates native equivalents: Actors/GameObjects, components, materials, and references. Generates a detailed import report with any items needing manual attention.

Import IR code and generate native scripts. Converts IR to C# MonoBehaviours (Unity) or Blueprint classes (UE5) with engine-specific API calls.

Import IR materials and create native materials with correct shader mappings for the target render pipeline.

Create a new Engine Swap conversion session. Sets up shared folder polling, initializes conversion manifests, and prepares the IR workspace.

Resume a previously paused conversion session. Detects changes since last export and performs incremental re-export of modified assets.

Review and resolve conversion conflicts identified during import. Uses AI-guided ambiguity resolution with user decision prompts for items without direct equivalents.

Query the mapping databases to find equivalents between engines. Search component, type, event, node, material, input, and physics mappings.

Scan a game engine aircraft for exportable parts. Identifies fuselage, wings, control surfaces, landing gear, cockpit instruments, and engine components. Builds an aircraft manifest with part hierarchy and LOD levels.

Use AI-assisted part identification to classify unknown mesh components. Combines auto-scan geometry analysis with LLM-guided naming and user confirmation for ambiguous parts.

Estimate conversion complexity and output fidelity. Reports polygon counts, texture resolution, animation channel count, and recommends visual/basic/full fidelity level.

Validate aircraft structure against MSFS and DCS requirements. Checks for required components (cockpit, exterior, collision), texture formats, and naming conventions.

Export the aircraft to SimForge Aircraft IR (intermediate representation). Generates a universal JSON format containing geometry references, materials, animations, and flight dynamics data.

Check the status of an active SimForge conversion session. Returns current pipeline stage, progress, and any errors or warnings.

Import the aircraft IR into a connected Blender instance. Creates the part hierarchy, assigns materials, and sets up the scene for sim-specific export processing.

Optimize meshes in Blender for flight sim targets. Applies decimation, LOD generation, UV unwrapping for lightmaps, and texture atlas creation.

Set up flight sim animation channels in Blender. Configures control surface deflections, gear retraction, propeller rotation, and cockpit switch animations with correct pivot points.

Export from Blender to MSFS-compatible glTF format using the glTF-Blender-IO-MSFS addon. Generates the glTF model with MSFS-specific extensions and metadata.

Export from Blender to DCS World EDM format using the Blender_ioEDM addon. Generates the EDM model with DCS-specific material properties and animation connectors.

Convert aircraft materials for sim targets. Maps PBR game materials to MSFS glTF PBR materials or DCS EDM material definitions with correct texture channel assignments.

Validate the Blender scene against sim-specific requirements before export. Checks naming conventions, hierarchy, material assignments, and animation channels.

Generate a complete MSFS Community Package structure. Creates the folder hierarchy, manifest.json, layout.json, and all required configuration files.

Generate aircraft.cfg, flight_model.cfg, engines.cfg, and systems.cfg for MSFS. Populates configuration values from Aircraft IR flight dynamics data.

Generate cockpit instrument gauges as MSFS HTML/JS instruments. Creates gauge templates for airspeed, altimeter, attitude, heading, VSI, engine instruments, and custom gauges.

Generate the cockpit panel.cfg mapping gauge positions and sizes to the 3D cockpit model texture coordinates.

Generate MSFS sound.cfg with engine, wind, gear, and cockpit sound configurations. Maps sound events to audio file references.

Generate or tune MSFS flight model parameters. Creates flight_model.cfg sections for aerodynamics, weight/balance, gear physics, and ground handling from Aircraft IR data.

Generate livery texture templates and configuration for MSFS. Creates texture.cfg and fallback paint kit references.

Validate a complete MSFS package for submission readiness. Checks package structure, manifest integrity, model references, and configuration completeness.

Generate DCS World module structure. Creates the Lua-based module framework with entry.lua, device scripts, and cockpit definitions.

Generate DCS device Lua scripts for cockpit systems. Creates clickable cockpit devices with command bindings, argument animations, and input handler functions.

Generate DCS flight dynamics model from Aircraft IR data. Creates the FM Lua tables for aerodynamics, engine performance, fuel system, and autopilot parameters.

Generate weapons station definitions, pylon configurations, and ordnance compatibility tables for DCS combat aircraft.

Generate DCS sound environment definitions. Creates snd_env Lua tables for engine, cockpit, and external sound configurations.

Validate DCS module structure, Lua syntax, EDM model references, and device script completeness. Reports issues preventing module loading.

Create a new SimForge conversion session. Initializes the pipeline workspace, configures target simulators, and sets fidelity level.

Resume a paused conversion session from its last checkpoint. Detects changes and reruns only affected pipeline stages.

Export the completed conversion results as distributable packages. Creates zip archives for MSFS Community folder and DCS Mods folder installation.

Generate a detailed conversion report. Lists all processed assets, conversion decisions, warnings, manual intervention items, and output file manifest.

Search the airfoil database by name, family, or performance characteristics. Returns matching NACA and custom airfoil profiles with lift, drag, and moment data.

Get detailed data for a specific airfoil. Returns coordinate points, polar curves (Cl/Cd/Cm vs alpha), thickness distribution, and camber line data.

Compare two or more airfoils side by side. Generates overlay plots of geometry and polar curves highlighting performance differences at specified Reynolds numbers.

Create a custom airfoil profile from NACA parameters, coordinate data, or by interpolating between existing airfoils. Saves to the local database.

Run XFOIL viscous analysis on an airfoil at specified Reynolds number and angle of attack range. Returns lift, drag, and moment coefficient curves.

Optimize airfoil shape for target performance goals. Uses XFOIL in the loop with AeroSandbox optimization to maximize L/D, minimize drag, or target specific Cl at design Reynolds number.

Analyze boundary layer transition location on an airfoil. Reports laminar-to-turbulent transition points, separation bubbles, and boundary layer properties.

Generate complete polar data across a range of Reynolds numbers. Creates a polar database suitable for flight dynamics model integration.

Analyze the effect of surface roughness (bug contamination, rain, ice) on airfoil performance. Simulates forced transition at specified chord locations.

Create a 3D wing geometry from parameters. Specify span, root/tip chord, sweep, dihedral, twist, and airfoil sections. Generates a wing surface mesh for analysis.

Run lifting-line or VLM analysis on a wing. Returns span-wise lift distribution, induced drag, total lift and drag coefficients, and stall characteristics.

Optimize wing planform for minimum induced drag, maximum range, or target lift coefficient. Varies taper ratio, twist distribution, and sweep angle.

Calculate structural loads on a wing. Returns shear force, bending moment, and torsion distributions for specified flight conditions (g-loads, gust encounters).

Calculate optimal vortex generator placement on a wing. Determines chordwise position, spacing, height, and angle based on boundary layer analysis.

Define a complete aircraft configuration from wing, fuselage, tail, and engine parameters. Creates an aircraft model for performance and stability analysis.

Calculate aircraft performance envelope. Returns rate of climb, ceiling, range, endurance, stall speed, maximum speed, and takeoff/landing distances at various weights and altitudes.

Analyze static and dynamic stability. Returns CG limits, neutral point, static margin, and dynamic mode characteristics (short period, phugoid, dutch roll, spiral).

Calculate trim conditions for straight-and-level flight, climb, descent, and coordinated turns. Returns required control surface deflections and thrust setting.

Generate the complete flight envelope (V-n diagram). Calculates maneuvering speed, design dive speed, gust load factors, and structural limit boundaries.

Set up a CFD simulation using AeroSandbox panel methods or VLM. Configure mesh resolution, boundary conditions, turbulence model, and flow parameters.

Execute a CFD simulation. Returns pressure distribution, force coefficients, and flow visualization data. Runs asynchronously for large meshes.

Retrieve and post-process CFD results. Extract Cp distributions, streamlines, velocity fields, and integrated force/moment values.

Run a parametric CFD sweep across angle of attack, sideslip, or Mach number range. Generates polar-style output tables for each sweep variable.

Create a JSBSim flight dynamics model from aircraft data. Generates the XML aircraft definition with aerodynamics, propulsion, mass, and ground reactions.

Run a JSBSim flight simulation with specified initial conditions and control inputs. Returns time-series data for all state variables.

Find trim conditions in JSBSim for specified flight states. Returns converged control positions and state variables for steady flight.

Export JSBSim FDM data to SimForge Aircraft IR format for use in MSFS or DCS conversion pipelines. Bridges AeroStudio analysis with SimForge output generation.

Run multi-objective design optimization using AeroSandbox. Optimize wing, airfoil, or full aircraft for multiple competing objectives (range vs speed, weight vs strength).

Check the status of an active optimization run. Returns iteration count, current objective values, convergence metrics, and Pareto front progress.

Retrieve optimization results. Returns the Pareto front, best designs, design variable values, and sensitivity analysis data.

Generate 3D-printable vortex generator models using CadQuery. Creates STL files sized for the Creality K1 CF print bed with optimized print orientation.

Generate 3D-printable winglet models from wing analysis data. Creates parametric winglet geometry with cant angle, sweep, and airfoil section control.

Generate 3D-printable control surface models (ailerons, flaps, elevators) with hinge line, horn balance, and gap seal geometry.

Generate scaled wind tunnel test models from wing or aircraft geometry. Calculates scale factor, adds mounting sting geometry, and splits large models across multiple prints.

Generate print-ready G-code for the Creality K1 CF. Applies printer-specific profiles (layer height, infill, supports), estimates print time and material usage.

Import a mesh from the game engine (via EngineSwap) for aerodynamic analysis. Converts game meshes to analysis-ready surfaces with proper normals and watertight geometry.

Export flight dynamics data to SimForge for flight simulator conversion. Bridges AeroStudio analysis results to the SimForge Aircraft IR format.

Export optimized wing or aircraft geometry back to the game engine as mesh assets. Converts analysis surfaces to game-ready FBX/GLB with LOD support.

Generate a comprehensive engineering report from analysis results. Includes charts, data tables, methodology notes, and recommendations in HTML or PDF format.

Create a new AeroStudio analysis session. Starts the Python backend server on port 4002 if not already running and initializes the workspace.

Check AeroStudio session and Python backend status. Reports server health, loaded datasets, active analyses, and available compute resources.

Clean up temporary analysis files and optionally stop the Python backend server. Preserves saved results and reports.