Agent Skills
› IvanMurzak/Unity-MCP
IvanMurzak/Unity-MCP
GitHub用于构建 unity-mcp-cli TypeScript CLI 工具并全局链接，包含安装依赖、编译源码、创建符号链接及版本验证步骤。
安装全部 Skills
npx skills add IvanMurzak/Unity-MCP --all -g -y
集合内 Skills (80)
按质量分展示前 50 个（共 80 个），完整列表请用安装命令预览或逐个打开详情。
用于构建 unity-mcp-cli TypeScript CLI 工具并全局链接，包含安装依赖、编译源码、创建符号链接及版本验证步骤。
需要构建或更新 CLI 工具时
首次安装或执行 npm link 操作时
验证 CLI 是否可用时
npx skills add IvanMurzak/Unity-MCP --skill build-cli -g -y
自动审查 GitHub PR 中的未解决评论，验证其合理性后直接修复代码问题。支持按文件并行处理以提升效率，同时避免同一文件的编辑冲突。
用户希望自动化处理 GitHub PR 的 Review 评论
需要批量修复 PR 中确认的代码缺陷或逻辑错误
npx skills add IvanMurzak/Unity-MCP --skill github-pr-review-fix -g -y
在Unity项目中将指定路径的资源复制到新路径，并刷新资源数据库。支持批量操作及错误累积处理，需先使用assets-find定位源文件。
需要复制Unity项目中的资源文件
批量移动或备份Assets目录下的资产
npx skills add IvanMurzak/Unity-MCP --skill assets-copy -g -y
在Unity项目的Assets目录下创建新文件夹，支持批量操作并自动刷新资源数据库。适用于整理项目结构和脚本资产的组织工作。
用户需要在Unity项目中创建新的资源或脚本文件夹
用户需要批量创建多层级或指定路径的文件夹以组织资产
npx skills add IvanMurzak/Unity-MCP --skill assets-create-folder -g -y
用于在Unity项目中删除指定路径的资源文件，并刷新资源数据库。支持批量原子删除及错误反馈，需配合assets-find工具使用。
需要删除Unity项目中的特定资源文件
清理不再使用的Assets路径
执行资源批处理删除操作
npx skills add IvanMurzak/Unity-MCP --skill assets-delete -g -y
用于在Unity编辑器内置资源中搜索资产，支持按名称和类型过滤，提供智能排序与结果限制。
用户需要查找Unity内置资源中的特定资产
用户需要根据名称或类型筛选内置资源
npx skills add IvanMurzak/Unity-MCP --skill assets-find-built-in -g -y
在Unity资源数据库中根据名称、标签、类型等过滤器搜索资源，支持指定搜索范围和结果数量限制。
查找特定类型的Unity资源
按名称或标签搜索资产
定位资源包中的资源
npx skills add IvanMurzak/Unity-MCP --skill assets-find -g -y
用于从Unity项目资产文件中获取序列化字段和属性数据。支持通过路径或视图查询进行选择性读取，以节省Token。
需要读取Unity资产内部结构
获取特定Asset的序列化数据
npx skills add IvanMurzak/Unity-MCP --skill assets-get-data -g -y
在Unity项目中创建新的材质资产，支持自动创建中间文件夹。需指定Assets/路径和有效的Shader名称，用于快速生成默认材质的资源文件。
用户需要创建新的Unity材质文件
自动化构建或初始化项目资产结构
npx skills add IvanMurzak/Unity-MCP --skill assets-material-create -g -y
用于修改Unity项目Assets文件夹中的资产文件。支持content、pathPatches和jsonPatch三种修改方式，需先使用assets-get-data检查结构。
需要修改Unity资产文件内容时
更新Prefab或ScriptableObject属性时
npx skills add IvanMurzak/Unity-MCP --skill assets-modify -g -y
用于在Unity项目中移动或重命名资源文件，自动刷新AssetDatabase并返回成功路径与错误信息。需先使用assets-find定位资源。
需要移动或重命名Unity项目中的资源文件
批量调整资源路径或文件名
npx skills add IvanMurzak/Unity-MCP --skill assets-move -g -y
用于在Unity编辑器中关闭当前打开的Prefab编辑阶段，可选择是否保存更改。需先通过assets-prefab-open打开Prefab。
用户完成Prefab编辑后需要关闭编辑界面
用户需要退出Prefab编辑模式并返回主场景
npx skills add IvanMurzak/Unity-MCP --skill assets-prefab-close -g -y
用于在Unity项目中指定路径创建Prefab或Prefab Variant。支持从场景GameObject或现有Prefab资产生成，自动创建缺失文件夹并返回资源引用。
需要新建Prefab资产
需要将场景对象保存为Prefab
需要基于现有Prefab创建变体
npx skills add IvanMurzak/Unity-MCP --skill assets-prefab-create -g -y
在Unity场景中实例化预制体，支持指定位置、旋转、缩放及父级路径。用于游戏场景搭建或运行时动态生成对象。
需要在当前场景中创建新的GameObject
根据预制体路径生成游戏实体
npx skills add IvanMurzak/Unity-MCP --skill assets-prefab-instantiate -g -y
Unity预制体编辑工具，通过GameObject引用打开预制体编辑阶段。支持场景实例和资产预制体，修改将同步至所有实例，需配合关闭工具使用。
用户需要编辑或修改Unity预制体
用户希望批量更新场景中的预制体实例
npx skills add IvanMurzak/Unity-MCP --skill assets-prefab-open -g -y
用于在Unity编辑器中保存当前打开的预制体编辑阶段，将其内容写回预制体资产。需先使用assets-prefab-open进入编辑模式，调用后返回资产引用。
用户在Unity编辑器中修改完预制体需要保存
自动化流程中需要将预制体状态持久化到磁盘
npx skills add IvanMurzak/Unity-MCP --skill assets-prefab-save -g -y
刷新Unity资源数据库，用于同步外部文件变更或强制脚本重新编译。支持处理状态反馈与错误详情返回，适用于Unity编辑器自动化场景。
项目文件在Unity API外被添加或更新
.cs脚本文件变更需要强制重新编译
npx skills add IvanMurzak/Unity-MCP --skill assets-refresh -g -y
获取Unity项目中Shader资产的详细数据，包括属性、子着色器、编译消息及支持状态。支持通过路径或视图查询进行精细化读取以节省Token。
需要查看Unity Shader的具体结构和属性
调试Shader编译错误或警告信息
查询Shader的子着色器和Pass结构
npx skills add IvanMurzak/Unity-MCP --skill assets-shader-get-data -g -y
列出项目中所有可用的着色器名称，按字母排序。主要用于发现有效着色器名，以便为创建材质等操作提供参数支持。
需要查找项目中存在的着色器名称
准备使用 assets-material-create 工具前需确认 shaderName
npx skills add IvanMurzak/Unity-MCP --skill assets-shader-list-all -g -y
清理Unity编辑器控制台和MCP日志缓存，用于在特定操作前隔离并清空日志记录。
需要清空Unity Console日志
重置MCP日志缓存以便追踪新日志
npx skills add IvanMurzak/Unity-MCP --skill console-clear-logs -g -y
从 Unity Editor 的 LogCollector 检索日志，支持按类型、时间窗口过滤及包含堆栈跟踪。用于调试和监控编辑器活动。
需要排查 Unity 编辑器中的错误或警告
分析近期编辑器运行日志
npx skills add IvanMurzak/Unity-MCP --skill console-get-logs -g -y
获取Unity编辑器当前状态，包括播放模式、暂停、编译及资产数据库刷新等标志位信息。
查询Unity编辑器运行状态
检查脚本编译进度
判断编辑器是否处于播放或暂停模式
npx skills add IvanMurzak/Unity-MCP --skill editor-application-get-state -g -y
控制Unity编辑器运行状态，支持启动、停止或暂停PlayMode。调用前建议先检查当前状态，若存在编译错误则拒绝操作并抛出详情。
需要启动或停止Unity PlayMode
需要暂停或恢复Unity PlayMode
切换Unity编辑器应用状态
npx skills add IvanMurzak/Unity-MCP --skill editor-application-set-state -g -y
获取Unity编辑器中当前选择对象的信息，包括激活对象、GameObject、Transform、实例ID和资源GUID等，支持按需启用不同数据字段。
需要查询Unity编辑器中当前选中的对象信息
获取场景或预制体中选中的GameObject及其属性
npx skills add IvanMurzak/Unity-MCP --skill editor-selection-get -g -y
用于在Unity编辑器中设置当前选中对象。接收ObjectRef数组，解析后更新Selection.objects并刷新视图，返回选择状态快照。需确保引用有效，常与获取选中工具配合使用。
需要更改Unity编辑器中的选中对象时
通过脚本或工具批量选中场景或预制体对象时
npx skills add IvanMurzak/Unity-MCP --skill editor-selection-set -g -y
向 Unity 预制体或场景中的 GameObject 添加组件。支持通过全名或类名指定组件类型，批量处理并累积错误，避免单次失败中断流程。
需要给游戏对象添加新组件时
批量修改或初始化 GameObject 属性时
npx skills add IvanMurzak/Unity-MCP --skill gameobject-component-add -g -y
Unity编辑器工具，用于从指定GameObject中销毁一个或多个组件。支持通过实例ID或路径定位目标，自动跳过空引用，并记录销毁操作。
需要从游戏对象中移除特定组件
清理不需要的脚本或功能模块
npx skills add IvanMurzak/Unity-MCP --skill gameobject-component-destroy -g -y
获取Unity GameObject指定组件的详细信息，包括类型、启用状态及序列化字段。支持通过路径或视图查询节省Token，用于在修改前检查组件数据。
需要查看Unity组件的具体属性值
检查组件是否启用或获取其序列化数据
npx skills add IvanMurzak/Unity-MCP --skill gameobject-component-get -g -y
列出项目中所有Unity组件的C#类型名，支持分页和搜索。用于为添加组件工具查找有效的组件名称。
查询可用的Unity组件类型
为添加组件操作获取组件名称
npx skills add IvanMurzak/Unity-MCP --skill gameobject-component-list-all -g -y
用于在Unity预制体或场景中修改GameObject组件的属性。支持componentDiff、pathPatches和jsonPatch三种修改方式，可精确调整字段值。
需要修改Unity GameObject组件属性
批量更新游戏对象配置
npx skills add IvanMurzak/Unity-MCP --skill gameobject-component-modify -g -y
在Unity场景或预制体中创建新的GameObject，支持指定名称、父对象、变换属性及原始几何体类型。
需要在Unity场景中创建新对象
需要生成基本几何体如立方体或球体
npx skills add IvanMurzak/Unity-MCP --skill gameobject-create -g -y
在Unity编辑器中销毁指定GameObject及其所有嵌套子对象，返回被销毁对象的名称、路径和实例ID以确认操作结果。
需要删除场景或预制体中的游戏对象
清理不再使用的GameObject资源
npx skills add IvanMurzak/Unity-MCP --skill gameobject-destroy -g -y
用于在Unity编辑器中批量复制预制体或场景中的GameObject。通过传入对象引用列表，原子化执行复制操作并标记场景为脏状态，确保数据保存。
需要批量复制游戏对象
预制体或场景中重复创建相同结构
npx skills add IvanMurzak/Unity-MCP --skill gameobject-duplicate -g -y
在Unity中查找指定GameObject，支持Prefab或场景。可获取组件、边界、层级结构及数据，支持路径过滤以节省Token。
需要定位Unity中的特定游戏对象
查询GameObject的组件或属性信息
npx skills add IvanMurzak/Unity-MCP --skill gameobject-find -g -y
用于在Unity场景中批量修改GameObject字段和属性。支持通过差异、路径补丁或JSON合并补丁三种方式对预制体或场景中的对象进行原子化更新，适用于游戏开发中的对象状态调整。
需要批量修改Unity GameObject的属性值
需要在Prefab或Scene中更新游戏对象字段
需要使用JSON补丁或路径补丁修改Unity对象
npx skills add IvanMurzak/Unity-MCP --skill gameobject-modify -g -y
在Unity编辑器中批量重设GameObject的父级，支持Prefab和场景。保留世界坐标或报错继续，需配合gameobject-find使用。
需要批量修改游戏对象层级结构
将多个对象重新挂载到新的父节点下
npx skills add IvanMurzak/Unity-MCP --skill gameobject-set-parent -g -y
获取Unity UnityEngine.Object的序列化数据，支持字段、属性及路径/视图查询过滤。用于读取对象状态或配合修改工具使用。
需要读取Unity对象内部状态
调试游戏对象属性值
备份或导出场景对象数据
npx skills add IvanMurzak/Unity-MCP --skill object-get-data -g -y
用于修改Unity UnityEngine.Object的可序列化字段和属性。支持objectDiff、pathPatches和jsonPatch三种修改方式，需先使用object-get-data检查结构。
需要修改Unity对象的字段或属性值
通过JSON Patch或路径补丁批量更新对象状态
npx skills add IvanMurzak/Unity-MCP --skill object-modify -g -y
用于在Unity项目中通过包管理器添加、安装指定ID或路径的包，自动更新manifest.json并处理域重载通知。
用户需要安装新的Unity包
用户指定从Git URL或本地路径添加依赖
npx skills add IvanMurzak/Unity-MCP --skill package-add -g -y
列出Unity项目中所有UPM包的信息，支持按来源、名称及直接依赖过滤，用于添加或删除包前的检查。
查询Unity项目已安装的UPM包列表
根据来源或名称筛选特定Unity包
npx skills add IvanMurzak/Unity-MCP --skill package-list -g -y
用于从Unity项目中卸载指定UPM包，修改manifest.json并处理域重载后的结果返回。
用户要求移除或卸载Unity项目中的某个包
需要清理项目中不再使用的依赖包
npx skills add IvanMurzak/Unity-MCP --skill package-remove -g -y
用于在Unity包管理器中搜索注册表和本地已安装包的技能。支持按名称、ID或描述关键词查询，返回版本信息和安装状态，适用于开发前的包查找与评估。
用户需要查找Unity特定功能的包
用户想查看本地已安装的包列表
用户在安装新包前需要确认版本兼容性
npx skills add IvanMurzak/Unity-MCP --skill package-search -g -y
轻量级就绪探针，用于 CLI 健康检查、MCP 传输连通性验证及往返延迟测量。输入可选消息并原样返回，无外部 I/O，适合作为调用重型工具前的存活检测。
CLI 健康检查
MCP 传输连通性烟雾测试
系统存活状态验证
npx skills add IvanMurzak/Unity-MCP --skill ping -g -y
捕获Unity当前帧的性能数据快照，包括FPS、帧耗时及运行时间等指标。
需要获取Unity游戏运行时性能数据
调试帧率或渲染延迟问题
npx skills add IvanMurzak/Unity-MCP --skill profiler-capture-frame -g -y
用于清除Unity编辑器Profiler的帧数据历史，重置记录起点。适用于性能分析前的清理或重新开始录制场景。
用户要求清除Profiler数据
需要重置Profiler录制起点
npx skills add IvanMurzak/Unity-MCP --skill profiler-clear-data -g -y
用于在本地维护 Unity Profiler 模块的启用状态标记，供其他工具查询。因 Unity API 限制，仅做记录不直接控制运行时。
需要更新或检查特定性能分析模块的启用状态
配合 profiler-get-status 或 profiler-list-modules 进行状态管理
npx skills add IvanMurzak/Unity-MCP --skill profiler-enable-module -g -y
通过Unity内置Profiler API获取内存统计快照，包括保留、分配、Mono堆及图形内存等指标（MB），用于性能分析与监控。
需要分析Unity应用内存使用情况
排查内存泄漏或性能瓶颈
npx skills add IvanMurzak/Unity-MCP --skill profiler-get-memory-stats -g -y
用于从Unity内置API获取渲染性能数据，包括帧时间、FPS、垂直同步设置及图形设备信息。适用于游戏性能监控与分析场景。
查询当前游戏帧率或渲染性能
分析Unity应用运行时状态
npx skills add IvanMurzak/Unity-MCP --skill profiler-get-rendering-stats -g -y
Unity性能分析工具，用于获取脚本执行时间（帧时间、固定增量等）及Mono和GC内存使用情况。
查询Unity运行时性能指标
监控游戏帧率和内存占用
npx skills add IvanMurzak/Unity-MCP --skill profiler-get-script-stats -g -y
获取Unity Profiler当前状态，包括启用状态、活跃模块、最大内存使用及平台支持情况。用于监控和诊断游戏性能数据。
查询Unity性能分析器状态
检查Profiler是否启用
获取运行时内存占用信息
npx skills add IvanMurzak/Unity-MCP --skill profiler-get-status -g -y
