⚡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

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

//Quick Dropdown now directly supports List & Array
[FromGroup("TestGroup"), SerializeField]
List<ElementConfig> directList = new List<ElementConfig>();
    
[FromGroup("TestGroup"), SerializeField]
ElementConfig[] directArray = new ElementConfig[] {};
    
//Nested List & Array also works
[SerializeField] List<ElementConfigData> nestedDropdownList = new List<ElementConfigData>();
[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.

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!☕

Phun,
phun.peeticharoenthum@gmail.com