assets-refresh
GitHub用于刷新Unity资产数据库，在外部文件变更或需强制脚本重新编译时调用。支持同步导入、处理状态等待及编译错误反馈，确保项目资源与代码状态同步。
Trigger Scenarios
Install
npx skills add IvanMurzak/Unity-MCP --skill assets-refresh -g -y
SKILL.md
Frontmatter
{
"name": "assets-refresh",
"description": "Refresh the Unity AssetDatabase. Use after files were added or updated outside of the Unity API, or to force script recompilation when a '.cs' file changed. Returns a processing\/success response and waits for compilation when triggered."
}
Assets / Refresh
Refreshes the AssetDatabase. Use it if any file was added or updated in the project outside of Unity API. Use it if need to force scripts recompilation when '.cs' file changed.
Inputs
options—ImportAssetOptionsflag (defaultForceSynchronousImport).requestId— required for processing-mode responses; the tool returnsProcessingimmediately and delivers a follow-up completion when compilation finishes.
Behavior
Runs AssetDatabase.Refresh(options). If EditorApplication.isCompiling is true after the refresh, schedules a post-compilation notification and returns a Processing response. If compilation already failed (EditorUtility.scriptCompilationFailed), returns Success with the compilation error details. Otherwise returns a plain Success.
How to Call
unity-mcp-cli run-tool assets-refresh --input '{
"options": "string_value"
}'
For complex input (multi-line strings, code), save the JSON to a file and use:
unity-mcp-cli run-tool assets-refresh --input-file args.jsonOr pipe via stdin (recommended):
unity-mcp-cli run-tool assets-refresh --input-file - <<'EOF' {"param": "value"} EOF
Troubleshooting
If unity-mcp-cli is not found, either install it globally (npm install -g unity-mcp-cli) or use npx unity-mcp-cli instead.
Read the /unity-initial-setup skill for detailed installation instructions.
Input
| Name | Type | Required | Description |
|---|---|---|---|
options |
any |
No | Asset import options. |
Input JSON Schema
{
"type": "object",
"properties": {
"options": {
"$ref": "#/$defs/UnityEditor.ImportAssetOptions"
}
},
"$defs": {
"UnityEditor.ImportAssetOptions": {
"type": "string",
"enum": [
"Default",
"ForceUpdate",
"ForceSynchronousImport",
"ImportRecursive",
"DontDownloadFromCacheServer",
"ForceUncompressedImport"
]
}
}
}
Output
This tool does not return structured output.
Version History
- 0.86.1 Current 2026-07-25 08:50
