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
  • Install via OpenUPM
  • Install via UPM (with Package Manager UI)
  • Install via UPM (Manually)
  • Install as Embedded Package
• 🚀 Usage
• 🤝 Contributing
  • Issues
  • Pull Requests
  • Support
• 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.
• Remove Missing Script Assets: (Unity 2023.2 or later) Remove ScriptableObject sub-assets with missing scripts.
• 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.
• Synchronize selection with Project View: Selecting a main asset in the Project view will automatically open it in the Sub Asset Editor (default: disabled).

⚙ 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.2.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.2.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.2.0",

Install as Embedded Package

1. Download the Source code (zip) file from Releases and extract it.
2. 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

1. Install the package.
2. 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.
3. Select a main asset.
4. To add a sub-asset, drag and drop an asset onto or click the "+" button.
5. To remove a sub-asset, click the "-" button.
6. To rename a sub-asset, edit its name directly in the text field.
7. To toggle the visibility of a sub-asset, click or .
8. If a sub-asset is referenced by the main asset, will be displayed.
9. 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. 😊

License

• MIT

Author

• mob-sakai

See Also

• GitHub page : https://github.com/mob-sakai/SubAssetEditor
• Releases : https://github.com/mob-sakai/SubAssetEditor/releases
• Issue tracker : https://github.com/mob-sakai/SubAssetEditor/issues
• Change log : https://github.com/mob-sakai/SubAssetEditor/blob/main/CHANGELOG.md