unity-mcp-server 1.0.0 → 1.2.0

package/README.md

@@ -16,13 +16,41 @@ Unity MCP Server runs as a separate process and reads your Unity project from di
 
 ---
 
-## Features
+## Tools (by category)
 
-| Tool | Description |
-|------|-------------|
-| `get_project_info` | Returns project root path, Unity version, and build scene count. |
-| `list_build_scenes` | Returns scenes in `EditorBuildSettings` in build order (JSON). |
-| `read_agent_docs` | Returns contents of `.agents/AGENT.md`; optionally includes `REPO_UNDERSTANDING.md`. |
+**Project & build** — `get_project_info`, `list_build_scenes`, `get_player_settings`, `list_packages`, `get_quality_settings`, `get_scripting_defines`, `get_physics_settings`, `get_project_version`, `get_changelog`
+
+**Code & assemblies** — `list_assemblies`, `list_scripts`, `find_scripts_by_content`, `get_assembly_dependency_graph`, `list_editor_scripts`
+
+**Scenes & prefabs** — `list_all_scenes`, `get_scene_summary`, `list_prefabs`, `get_prefab_script_guids`
+
+**Assets & references** — `get_asset_folder_tree`, `list_assets_by_extension`, `find_references`, `list_large_assets`
+
+**Materials & shaders** — `list_materials`, `list_shaders`, `list_shader_graphs`, `list_vfx_graphs`
+
+**Animation** — `list_animator_controllers`, `list_animation_clips`, `get_animator_states`, `list_timeline_playables`
+
+**2D & sprites** — `list_sprite_atlases`, `list_tilemap_assets`
+
+**Rendering** — `list_render_pipelines` (URP/HDRP, volume profiles)
+
+**TextMeshPro & UI** — `list_tmp_fonts`, `get_tmp_settings_path`, `list_ui_documents` (UXML, USS)
+
+**Input** — `get_input_axes`, `list_input_action_assets`, `get_input_actions_summary`
+
+**Tags & layers** — `get_tags_and_layers`
+
+**Addressables & localization** — `get_addressables_info`, `get_localization_tables`
+
+**Audio** — `list_audio_clips`, `list_audio_mixers`
+
+**Testing & docs** — `list_test_assemblies`, `get_repo_docs`, `read_agent_docs`
+
+**CI & version control** — `list_ci_configs`, `list_presets`, `get_git_lfs_tracked`, `get_plastic_config`
+
+**Integrations (config discovery)** — `get_playfab_config`, `list_figma_related_assets`, `get_firebase_config`, `get_steam_config`, `get_discord_config`, `get_fmod_config`, `get_wwise_config`, `list_substance_assets`, `list_speedtree_assets`, `list_lottie_assets`, `get_analytics_or_crash_config`, `get_ads_config`
+
+All tools read from the project filesystem only; no Unity Editor is required.
 
 ---
 

package/dist/index.d.ts

@@ -1,8 +1,6 @@
 #!/usr/bin/env node
 /**
  * unity-mcp-server – Lightweight MCP server for any Unity project.
- * Exposes tools: project info, build scenes, agent docs. No Unity Editor required.
- * Set UNITY_PROJECT_PATH to the Unity project root in your MCP client config.
- * Run: node dist/index.js (after npm run build).
+ * Exposes tools for project info, build scenes, agent docs, packages, code, assets, and more. No Unity Editor required.
  */
 export {};

package/dist/index.js

@@ -1,37 +1,18 @@
 #!/usr/bin/env node
 /**
  * unity-mcp-server – Lightweight MCP server for any Unity project.
- * Exposes tools: project info, build scenes, agent docs. No Unity Editor required.
- * Set UNITY_PROJECT_PATH to the Unity project root in your MCP client config.
- * Run: node dist/index.js (after npm run build).
+ * Exposes tools for project info, build scenes, agent docs, packages, code, assets, and more. No Unity Editor required.
  */
-import { readFileSync, existsSync } from "node:fs";
-import { join, resolve } from "node:path";
+import { resolve } from "node:path";
 import { z } from "zod";
