Awesome

<img alt="logo" height="26" src="https://github.com/user-attachments/assets/9d9dac2f-bfa5-4510-9d88-fe28ffcc1619"/> Sub Asset Editor

<< 📝 Description | 📌 Key Features | ⚙ Installation | 🚀 Usage | 🤝 Contributing >>

📝 Description

Sub Asset Editor is an editor tool for adding, removing, and editing sub-assets within your project.

📌 Key Features
⚙ Installation
🚀 Usage
🤝 Contributing
License
Author
See Also

📌 Key Features

Add Sub-Assets: Add sub-assets to a main asset.
- Drag and drop assets to add them as sub-assets.
- Convert assets referenced by the main asset into sub-assets. References are automatically updated.
Remove Sub-Assets: Remove sub-assets from a main asset.
Rename Sub-Assets: Change the names of sub-assets.
Show/Hide Sub-Assets: Toggle the visibility of sub-assets.
- Hidden sub-assets will not appear in the Project view.

⚙ Installation

This package requires Unity 5.5 or later.

Install via OpenUPM

This package is available on OpenUPM package registry.
This is the preferred method of installation, as you can easily receive updates as they're released.
If you have openupm-cli installed, then run the following command in your project's directory:
```
openupm add com.coffee.sub-asset-editor
```
To update the package, use Package Manager UI (Window > Package Manager) or run the following command with @{version}:
```
openupm add com.coffee.sub-asset-editor@1.1.0
```

Install via UPM (with Package Manager UI)

Click Window > Package Manager to open Package Manager UI.
Click + > Add package from git URL... and input the repository URL: https://github.com/mob-sakai/SubAssetEditor.git
To update the package, change suffix #{version} to the target version.
- e.g. https://github.com/mob-sakai/SubAssetEditor.git#1.1.0

Install via UPM (Manually)

Open the Packages/manifest.json file in your project. Then add this package somewhere in the dependencies block:

{
  "dependencies": {
    "com.coffee.sub-asset-editor": "https://github.com/mob-sakai/SubAssetEditor.git",
    ...
  }
}

To update the package, change suffix #{version} to the target version.
- e.g. "com.coffee.sub-asset-editor": "https://github.com/mob-sakai/SubAssetEditor.git#1.1.0",

Install as Embedded Package

Download the Source code (zip) file from Releases and extract it.
Move the <extracted_dir>/Packages/src directory into your project's Packages directory.
- You can rename the src directory if needed.
- If you intend to fix bugs or add features, installing it as an embedded package is recommended.
- To update the package, re-download it and replace the existing contents.

🚀 Usage

Install the package.
Open the Sub Asset Editor from Assets > Edit Sub Asset.
- You can also access it via the context menu by right-clicking an asset and selecting Edit Sub Asset.
Select a main asset.
To add a sub-asset, drag and drop an asset onto <img height="16" src="https://github.com/user-attachments/assets/6f51f9cc-049f-4bed-8865-5328327a9b99"/> or click the "+" button.
To remove a sub-asset, click the "-" button.
To rename a sub-asset, edit its name directly in the text field.
To toggle the visibility of a sub-asset, click <img height="14" src="https://github.com/user-attachments/assets/3336fe78-3429-46d4-8076-8e68955d87a1"/> or <img height="14" src="https://github.com/user-attachments/assets/1b03a5b2-7b0a-4246-9a63-c24693feca50"/>.
If a sub-asset is referenced by the main asset, <img height="14" src="https://github.com/user-attachments/assets/f7f8b37b-6a6a-4d18-99e3-0c67820679fa"/> will be displayed.
Enjoy!

🤝 Contributing

Issues

Issues are incredibly valuable to this project:

Ideas provide a valuable source of contributions that others can make.
Problems help identify areas where this project needs improvement.
Questions indicate where contributors can enhance the user experience.

Pull Requests

Pull requests offer a fantastic way to contribute your ideas to this repository.
Please refer to CONTRIBUTING.md and use develop branch for development.

Support

This is an open-source project developed during my spare time.
If you appreciate it, consider supporting me.
Your support allows me to dedicate more time to development. 😊