Appearance
Settings and diagnostics
Open Project Settings > Plugins > Auralis Register System. These project-wide settings use Game config (DefaultGame.ini). Participant settings are separate per-component values.
Project settings
| Setting | Default | Effect |
|---|---|---|
| Log Mutations | Off | Log successful registrations on LogAuralisRegisterSystem. |
| Broadcast Blueprint Events | On | Enable Added, Removed, and Updated events for Blueprint and native listeners. |
| Reject Template Objects | On | Reject class default objects and archetypes. |
| Allow Engine Scope World Objects | Off | When enabled, allow world-owned objects in the process-wide registry. |
| Validate After Mutation | Off | Check internal indexes after mutations in non-Shipping builds. |
| Unfiltered Query Warning Threshold | 1024 | Warn when an unfiltered query scans at least this many live entries; zero disables this warning. |
Rejected registrations can log warnings even when Log Mutations is off. Enable verbose diagnostics deliberately while investigating a problem, then return to settings appropriate for your project.
Developer console commands
The DeveloperTool module exposes the following commands in a non-Shipping editor session:
text
Auralis.rs.Dump world
Auralis.rs.Stats world
Auralis.rs.Validate world
Auralis.rs.Compact world
Auralis.rs.Rebuild worldThe scope argument accepts world (default), game / gameinstance, local / localplayer, and engine. Use a running gameplay world for World-scope checks.
Registry diagnostics
| Operation | Result |
|---|---|
| Get Stats | Live/object/struct/free-slot and index-bucket counts; approximate allocated memory. |
| Build Debug Dump | Text listing, optionally query-filtered. |
| Validate | Check slots, free list, live counts, and indexes. |
| Compact Invalid Objects | Remove stale object slots. |
| Rebuild Indexes | Compact stale objects, then reconstruct indexes. |
| Get Registry Debug Info | A library helper returning text for a custom debug widget. |
A diagnostic count is not a performance benchmark. Queries already skip dead objects; compaction is explicit maintenance and can broadcast removals when events are enabled.
See Blueprint guide for event handling and Troubleshooting for targeted checks.