Preferences, Commands, and API

Preferences#

Open Tools > Awesome Hierarchy > Preferences... or Edit > Preferences > Awesome Hierarchy.

• Automatic icons enables component-aware icons for objects that do not have an explicit Awesome Hierarchy icon.
• Hierarchy guide lines shows parent and sibling connections beside nested objects.
• Default icon sets the initial icon for newly created or newly marked groups. Choices are Auto, None, Unity, Folder, Scene, Prefab, Settings, and Data.
• Open Shortcut Manager opens Unity's personal shortcut profile.
• Reset Preferences to Defaults restores automatic icons and guide lines to enabled and the default new-group icon to Folder.

Preferences are stored per Unity user through EditorPrefs. Changing the default group icon does not modify existing groups or project metadata.

GameObject menu commands#

The GameObject > Awesome Hierarchy menu and the Hierarchy context menu provide:

• Create Empty Group.
• Create Group From Selection.
• Edit Group....
• Mark as Group.
• Remove Group Mark.

Commands are enabled only when the current selection and editor session support the requested operation.

Tools menu commands#

• Refresh Groups reloads group and object metadata from the loaded scenes and their sidecar files.
• Copy Group Setup From Scene... copies compatible group registrations to another saved scene.
• Welcome opens compatibility diagnostics and links to documentation and preferences.
• Documentation opens the searchable in-editor manual and changelog.
• Preferences... opens Awesome Hierarchy user preferences.

Shortcut Manager commands#

• Awesome Hierarchy/Create Empty Group - default Alt+G.
• Awesome Hierarchy/Create Group From Selection - default Alt+Shift+G.
• Awesome Hierarchy/Remove Group Mark - default Alt+U.
• Awesome Hierarchy/Open Object Menu - default Alt+E.
• Awesome Hierarchy/Remove Note - default Alt+N.

Editor API surface#

Awesome Hierarchy is compiled into the editor-only assembly PaperLynxStudio.AwesomeHierarchy.Editor under the namespace with the same name. It adds no runtime assembly and no runtime component.

Version 1.0 intentionally does not expose a supported API for mutating groups, appearance records, notes, filters, or sidecar files. Types marked internal are implementation details and may change between releases.

The public window helpers are available for editor tooling that only needs to open Awesome Hierarchy UI:

using PaperLynxStudio.AwesomeHierarchy.Editor;

AwesomeHierarchyWelcomeWindow.Open();
AwesomeHierarchyDocumentationWindow.Open();
AwesomeHierarchyDocumentationWindow.OpenGettingStarted();
AwesomeHierarchyDocumentationWindow.OpenKnownLimitations();
AwesomeHierarchyDocumentationWindow.OpenChangelog();

These calls open editor windows and do not modify scenes or Awesome Hierarchy project metadata.