assets-move

Move and rename Unity assets by path with AssetDatabase.Refresh().

3.8k|349|Updated Apr 2, 2025
One-click install
npx skills add https://github.com/IvanMurzak/Unity-MCP --skill assets-move-ivanmurzak
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: assets-move
Source: https://github.com/IvanMurzak/Unity-MCP/tree/main/Unity-MCP-Plugin/.claude/skills/assets-move
Command: npx skills add https://github.com/IvanMurzak/Unity-MCP --skill assets-move-ivanmurzak

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Move assets within a Unity project by path, enabling asset renames while preserving references and triggering AssetDatabase.Refresh() afterward.

Core Features & Use Cases

  • Move and rename assets by specifying source and destination paths.
  • Ensure AssetDatabase.Refresh() is called to update Unity's asset database.
  • Use with assets-find tool to locate assets before moving.

Quick Start

Run the assets-move tool with the required input to relocate assets in your Unity project.

Frequently Asked Questions about assets-move

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I move and rename Unity assets by path while preserving references?

To move and rename Unity assets by path, you specify sourcePaths and destinationPaths to relocate them while preserving references. The operation triggers AssetDatabase.Refresh() afterward to update the Unity asset database.

How can I batch migrate Unity assets to new directory paths?

Batch migrating Unity assets involves providing arrays of sourcePaths and destinationPaths to relocate multiple files simultaneously. This deterministic asset move process ensures consistent path updates across large projects.

Does moving Unity assets require calling AssetDatabase.Refresh manually?

Moving Unity assets with this method does not require calling AssetDatabase.Refresh manually. The execution automatically invokes AssetDatabase.Refresh() after the relocation and renaming operation to sync the database.

What is the best way to automate asset reorganization in large Unity projects?

Automating asset reorganization in large Unity projects is best done by specifying source and destination paths for batch migrations. This approach performs deterministic asset moves and ensures AssetDatabase paths are updated consistently.

Can I use assets-find to locate Unity assets before moving them?

You can use the assets-find tool to locate Unity assets before moving them. After finding the desired assets, you pass their paths as sourcePaths to the assets-move tool for relocation and renaming.

Why are my Unity asset references breaking after renaming files?

Unity asset references may break after renaming if AssetDatabase.Refresh() is not invoked. Moving assets through the AssetDatabase with a proper refresh ensures that reference paths are updated and preserved correctly.