https://github.com/phanphantz/unity-quick-dropdown
C# Attributes that allow you to quickly assign Unity assets from a Dropdown on the Inspector.
https://github.com/phanphantz/unity-quick-dropdown
dropdown-menu inspector-unity3d unity unity-editor unity-package unity-plugin unity-tool unity-ugui unity3d-plugin
Last synced: 5 months ago
JSON representation
C# Attributes that allow you to quickly assign Unity assets from a Dropdown on the Inspector.
- Host: GitHub
- URL: https://github.com/phanphantz/unity-quick-dropdown
- Owner: phanphantz
- License: mit
- Created: 2025-03-05T19:47:31.000Z (11 months ago)
- Default Branch: master
- Last Pushed: 2025-03-13T21:08:57.000Z (11 months ago)
- Last Synced: 2025-03-13T21:29:23.738Z (11 months ago)
- Topics: dropdown-menu, inspector-unity3d, unity, unity-editor, unity-package, unity-plugin, unity-tool, unity-ugui, unity3d-plugin
- Language: C#
- Homepage:
- Size: 75.2 KB
- Stars: 11
- Watchers: 1
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# ⚡Unity Quick Dropdown
C# Attributes that allow you to quickly assign Unity assets from a Dropdown on the Inspector. Support any `UnityEngine.Object` types. Help save time and reduce human errors by letting you pick an object from your desired location.
> [!NOTE]
> This Library is not an Official Library from Unity.
# Overview
- **[FromFolder]** - Display a Dropdown of Unity Assets from a specific **Folder**.
- **[FromGroup]** - Display a Dropdown of Unity Assets from the `ScriptableGroup` with a matching name.
- Using `ScriptableGroups` allows you to move the assets in the project around without losing their group organization.
- You can nest ScriptableGroup inside each other. Cyclic references are also prevented and filtered out.
- **[FromConfig]** - Display a Dropdown of Unity Assets from a first found `ScriptableContainer` with a specified type.
- This is useful for looking up objects from a ScriptableObject that is meant to be a singular "Config" or "Setting" (a Singleton if you will)
- **[FromAddressable]** - Display a Dropdown of Addressable Assets from a specific Addressable Group.
- Supported **List & Array** (Both direct usage & nested elements)
- **QoL Features**:
- Select & Jump to the assigned asset or its enclosing location.
- You get a **Fix** button for creating a new source if it does not exist.
- An **Inspect** button allows you to quickly open a floating property window of the assigned asset.
- Warn user if the assigned object does not belong to the specified location.
- Warn about invalid locations.
- Supports nested dropdown.
- Easily customize how the Dropdown look using attribute parameters.
- Supports Multi-Edit.
- Undo-Friendly.
- For **ScriptableObjects**:
- Quickly create new instances of `ScriptableObject` and add them into the specified location from a `+` button. When creating a new asset this way, the enclosing Folder / ScriptableGroup are also **created automatically** if they didn't exist.
## **Installation**
There are 2 options to install the package:
- A) Download source code and put them into the Unity's Assets folder
- B) Install from the **Package Manager** using this git URL: https://github.com/phanphantz/Unity-Quick-Dropdown.git
# Quick Example
```csharp
using PhEngine.QuickDropdown;
using UnityEngine;
public class QuickDropdownExample : MonoBehaviour
{
public float health;
//Let user pick 'ElementConfig' asset from the ScriptableGroup named 'TestGroup' in the asset folder.
//By default, This also display Inspect button, Create button (Only for ScriptableObjects), and a mini button to jump to the enclosing group.
[FromGroup("TestGroup"), SerializeField]
ElementConfig element;
//Let user pick 'ElementConfig' from a first found ScriptableObject with the type of 'SampleConfig'
[FromConfig(typeof(SampleConfig)), SerializeField]
ElementConfig sampleConfigItem;
public float attack;
public float stamina;
//Let user pick Sprite from the folder 'Assets/Sprites' and all the subfolders below.
//The folder information is hidden from 'isHideInfo' flag
//These path variations also work: 'Assets/Sprites', 'Assets/Sprites/', 'Sprites/'
[FromFolder("Sprites", isHideInfo: true), SerializeField]
Sprite sprite;
//By default, Inspect button will open the assigned asset as a floating window.
//You can change the button behaviour using different InpsectModes
[FromFolder("Prefabs", inspectMode: InspectMode.Select), SerializeField]
GameObject prefab;
}
```
### Result:
# List & Array Support
```csharp
//Quick Dropdown now directly supports List & Array
[FromGroup("TestGroup"), SerializeField]
List directList = new List();
[FromGroup("TestGroup"), SerializeField]
ElementConfig[] directArray = new ElementConfig[] {};
//Nested List & Array also works
[SerializeField] List nestedDropdownList = new List();
[SerializeField] ElementConfigData[] nestedDropdownArray = new ElementConfigData[] {};
```
# Addressables Support
If you have the **Addressables** package installed in the project, you can use **[FromAddressable]** attribute on **Unity Object fields** and **string fields** to display a dropdown of Addressable assets from a desired group.
- When you specify an Addressable group name that does not exist. You also get the **Fix** button on the inspector to quickly create it.
- Creating **ScriptableObjects** using **Create** button from the inspector will also add the created asset to the target Addressable Group.
```csharp
using PhEngine.QuickDropdown.Addressables;
using UnityEngine;
public class AddressableDropdownExample : MonoBehaviour
{
[FromAddressable("PackedAddressableGroup"), SerializeField]
ElementConfig addressableConfig;
[FromAddressable("PackedAddressableGroup"), SerializeField]
string addressableAddress;
}
```
> [!NOTE]
> Unfortunately **[FromAddressable]** does not work with **AssetReference** at the moment. Since it is drawn by its own property drawer.
# Future Plans
- **[FromScene]** attribute.
- **[FromStringList]** attribute.
- A way to bind Create functions for creating non-ScriptableObject assets.
- A Popup UGUI to specify the name of the asset upon creation.
Please feel free to Contribute and send me Pull requests.
You can also [**Buy me a coffee!**](https://buymeacoffee.com/phanphantz)☕
**Phun,**\
phun.peeticharoenthum@gmail.com