NaughtyAttributes

You can install NaughtyAttributes using the OpenUPM registry via the openupm-cli.

openupm add com.dbrizov.naughtyattributes

Add the following entry to your Unity manifest.json file to install the package via Git.

"com.dbrizov.naughtyattributes": "https://github.com/dbrizov/NaughtyAttributes.git#upm"

Most attributes use Unity's CustomPropertyDrawer and work in custom editors. However, meta attributes and certain drawer attributes (ReorderableList, Button, ShowNonSerializedField, and ShowNativeProperty) will NOT work in standard custom editors.

To make all attributes work in your custom editors:

1. Inherit from NaughtyInspector.
2. Use NaughtyEditorGUI.PropertyField_Layout instead of EditorGUILayout.PropertyField.

Most NaughtyAttributes are implemented using Unity's CustomPropertyDrawer, meaning they will work automatically in your custom editors.

However, if you want all attributes to work within a custom editor, you must:

1. Inherit your editor from NaughtyInspector.
2. Use NaughtyEditorGUI.PropertyField_Layout instead of EditorGUILayout.PropertyField to layout your fields.

NaughtyAttributes can be installed in your Unity project using one of the following three methods:

1. Via OpenUPM CLI (Recommended): Use the openupm-cli to add the package.

2. Via Git URL: Add the following entry to your manifest.json file:

3. Via Unity Asset Store: Download the package directly from the Asset Store.

Provides a dropdown interface to select an input axis.

public class NaughtyComponent : MonoBehaviour
{
	[InputAxis]
	public string inputAxis;
}

Use [EnableIf("fieldName")] or [DisableIf("fieldName")] to enable or disable a field in the Inspector based on the value of another field, property, or method.

You can also use logical operators by providing an EConditionOperator and multiple field names.

Supported operators via EConditionOperator:

• EConditionOperator.And (all conditions must be true)
• EConditionOperator.Or (any condition must be true)

public class NaughtyComponent : MonoBehaviour
{
	public bool flag0;
	public bool flag1;

	[EnableIf(EConditionOperator.And, "flag0", "flag1")]
	public int enabledIfAll;

	[EnableIf(EConditionOperator.Or, "flag0", "flag1")]
	public int enabledIfAny;
}

Use the [Required] attribute to visually remind developers that a reference type field must be assigned. You can provide a custom error message string: [Required("Custom message")].

public class NaughtyComponent : MonoBehaviour
{
	[Required]
	public Transform myTransform;

	[Required("Custom required text")]
	public GameObject myGameObject;
}

Displays a progress bar in the inspector. Requires a label string, a max value, and an EColor.

public class NaughtyComponent : MonoBehaviour
{
	[ProgressBar("Health", 300, EColor.Red)]
	public int health = 250;

	[ProgressBar("Mana", 100, EColor.Blue)]
	public int mana = 25;

	[ProgressBar("Stamina", 200, EColor.Green)]
	public int stamina = 150;
}

Makes ScriptableObject fields expandable directly within the inspector.

public class NaughtyComponent : MonoBehaviour
{
	[Expandable]
	public ScriptableObject scriptableObject;
}

Provides a dropdown interface to select a Sorting Layer. Can be used for string (layer name) or int (layer ID) fields.

public class NaughtyComponent : MonoBehaviour
{
	[SortingLayer]
	public string layerName;

	[SortingLayer]
	public int layerId;
}