ParagonSubsystemDrawer

Odin property drawer that renders a ParagonSubsystem using UI Toolkit. Displays the subsystem's IParagonComponent collection as a list of expandable toolbox elements with add/remove workflow, right-click context menus, and configurable display delegates.

Definition

Namespace: Paragon.Editor Assembly: Paragon.Editor.dll

[DrawerPriority(DrawerPriorityLevel.SuperPriority)]
[UxmlTemplate("ParagonSubsystemElement")]
public class ParagonSubsystemDrawer : ParagonVisualElementDrawer<ParagonSubsystem>

Inheritance: OdinValueDrawer<ParagonSubsystem> → ParagonDrawer<ParagonSubsystem> → ParagonVisualElementDrawer<ParagonSubsystem> → ParagonSubsystemDrawer

Remarks

This drawer replaces the default Odin property drawing for ParagonSubsystem with a fully custom UI Toolkit-based layout:

1. Toolbox container — A collapsible Toolbox with an "+" add button in the header.

2. Component elements — Each IParagonComponent is rendered as a ParagonComponentElement (nested class) with its own collapsible toolbox, remove button, and context menu.

3. Type filtering — GetSupportedComponentTypes() queries TypeCache for all concrete types implementing IParagonComponent<TOwner> that are not already present in the subsystem.

4. MonoBehaviour handling — Components that are MonoBehaviours are added as actual Unity components on the owner's GameObject and hidden from the default Inspector (HideFlags.HideInInspector).

The drawer is configured with DrawerPriorityLevel.SuperPriority to ensure it takes precedence over other drawers, and uses [UxmlTemplate("ParagonSubsystemElement")] for its UXML layout.

Quick Lookup

Goal	How
Customize component display names	Set drawer.NameGetter = type => "..."
Customize component ordering	Set drawer.PriorityGetter = type => priority
Customize component icons	Set drawer.IconGetter = type => ParagonIconType.X
Control remove button availability	Set drawer.CanBeRemovedGetter = type => bool

Properties

Configuration Delegates

Field	Type	Default	Description
NameGetter	Func<Type, string>	ObjectNames.NicifyVariableName(type.Name)	Returns the display name for a component type
PriorityGetter	Func<Type, int>	null (no ordering)	Returns the sort priority for a component type
IconGetter	Func<Type, ParagonIconType>	null (defaults to LAYERS)	Returns the icon for a component type
CanBeRemovedGetter	Func<Type, bool>	null (defaults to true)	Returns whether a component type can be removed

Methods

OnCreateGUI (override)

Builds the UI Toolkit layout: Toolbox with add button, component container, and initial Rebuild().

protected override void OnCreateGUI()

OnInspectorGUI (override)

Checks if the subsystem reference changed and triggers a Rebuild() if so.

protected override void OnInspectorGUI()

AddComponent (private)

Adds a component of the given type to the subsystem. If the type is a MonoBehaviour, adds it to the owner's GameObject; otherwise creates it via Activator.CreateInstance.

private void AddComponent(Type type)

RemoveComponent (private)

Removes a component of the given type from the subsystem. If it's a MonoBehaviour, also DestroyImmediates the Unity component.

private void RemoveComponent(Type type)

Extension Points

Optional Overrides

Method	Purpose
OnCreateGUI()	Customize the UI Toolkit layout. Call base.OnCreateGUI() to keep default behaviour.
OnInspectorGUI()	Add per-frame IMGUI logic. Call base.OnInspectorGUI() to keep change detection.

Configuration via Delegates

The drawer's appearance and behaviour are configured by setting the public delegate fields. These are typically set by a higher-level drawer or editor that knows the domain-specific display rules:

// Example: configuring the drawer from a custom editor
drawer.NameGetter = type => type == typeof(HealthComponent) ? "Health" : type.Name;
drawer.IconGetter = type => type == typeof(HealthComponent) ? ParagonIconType.HEART : ParagonIconType.LAYERS;
drawer.CanBeRemovedGetter = type => type != typeof(RequiredComponent);
drawer.PriorityGetter = type => type == typeof(HealthComponent) ? 0 : 1;

Common Pitfalls

MonoBehaviour components hidden from Inspector When a MonoBehaviour is added as a subsystem component, its hideFlags are set to HideInInspector. The component is only visible through the subsystem's custom drawer. If the subsystem is disabled, the MonoBehaviour may remain on the GameObject but be invisible — re-enabling the subsystem will restore visibility.

Null subsystem hides the drawer When the subsystem property is null (subsystem disabled), the entire drawer is hidden via SetDisplay(false). This is expected — the drawer only renders when a subsystem is active.

See Also

• ParagonSubsystemSelector — the type picker popup opened by the add button

• ParagonBehaviourEditor — the editor that manages the subsystem lifecycle

• ParagonBehaviourContextMenu — the header menu for toggling subsystems