Tri Inspector Documentation

Tri Inspector can operate in compatibility mode with Odin Inspector. In this mode, Odin handles the primary interface, but you can opt-in specific parts to be rendered by Tri Inspector using the [DrawWithTriInspector] attribute.

• Per Class: Mark a class with [DrawWithTriInspector] to render its interface using Tri Inspector.
• Per Assembly: Mark an entire assembly with [assembly:DrawWithTriInspector] to use Tri Inspector for all types within that assembly.

Tri Inspector is distributed as a Unity Package Manager (UPM) git package. To install it, add the following Git URL to your project's package manager:

https://github.com/codewriter-packages/Tri-Inspector.git

Tri Inspector automatically installs the Unity Localization package as a dependency.

If you do not want to use the full localization package, you can install a stub package instead to satisfy the dependency without the overhead:

https://github.com/codewriter-packages/Unity-Localization-Stub-for-Tri-Inspector.git

Tri Inspector includes built-in samples to demonstrate its capabilities. You can find these samples in the Unity Editor via the following menu path:

Tools/Tri Inspector/Samples

The [MaterialProperty] attribute automatically displays valid shader properties from a target Material. Supports types like Color, Float, Vector, and Texture via ShaderPropertyType.

[MaterialProperty(nameof(material))]
public string propertyName;

[MaterialProperty(nameof(material), ShaderPropertyType.Color)]
public int propertyHash;

public Material material;

Use [EnumToggleButtons] to display enum values as a row of toggle buttons instead of a standard dropdown. This works for both standard enums and [Flags] enums.

[EnumToggleButtons] public SomeEnum someEnum;
[EnumToggleButtons] public SomeFlags someFlags;

public enum SomeEnum { One, Two, Three }

[Flags] public enum SomeFlags
{
    A = 1 << 0,
    B = 1 << 1,
    C = 1 << 2,
    AB = A | B,
    BC = B | C,
}

The [Required] attribute marks a field as mandatory. You can provide a FixAction (method name) and FixActionName (display name) to allow users to automatically fix missing references via a button in the inspector.

[Required]
public Material material;

[Required(FixAction = nameof(FixTarget), FixActionName = "Assign self")]
public Transform target;

private void FixTarget()
{
    target = GetComponent<Transform>();
}

Use the [ShowInInspector] attribute to display properties in the Unity Inspector that are not normally serialized (such as private fields, read-only properties, or properties with custom getters/setters).

private float _field;

[ShowInInspector]
private bool _myToggle;

[ShowInInspector]
public float ReadOnlyProperty => _field;

[ShowInInspector]
public float EditableProperty
{
    get => _field;
    set => _field = value;
}

The [RequiredGet] attribute automatically searches for and assigns a reference during inspector interaction.

• InParents = true: Searches up the hierarchy.
• InChildren = true, IncludeSelf = false: Searches down the hierarchy excluding the current object.

[RequiredGet]
public Transform myTransform;

[RequiredGet(InParents = true)]
public Animator animator; // Search for any Animator in parents

[RequiredGet(InChildren = true, IncludeSelf = false)]
public MeshRenderer[] childrenMeshes; // Search all meshes in children

The [InlineProperty] attribute allows you to display the fields of a [Serializable] class directly within the inspector of the parent object, rather than using a foldout.

public MinMax rangeFoldout;

[InlineProperty(LabelWidth = 40)]
public MinMax rangeInline;

[Serializable]
public class MinMax
{
    public int min;
    public int max;
}