+import * as R from "./readers.js";
 function getProjectRoot() {
     const env = process.env.UNITY_PROJECT_PATH;
     if (env)
         return resolve(env);
     console.error("UNITY_PROJECT_PATH is required. Set it in your MCP client config (e.g. Cursor) to your Unity project root.");
     process.exit(1);
-    return ""; // unreachable
-}
-function getBuildScenes(projectRoot) {
-    const path = join(projectRoot, "ProjectSettings", "EditorBuildSettings.asset");
-    if (!existsSync(path))
-        return [];
-    const content = readFileSync(path, "utf-8");
-    const scenes = [];
-    let index = 0;
-    const pathRe = /path: (Assets\/[^\n]+\.unity)/g;
-    let m;
-    while ((m = pathRe.exec(content)) !== null) {
-        const fullPath = m[1];
-        const name = fullPath.replace(/^.*\//, "").replace(/\.unity$/, "");
-        scenes.push({ index, path: fullPath, name });
-        index++;
-    }
-    return scenes;
+    return "";
 }
 async function main() {
     const projectRoot = getProjectRoot();
@@ -39,59 +20,214 @@ async function main() {
     const { StdioServerTransport } = await import("@modelcontextprotocol/sdk/server/stdio.js");
     const server = new McpServer({
         name: "unity-mcp-server",
-        version: "1.0.0",
+        version: "1.2.0",
     });
+    const text = (s) => ({ content: [{ type: "text", text: s }] });
+    const json = (o) => text(JSON.stringify(o, null, 2));
+    // --- Existing + expanded project info ---
     server.registerTool("get_project_info", {
-        description: "Get Unity project info (path, Unity version, build scene count).",
+        description: "Get Unity project info: path, Unity version, build scene count, player/product name.",
         inputSchema: {},
     }, async () => {
-        let unityVersion = "unknown";
-        const pvPath = join(projectRoot, "ProjectSettings", "ProjectVersion.txt");
-        if (existsSync(pvPath)) {
-            const m = readFileSync(pvPath, "utf-8").match(/m_EditorVersion:\s*(.+)/);
-            if (m)
-                unityVersion = m[1].trim();
-        }
-        const scenes = getBuildScenes(projectRoot);
-        const text = [
+        const unityVersion = R.getUnityVersion(projectRoot);
+        const scenes = R.getBuildScenes(projectRoot);
+        const player = R.getPlayerSettings(projectRoot);
+        const lines = [
             `Project root: ${projectRoot}`,
             `Unity version: ${unityVersion}`,
             `Build scenes: ${scenes.length}`,
-            scenes.map((s) => `  ${s.index}: ${s.name} (${s.path})`).join("\n"),
-        ].join("\n");
-        return { content: [{ type: "text", text }] };
-    });
-    server.registerTool("list_build_scenes", {
-        description: "List all scenes in Unity EditorBuildSettings (build order).",
-        inputSchema: {},
-    }, async () => {
-        const scenes = getBuildScenes(projectRoot);
-        const text = JSON.stringify(scenes, null, 2);
-        return { content: [{ type: "text", text }] };
+            ...scenes.map((s) => `  ${s.index}: ${s.name} (${s.path})`),
+            "",
+            "Player / product (if available):",
+            ...Object.entries(player).map(([k, v]) => `  ${k}: ${v}`),
+        ];
+        return text(lines.join("\n"));
     });
+    server.registerTool("list_build_scenes", { description: "List scenes in EditorBuildSettings (build order) as JSON.", inputSchema: {} }, async () => json(R.getBuildScenes(projectRoot)));
     server.registerTool("read_agent_docs", {
-        description: "Read the agent development guide (.agents/AGENT.md) and optionally REPO_UNDERSTANDING.md.",
+        description: "Read .agents/AGENT.md and optionally REPO_UNDERSTANDING.md.",
         inputSchema: {
-            include_repo_understanding: z.boolean().optional().describe("If true, also return REPO_UNDERSTANDING.md content").default(false),
+            include_repo_understanding: z.boolean().optional().describe("If true, also return REPO_UNDERSTANDING.md").default(false),
         },
     }, async (args) => {
         const include = args?.include_repo_understanding ?? false;
-        const agentPath = join(projectRoot, ".agents", "AGENT.md");
-        let text = "";
-        if (existsSync(agentPath)) {
-            text = readFileSync(agentPath, "utf-8");
+        let content = R.readFileSafe(projectRoot, ".agents", "AGENT.md") ?? "(No .agents/AGENT.md found)";
+        if (include) {
+            const rep = R.readFileSafe(projectRoot, "REPO_UNDERSTANDING.md");
+            if (rep)
+                content += "\n\n---\n\n# REPO_UNDERSTANDING.md\n\n" + rep;
         }
-        else {
-            text = "(No .agents/AGENT.md found)";
+        return text(content);
+    });
+    // --- 1. Project & package info ---
+    server.registerTool("get_player_settings", { description: "Get Player/ProjectSettings (product name, company, bundle ID, version, etc.).", inputSchema: {} }, async () => json(R.getPlayerSettings(projectRoot)));
+    server.registerTool("list_packages", { description: "List Unity packages from Packages/manifest.json (and optional packages-lock.json).", inputSchema: {} }, async () => json(R.getPackages(projectRoot)));
+    server.registerTool("get_quality_settings", { description: "Get QualitySettings (quality levels) from ProjectSettings.", inputSchema: {} }, async () => json(R.getQualitySettings(projectRoot)));
+    server.registerTool("get_scripting_defines", { description: "Get global and per-assembly scripting define symbols.", inputSchema: {} }, async () => json(R.getScriptingDefines(projectRoot)));
+    // --- 2. Code & assemblies ---
+    server.registerTool("list_assemblies", {
+        description: "List assembly definitions (.asmdef) with path, name, references, platforms.",
+        inputSchema: {},
+    }, async () => json(R.getAssemblyDefinitions(projectRoot)));
+    server.registerTool("list_scripts", {
+        description: "List all C# scripts under Assets. Optionally filter by folder prefix (e.g. Scripts).",
+        inputSchema: {
+            folder: z.string().optional().describe("Optional folder under Assets, e.g. Scripts/Runtime"),
+        },
+    }, async (args) => json(R.listScripts(projectRoot, args?.folder)));
+    server.registerTool("find_scripts_by_content", {
+        description: "Find C# scripts that contain a type or pattern (e.g. MonoBehaviour, ScriptableObject, or custom). Optionally filter by namespace.",
+        inputSchema: {
+            pattern: z.string().describe("Pattern to search for, e.g. MonoBehaviour or a type name"),
+            namespace_filter: z.string().optional().describe("Optional namespace pattern, e.g. Game.*"),
+        },
+    }, async (args) => {
+        const a = args;
+        return json(R.findScriptsByContent(projectRoot, a.pattern, a.namespace_filter));
+    });
+    // --- 3. Scenes ---
+    server.registerTool("list_all_scenes", { description: "List all .unity scene files under Assets (not only build-indexed).", inputSchema: {} }, async () => json(R.getAllScenes(projectRoot)));
+    server.registerTool("get_scene_summary", {
+        description: "Get a short summary of a scene: root GameObject names and approximate component count.",
+        inputSchema: { scene_path: z.string().describe("Path relative to project, e.g. Assets/Scenes/Main.unity") },
+    }, async (args) => json(R.getSceneSummary(projectRoot, args.scene_path)));
+    // --- 4. Prefabs ---
+    server.registerTool("list_prefabs", {
+        description: "List all .prefab files. Optionally filter by path prefix under Assets.",
+        inputSchema: { path_prefix: z.string().optional().describe("e.g. Prefabs/Characters") },
+    }, async (args) => json(R.getPrefabs(projectRoot, args?.path_prefix)));
+    // --- 5. Assets & references ---
+    server.registerTool("find_references", {
+        description: "Find all assets (scenes, prefabs, materials, etc.) that reference the given asset. Pass asset path (e.g. Assets/Texture.png) or GUID.",
+        inputSchema: {
+            asset_path_or_guid: z.string().describe("Asset path relative to project (e.g. Assets/My.asset) or 32-char GUID"),
+        },
+    }, async (args) => {
+        const input = args.asset_path_or_guid.trim();
+        let guid;
+        if (/^[a-f0-9]{32}$/i.test(input)) {
+            guid = input;
         }
-        if (include) {
-            const repPath = join(projectRoot, "REPO_UNDERSTANDING.md");
-            if (existsSync(repPath)) {
-                text += "\n\n---\n\n# REPO_UNDERSTANDING.md\n\n" + readFileSync(repPath, "utf-8");
-            }
+        else {
+            guid = R.getGuidFromMeta(projectRoot, input) ?? "";
+            if (!guid)
+                return text(`No .meta found for ${input}; cannot resolve GUID.`);
         }
-        return { content: [{ type: "text", text }] };
+        const refs = R.findReferencesToGuid(projectRoot, guid);
+        return json({ guid, references: refs });
+    });
+    server.registerTool("get_asset_folder_tree", {
+        description: "Get a tree of Assets folder (directories and file names). Useful for understanding project layout.",
+        inputSchema: { max_depth: z.number().optional().describe("Max folder depth, default 4").default(4) },
+    }, async (args) => json(R.getAssetFolderTree(projectRoot, args?.max_depth ?? 4)));
+    server.registerTool("list_assets_by_extension", {
+        description: "List assets by file extension (e.g. .png, .fbx, .mp3). Optionally under a folder.",
+        inputSchema: {
+            extension: z.string().describe("e.g. .png, .fbx, .mp3"),
+            folder: z.string().optional().describe("Optional folder under Assets"),
+        },
+    }, async (args) => {
+        const a = args;
+        const ext = a.extension.startsWith(".") ? a.extension : `.${a.extension}`;
+        return json(R.listAssetsByExtension(projectRoot, ext, a.folder));
+    });
+    // --- 6. Materials & shaders ---
+    server.registerTool("list_materials", {
+        description: "List .mat materials; optionally under a folder. Includes shader GUID when readable.",
+        inputSchema: { folder: z.string().optional() },
+    }, async (args) => json(R.getMaterials(projectRoot, args?.folder)));
+    server.registerTool("list_shaders", { description: "List all .shader files in Assets and Packages.", inputSchema: {} }, async () => json(R.getShaders(projectRoot)));
+    // --- 7. Animation ---
+    server.registerTool("list_animator_controllers", { description: "List all Animator Controller (.controller) assets.", inputSchema: {} }, async () => json(R.getAnimatorControllers(projectRoot)));
+    server.registerTool("list_animation_clips", { description: "List all Animation Clip (.anim) assets.", inputSchema: {} }, async () => json(R.getAnimationClips(projectRoot)));
+    server.registerTool("get_animator_states", {
+        description: "Get state names from an Animator Controller (.controller) file.",
+        inputSchema: { controller_path: z.string().describe("e.g. Assets/Animations/Player.controller") },
+    }, async (args) => json(R.getAnimatorStates(projectRoot, args.controller_path)));
+    // --- 8. Audio ---
+    server.registerTool("list_audio_clips", { description: "List audio clip files (.wav, .mp3, .ogg, .aiff) under Assets.", inputSchema: {} }, async () => json(R.getAudioClips(projectRoot)));
+    server.registerTool("list_audio_mixers", { description: "List Audio Mixer (.mixer) assets.", inputSchema: {} }, async () => json(R.getAudioMixers(projectRoot)));
+    // --- 9. Addressables ---
+    server.registerTool("get_addressables_info", { description: "Get Addressables groups and config path if the project uses Addressables.", inputSchema: {} }, async () => json(R.getAddressablesInfo(projectRoot)));
+    // --- 10. Localization ---
+    server.registerTool("get_localization_tables", { description: "List localization table files under Assets/Localization if present.", inputSchema: {} }, async () => json(R.getLocalizationTables(projectRoot)));
+    // --- 11. Input ---
+    server.registerTool("get_input_axes", { description: "Get input axes from InputManager (name, descriptive name, positive button).", inputSchema: {} }, async () => json(R.getInputAxes(projectRoot)));
+    // --- 12. Tags & layers ---
+    server.registerTool("get_tags_and_layers", { description: "Get Tags and Layers from TagManager.", inputSchema: {} }, async () => json(R.getTagsAndLayers(projectRoot)));
+    // --- 13. Testing ---
+    server.registerTool("list_test_assemblies", { description: "List assembly definitions that look like test assemblies (path contains test/editor).", inputSchema: {} }, async () => json(R.getTestAssemblies(projectRoot)));
+    // --- 14. Docs & conventions ---
+    server.registerTool("get_repo_docs", {
+        description: "Read README, CONTRIBUTING, .cursorrules, CODING_STANDARDS, STYLE if present at project root.",
+        inputSchema: {},
+    }, async () => json(R.getRepoDocs(projectRoot)));
+    // --- 15. CI / versioning ---
+    server.registerTool("get_project_version", { description: "Get project/bundle version from PlayerSettings.", inputSchema: {} }, async () => text(R.getProjectVersion(projectRoot)));
+    server.registerTool("get_changelog", { description: "Read CHANGELOG.md or CHANGELOG if present.", inputSchema: {} }, async () => {
+        const content = R.getChangelog(projectRoot);
+        return text(content ?? "(No CHANGELOG found)");
     });
+    // --- 16. Physics ---
+    server.registerTool("get_physics_settings", { description: "Get Physics/DynamicsManager or Physics2D settings (key-value).", inputSchema: {} }, async () => json(R.getPhysicsSettings(projectRoot)));
+    // --- 17. Render pipelines ---
+    server.registerTool("list_render_pipelines", { description: "List render pipeline assets and volume profiles (URP/HDRP).", inputSchema: {} }, async () => json(R.listRenderPipelines(projectRoot)));
+    // --- 18. Timeline ---
+    server.registerTool("list_timeline_playables", { description: "List Timeline .playable assets.", inputSchema: {} }, async () => json(R.listTimelinePlayables(projectRoot)));
+    // --- 19. Sprites / 2D ---
+    server.registerTool("list_sprite_atlases", { description: "List Sprite Atlas (.spriteatlas) assets.", inputSchema: {} }, async () => json(R.listSpriteAtlases(projectRoot)));
+    server.registerTool("list_tilemap_assets", { description: "List tilemap-related .asset files.", inputSchema: {} }, async () => json(R.listTilemapAssets(projectRoot)));
+    // --- 20. Shader Graph / VFX ---
+    server.registerTool("list_shader_graphs", { description: "List Shader Graph (.shadergraph) assets.", inputSchema: {} }, async () => json(R.listShaderGraphs(projectRoot)));
+    server.registerTool("list_vfx_graphs", { description: "List VFX Graph (.vfx) assets.", inputSchema: {} }, async () => json(R.listVfxGraphs(projectRoot)));
+    // --- 21. TextMeshPro ---
+    server.registerTool("list_tmp_fonts", { description: "List TMP/font-related assets.", inputSchema: {} }, async () => json(R.listTmpFonts(projectRoot)));
+    server.registerTool("get_tmp_settings_path", { description: "Get path to TMP Settings asset if present.", inputSchema: {} }, async () => json(R.getTmpSettingsPath(projectRoot)));
+    // --- 22. UI Toolkit ---
+    server.registerTool("list_ui_documents", { description: "List UI Toolkit .uxml and .uss files.", inputSchema: {} }, async () => json(R.listUiDocuments(projectRoot)));
+    // --- 23. New Input System ---
+    server.registerTool("list_input_action_assets", { description: "List New Input System .inputactions assets.", inputSchema: {} }, async () => json(R.listInputActionAssets(projectRoot)));
+    server.registerTool("get_input_actions_summary", { description: "Get action maps and actions from an .inputactions file.", inputSchema: { path: z.string().describe("e.g. Assets/Input/Player.inputactions") } }, async (args) => json(R.getInputActionsSummary(projectRoot, args.path)));
+    // --- 24. Presets ---
+    server.registerTool("list_presets", { description: "List .preset assets.", inputSchema: {} }, async () => json(R.listPresets(projectRoot)));
+    // --- 25. Editor scripts ---
+    server.registerTool("list_editor_scripts", { description: "List C# scripts in Editor folders or with Editor in path.", inputSchema: {} }, async () => json(R.listEditorScripts(projectRoot)));
+    // --- 26. Prefab script refs ---
+    server.registerTool("get_prefab_script_guids", { description: "Get script GUIDs (MonoBehaviour) referenced by a prefab.", inputSchema: { prefab_path: z.string().describe("e.g. Assets/Prefabs/Player.prefab") } }, async (args) => json(R.getPrefabScriptGuids(projectRoot, args.prefab_path)));
+    // --- 27. Assembly dependency graph ---
+    server.registerTool("get_assembly_dependency_graph", { description: "Get assembly definition dependency graph (nodes and edges).", inputSchema: {} }, async () => json(R.getAssemblyDependencyGraph(projectRoot)));
+    // --- 28. CI configs ---
+    server.registerTool("list_ci_configs", { description: "List CI config files (.github/workflows, Jenkinsfile, unity-cloud-build).", inputSchema: {} }, async () => json(R.listCiConfigs(projectRoot)));
+    // --- 29. Large assets ---
+    server.registerTool("list_large_assets", { description: "List assets over a size threshold (default 5 MB).", inputSchema: { min_size_mb: z.number().optional().default(5) } }, async (args) => json(R.listLargeAssets(projectRoot, args?.min_size_mb ?? 5)));
+    // --- 30. PlayFab ---
+    server.registerTool("get_playfab_config", { description: "Get PlayFab config (title ID, config paths) from project. No secrets.", inputSchema: {} }, async () => json(R.getPlayFabConfig(projectRoot)));
+    // --- 31. Figma ---
+    server.registerTool("list_figma_related_assets", { description: "List assets in Figma folder or with figma in path.", inputSchema: {} }, async () => json(R.listFigmaRelatedAssets(projectRoot)));
+    // --- 32. Firebase ---
+    server.registerTool("get_firebase_config", { description: "Get Firebase config (GoogleServices path, project ID). No secrets.", inputSchema: {} }, async () => json(R.getFirebaseConfig(projectRoot)));
+    // --- 33. Steam ---
+    server.registerTool("get_steam_config", { description: "Get Steam config (steam_appid.txt, Steamworks path).", inputSchema: {} }, async () => json(R.getSteamConfig(projectRoot)));
+    // --- 34. Discord ---
+    server.registerTool("get_discord_config", { description: "Detect Discord SDK path in Plugins.", inputSchema: {} }, async () => json(R.getDiscordConfig(projectRoot)));
+    // --- 35. FMOD ---
+    server.registerTool("get_fmod_config", { description: "Get FMOD config (banks path, bank files).", inputSchema: {} }, async () => json(R.getFmodConfig(projectRoot)));
+    // --- 36. Wwise ---
+    server.registerTool("get_wwise_config", { description: "Get Wwise config (sound banks, project paths).", inputSchema: {} }, async () => json(R.getWwiseConfig(projectRoot)));
+    // --- 37. Substance ---
+    server.registerTool("list_substance_assets", { description: "List Substance .sbsar and .sbs assets.", inputSchema: {} }, async () => json(R.listSubstanceAssets(projectRoot)));
+    // --- 38. SpeedTree ---
+    server.registerTool("list_speedtree_assets", { description: "List SpeedTree .spm and .stm assets.", inputSchema: {} }, async () => json(R.listSpeedTreeAssets(projectRoot)));
+    // --- 39. Lottie ---
+    server.registerTool("list_lottie_assets", { description: "List Lottie-related JSON assets.", inputSchema: {} }, async () => json(R.listLottieAssets(projectRoot)));
+    // --- 40. Analytics / crash ---
+    server.registerTool("get_analytics_or_crash_config", { description: "Detect analytics/crash reporting services (Unity, Sentry, Crashlytics, BugSnag).", inputSchema: {} }, async () => json(R.getAnalyticsOrCrashConfig(projectRoot)));
+    // --- 41. Ads ---
+    server.registerTool("get_ads_config", { description: "Detect ad SDK presence (Unity Ads, AdMob, ironSource).", inputSchema: {} }, async () => json(R.getAdsConfig(projectRoot)));
+    // --- 42. Git LFS ---
+    server.registerTool("get_git_lfs_tracked", { description: "Get Git LFS patterns from .gitattributes.", inputSchema: {} }, async () => json(R.getGitLfsTracked(projectRoot)));
+    // --- 43. Plastic SCM ---
+    server.registerTool("get_plastic_config", { description: "Get Plastic SCM config (.plastic, workspace name).", inputSchema: {} }, async () => json(R.getPlasticConfig(projectRoot)));
     const transport = new StdioServerTransport();
     await server.connect(transport);
 }

package/dist/readers.d.ts

@@ -0,0 +1,166 @@
+/**
+ * Unity project filesystem readers. No Unity Editor required.
+ * All paths are relative to project root.
+ */
+export declare function readFileSafe(root: string, ...path: string[]): string | null;
+export declare function readJsonSafe<T>(root: string, ...path: string[]): T | null;
+/** Recursively list files under dir, relative to root. Optional extension filter (e.g. ".cs"). */
+export declare function listFilesRecursive(root: string, dir: string, opts?: {
+    ext?: string;
+    excludeMeta?: boolean;
+}): string[];
+/** Parse Unity YAML-like key-value (m_Key: value) from content. */
+export declare function parseUnityKeyValue(content: string): Record<string, string>;
+/** Get GUID from a .meta file path (reads sibling .meta of asset). */
+export declare function getGuidFromMeta(root: string, assetPath: string): string | null;
+/** Get asset path by GUID (scan Assets for .meta with this guid). */
+export declare function getAssetPathByGuid(root: string, guid: string): string | null;
+/** Find all Asset/Scene/Prefab files that reference this GUID (fileRef or guid:). */
+export declare function findReferencesToGuid(root: string, guid: string): string[];
+export declare function getUnityVersion(root: string): string;
+export declare function getBuildScenes(root: string): {
+    index: number;
+    path: string;
+    name: string;
+}[];
+export interface PackageInfo {
+    name: string;
+    version: string;
+    type?: string;
+}
+export declare function getPackages(root: string): {
+    dependencies: PackageInfo[];
+    lock?: Record<string, string>;
+};
+export declare function getPlayerSettings(root: string): Record<string, string>;
+export declare function getQualitySettings(root: string): Record<string, string>[];
+export declare function getScriptingDefines(root: string): {
+    global: string[];
+    perAssembly: Record<string, string[]>;
+};
+export interface AsmDefInfo {
+    path: string;
+    name: string;
+    references: string[];
+    defineConstraints?: string[];
+    optionalUnityReferences?: string[];
+    includePlatforms?: string[];
+}
+export declare function getAssemblyDefinitions(root: string): AsmDefInfo[];
+export declare function listScripts(root: string, folderPrefix?: string): string[];
+/** Simple grep for type/namespace in .cs file content. */
+export declare function findScriptsByContent(root: string, pattern: "MonoBehaviour" | "ScriptableObject" | string, namespaceFilter?: string): string[];
+export declare function getAllScenes(root: string): string[];
+/** Minimal scene summary: root GameObjects (top-level in hierarchy). */
+export declare function getSceneSummary(root: string, scenePath: string): {
+    rootObjects: string[];
+    componentCount: number;
+};
+export declare function getPrefabs(root: string, pathPrefix?: string): string[];
+export declare function getAssetFolderTree(root: string, maxDepth?: number): Record<string, string[]>;
+export declare function listAssetsByExtension(root: string, ext: string, folder?: string): string[];
+export declare function getMaterials(root: string, folder?: string): {
+    path: string;
+    shader?: string;
+}[];
+export declare function getShaders(root: string): string[];
+export declare function getAnimatorControllers(root: string): string[];
+export declare function getAnimationClips(root: string): string[];
+/** High-level state names from .controller (m_StateMachine -> states). */
+export declare function getAnimatorStates(root: string, controllerPath: string): string[];
+export declare function getAudioClips(root: string): string[];
+export declare function getAudioMixers(root: string): string[];
+export declare function getAddressablesInfo(root: string): {
+    groups: string[];
+    configPath: string | null;
+};
+export declare function getLocalizationTables(root: string): string[];
+export declare function getInputAxes(root: string): {
+    name: string;
+    descriptiveName?: string;
+    positiveButton?: string;
+}[];
+export declare function getTagsAndLayers(root: string): {
+    tags: string[];
+    layers: string[];
+};
+export declare function getTestAssemblies(root: string): AsmDefInfo[];
+export declare function getRepoDocs(root: string): Record<string, string>;
+export declare function getProjectVersion(root: string): string;
+export declare function getChangelog(root: string): string | null;
+export declare function getPhysicsSettings(root: string): {
+    dynamics?: Record<string, string>;
+    physics2d?: Record<string, string>;
+};
+export declare function listRenderPipelines(root: string): {
+    pipelines: string[];
+    volumeProfiles: string[];
+};
+export declare function listTimelinePlayables(root: string): string[];
+export declare function listSpriteAtlases(root: string): string[];
+export declare function listTilemapAssets(root: string): string[];
+export declare function listShaderGraphs(root: string): string[];
+export declare function listVfxGraphs(root: string): string[];
+export declare function listTmpFonts(root: string): string[];
+export declare function getTmpSettingsPath(root: string): string | null;
+export declare function listUiDocuments(root: string): {
+    uxml: string[];
+    uss: string[];
+};
+export declare function listInputActionAssets(root: string): string[];
+export declare function getInputActionsSummary(root: string, path: string): {
+    maps: string[];
+    actions: string[];
+};
+export declare function listPresets(root: string): string[];
+export declare function listEditorScripts(root: string): string[];
+export declare function getPrefabScriptGuids(root: string, prefabPath: string): string[];
+export declare function getAssemblyDependencyGraph(root: string): {
+    nodes: string[];
+    edges: [string, string][];
+};
+export declare function listCiConfigs(root: string): string[];
+export declare function listLargeAssets(root: string, minSizeMb?: number): {
+    path: string;
+    sizeMb: number;
+}[];
+export declare function getPlayFabConfig(root: string): {
+    titleId?: string;
+    configPaths: string[];
+};
+export declare function listFigmaRelatedAssets(root: string): string[];
+export declare function getFirebaseConfig(root: string): {
+    googleServicesJson?: string;
+    plist?: string;
+    projectId?: string;
+};
+export declare function getSteamConfig(root: string): {
+    steamAppIdTxt?: string;
+    steamworksPath?: string;
+};
+export declare function getDiscordConfig(root: string): {
+    sdkPath?: string;
+};
+export declare function getFmodConfig(root: string): {
+    banksPath?: string;
+    projectPath?: string;
+    bankFiles: string[];
+};
+export declare function getWwiseConfig(root: string): {
+    soundBanksPath?: string;
+    projectPaths: string[];
+};
+export declare function listSubstanceAssets(root: string): string[];
+export declare function listSpeedTreeAssets(root: string): string[];
+export declare function listLottieAssets(root: string): string[];
+export declare function getAnalyticsOrCrashConfig(root: string): {
+    services: string[];
+};
+export declare function getAdsConfig(root: string): {
+    sdkPresence: string[];
+};
+export declare function getGitLfsTracked(root: string): string[];
+export declare function getPlasticConfig(root: string): {
+    plasticDir: boolean;
+    workspaceName?: string;
+};