Reference · Diagnostics
Diagnostic codes
Every problem the engine reports has a stable code. Each page lists common causes and fixes; in a project,
ara why ARA1302 explains one against your own files.- ARA_GPU_BACKENDGPU backend failure
- ARA_GPU_CONTRACTGPU API contract broken
- ARA_GPU_ENVIRONMENTGPU environment message
- ARA_GPU_EXTERNALShared GPU surface unavailable
- ARA_GPU_FOREIGN_LOADInvalid GPU timing reading
- ARA_GPU_METAL_COOK_SKIPPEDMetal shaders were not cooked
- ARA_GPU_STALE_HANDLEStale GPU handle
- ARA_GPU_VALIDATIONVulkan validation message
- ARA-EXP-AND-001Android SDK unavailable
- ARA-EXP-AND-002Android NDK unavailable
- ARA-EXP-AND-003Android resource tool missing
- ARA-EXP-AND-004Android target platform missing
- ARA-EXP-AND-005Java runtime unavailable
- ARA-EXP-AND-006Bundletool unavailable
- ARA-EXP-AND-007Android signing setup incomplete
- ARA-EXP-AND-008Android Rust targets missing
- ARA-EXP-AND-009Android device verification unavailable
- ARA-EXP-AND-010Android NativeAOT cache incomplete
- ARA-EXP-AND-011Android device tool missing
- ARA-EXP-AND-013Invalid Android API settings
- ARA-EXP-AND-014Invalid Android package ID
- ARA-EXP-AND-015Android signing alias empty
- ARA-EXP-AND-016Android alignment tool missing
- ARA-EXP-AND-017APK signing tool missing
- ARA-EXP-AND-018JDK signing tools missing
- ARA-EXP-AND-020Invalid plugin manifest
- ARA-EXP-AND-021Unsupported plugin manifest content
- ARA-EXP-AND-022Conflicting plugin permission
- ARA-EXP-AND-023Invalid Android ZIP input
- ARA-EXP-AND-024ELF load alignment invalid
- ARA-EXP-AND-025Android package manifest missing
- ARA-EXP-AND-026APK native library alignment invalid
- ARA-EXP-AND-027APK content pack alignment invalid
- ARA-EXP-AND-028App bundle configuration missing
- ARA-EXP-AND-029Emulator verification not enabled
- ARA-EXP-AND-100Android export stage failed
- ARA-EXP-APL-001Mac agent unconfigured
- ARA-EXP-APL-002Apple export integration unavailable
- ARA-EXP-APL-003Invalid Mac SSH destination
- ARA-EXP-APL-004Mac agent capability mismatch
- ARA-EXP-APL-005SSH client unavailable
- ARA-EXP-APL-100Apple export stage failed
- ARA-EXP-APPIMAGE-001AppImage runtime pin missing or unavailable
- ARA-EXP-APPIMAGE-002AppImage runtime has the wrong format
- ARA-EXP-APPIMAGE-003AppImage payload verification failed
- ARA-EXP-BRG-001Bridge I/O failed
- ARA-EXP-BRG-002Bridge WebSocket failed
- ARA-EXP-BRG-003Invalid bridge JSON
- ARA-EXP-BRG-004Invalid bridge server configuration
- ARA-EXP-BRG-005Bridge protocol version mismatch
- ARA-EXP-BRG-006Bridge authentication failed
- ARA-EXP-BRG-010Renderer screenshot hook unavailable
- ARA-EXP-BRG-011Simulation input hook unavailable
- ARA-EXP-BRG-012Semantic scene hook unavailable
- ARA-EXP-BRG-013Capture trigger hook unavailable
- ARA-EXP-BRG-014Invalid bridge input action
- ARA-EXP-BRG-015GPU timing hook unavailable
- ARA-EXP-BRG-020Device bridge operation invalid
- ARA-EXP-CLI-001Export CLI command failed
- ARA-EXP-CLI-002Doctor platform conflicts with preset
- ARA-EXP-COOK-001Runtime content cooking stalled
- ARA-EXP-CRASH-001Invalid crash configuration
- ARA-EXP-CRASH-002Crash upload not authorized
- ARA-EXP-CRASH-003Crash upload unavailable or failed
- ARA-EXP-CRASH-004Native crash monitor unavailable
- ARA-EXP-CRASH-005Matching debug symbols unavailable
- ARA-EXP-CRASH-006Invalid crash artifact
- ARA-EXP-CRASH-007DWARF stripping tool unavailable
- ARA-EXP-DIST-001Package format conflicts with the preset
- ARA-EXP-DIST-002Distribution contains unsupported file paths
- ARA-EXP-ELF-001Invalid ELF image
- ARA-EXP-ELF-002ELF architecture mismatch
- ARA-EXP-INSTALL-001Invalid installer image or payload
- ARA-EXP-INSTALL-002Unsafe installer archive entry
- ARA-EXP-INSTALL-003Installer archive exceeds its expansion limits
- ARA-EXP-INSTALL-004Installation destination already exists
- ARA-EXP-INSTALL-005Installer stub pin missing or unavailable
- ARA-EXP-INSTALL-006Destination is not an Ara installation
- ARA-EXP-INSTALL-007Ara programs are running from the installation
- ARA-EXP-INSTALL-008Replacing the installation failed and was rolled back
- ARA-EXP-INSTALL-009Rollback failed during replacement
- ARA-EXP-INSTALL-010Installation registration failed
- ARA-EXP-LNX-005Linux Rust target missing
- ARA-EXP-LNX-006Pinned Zig linker unavailable
- ARA-EXP-LNX-007Linux linker wrapper missing
- ARA-EXP-LNX-008Linker option value missing
- ARA-EXP-LNX-010glibc requirement exceeds baseline
- ARA-EXP-LNX-011Linux ReadyToRun cache missing
- ARA-EXP-LNX-012Optional symbol tool missing
- ARA-EXP-LNX-100Linux export stage failed
- ARA-EXP-LNX-105No exported ELF images
- ARA-EXP-OUT-001Output directory unavailable
- ARA-EXP-PACK-001Invalid content pack
- ARA-EXP-PACK-002Pack encryption key unavailable
- ARA-EXP-PACK-003Pack filesystem operation failed
- ARA-EXP-PACK-004Pack manifest conversion failed
- ARA-EXP-PRE-001Export schema identity missing
- ARA-EXP-PRE-002Mobile requires NativeAOT
- ARA-EXP-PRE-003Invalid pack chunk size
- ARA-EXP-PRE-004Invalid assembly stem
- ARA-EXP-PRE-005Invalid plugin library stem
- ARA-EXP-PRE-006Project path escapes root
- ARA-EXP-SDK-001.NET 10 SDK unavailable
- ARA-EXP-SDK-002Rust toolchain unavailable
- ARA-EXP-SDK-003Cargo unavailable
- ARA-EXP-SIGN-001Invalid Windows signing configuration
- ARA-EXP-SIGN-002Authenticode signing tool unavailable
- ARA-EXP-SIGN-003Signing certificate reference unavailable
- ARA-EXP-TOOL-001External tool failed
- ARA-EXP-TOOL-002External tool timed out
- ARA-EXP-TPL-001Template tuple mismatch
- ARA-EXP-TPL-002Invalid template hash
- ARA-EXP-TPL-003Required template pin missing
- ARA-EXP-TPL-004Template hash mismatch
- ARA-EXP-TPL-005Player template contract mismatch
- ARA-EXP-VER-001Runtime result missing
- ARA-EXP-VER-002Runtime verification failed
- ARA-EXP-VER-003Script exception containment failed
- ARA-EXP-VER-004Device result timed out
- ARA-EXP-VER-005Device runtime process missing
- ARA-EXP-VER-010Verification capability unavailable
- ARA-EXP-WIN-001MSVC locator missing
- ARA-EXP-WIN-002MSVC toolchain not found
- ARA-EXP-WIN-003Windows NativeAOT cache missing
- ARA-EXP-WIN-004Windows Rust target missing
- ARA-EXP-WIN-010External Windows signing unconfigured
- ARA-EXP-WIN-100Windows export stage failed
- ARA0001Unity API or convention
- ARA0100Mutable static state
- ARA0101Behaviour field without transient marker
- ARA0200Non-deterministic simulation code
- ARA0300Allocation on the tick path
- ARA0400NativeAOT unsafe API
- ARA0500API outside module allowlist
- ARA0501File system access
- ARA0502Network access
- ARA0503Reflection or dynamic code
- ARA0504Threads, locks or tasks
- ARA0505Native interop
- ARA0506Process or environment access
- ARA0701Type must be partial
- ARA0702Unsupported system parameter
- ARA0703Reflected declaration needs documentation
- ARA0704Unsupported schema representation
- ARA0705Invalid command shape
- ARA0706Invalid behaviour declaration
- ARA0707Invalid system method
- ARA0900C# compilation failed
- ARA0901C# compiler warning
- ARA0902Module exceeds soft size cap
- ARA0903Module exceeds reload size target
- ARA0904Compile server unavailable
- ARA0905Runtime rejected reload delta
- ARA0910System threw an exception
- ARA0911Behaviour callback threw
- ARA0912Command threw an exception
- ARA0920Module load or registration failed
- ARA0921Generated bindings are stale
- ARA0922Script runtime could not start
- ARA0923Module dependency cycle
- ARA0924Referenced module is unavailable
- ARA0925Dependency cascade failed
- ARA0926Play process restart required
- ARA0927Retired generation remains alive
- ARA0930Component has no blittable layout
- ARA0931Component layout mismatch
- ARA0932Component or resource is unknown
- ARA0933Invalid module descriptor
- ARA0934Component needs table storage
- ARA0950C# command is not registered
- ARA0951Invalid command parameters
- ARA0952Command rejected the request
- ARA0953Undo record no longer applies
- ARA0960Agent script exceeded limits
- ARA0961Agent API outside allowlist
- ARA0962Agent script failed
- ARA0963Agent worker failed
- ARA1001Invalid JSON
- ARA1002Duplicate JSON key
- ARA1003File operation failed
- ARA1101Unknown field
- ARA1102Wrong value type
- ARA1103Number outside range
- ARA1104Unknown enum variant
- ARA1105Required field missing
- ARA1106Unknown reflected type
- ARA1107Deprecated schema member
- ARA1108Alias renamed
- ARA1109Invalid type definition
- ARA1110Type name already registered
- ARA1111Invalid field path
- ARA1112Type upgrade failed
- ARA1113Data version is newer
- ARA1114Invalid keyed collection item
- ARA1115Type version upgraded
- ARA1201Unknown document schema
- ARA1202Invalid document or record ID
- ARA1203Record already exists
- ARA1204Record not found
- ARA1205Parent does not exist
- ARA1206Cyclic parent chain
- ARA1207Invalid sibling order
- ARA1208Invalid prefab root count
- ARA1209Merge conflict still unresolved
- ARA1210Type is not a component
- ARA1211Inline component on prefab instance
- ARA1212Entity reference target missing
- ARA1213Document asset ID missing
- ARA1301Malformed asset reference
- ARA1302Unresolved reference
- ARA1303Stale reference repaired
- ARA1304Reference completed
- ARA1305Wrong asset kind
- ARA1401Prefab not loaded
- ARA1402Recursive prefab dependency
- ARA1403Override target missing
- ARA1404Invalid override key
- ARA1405Removed prefab target missing
- ARA1406Entity is not a prefab instance
- ARA1501Transaction revision conflict
- ARA1502Undo would overwrite a later edit
- ARA1503Transaction already reverted
- ARA1504Transaction not found
- ARA1505No undo or redo available
- ARA1506Document not loaded
- ARA1507Invalid author identity
- ARA1601Unknown command or job
- ARA1602Invalid operation parameters
- ARA1603Required capability missing
- ARA1604Undefined batch symbol
- ARA1605Batch symbol defined twice
- ARA1606Component already present
- ARA1607Component not present
- ARA1608Wrong registry entry kind
- ARA1609Entity selector is ambiguous
- ARA1610Agent change needs a reason
- ARA1701Semantic merge conflict
- ARA1702Merge document identity mismatch
- ARA1801Invalid protocol request
- ARA1802Unknown protocol method
- ARA1803Live session not found
- ARA1804Unknown capability scope
- ARA1805Requested scope denied
- ARA1806Protocol service unavailable
- ARA1807Project token rejected
- ARA1808Invalid entity query
- ARA1809Invalid pagination cursor
- ARA1810Session checkpoint not found
- ARA1811Job handle not found
- ARA1812Session approved
- ARA1813Change cannot be reviewed
- ARA1814Document must be specified
- ARA1901Ara project not found
- ARA1902Project already exists
- ARA1903Project lock already held
- ARA1904Daemon connection failed
- ARA1905Journal recovery problem
- ARA1906Unsaved transactions recovered
- ARA1907External document change observed
- ARA1908Disk edit conflicts with memory
- ARA1909External file is invalid
- ARA1910Document deleted on disk
- ARA1911Document save failed
- ARA1912Project type definitions changed
- ARA1913Project template needs setup
- ARA1950Release signature rejected
- ARA1951Release checksum mismatch
- ARA1952Release exceeds size limit
- ARA1953Invalid release manifest or archive
- ARA1954Unsafe release URL
- ARA1955Release feed unavailable
- ARA1956GitHub release rate limit
- ARA1957Release storage operation failed
- ARA1958Release transfer cancelled
- ARA1959Hub update rolled back
- ARA2001Diagnostics dropped
- ARA2002Unreadable reported diagnostic
- ARA2010Question not understood
- ARA2011Unknown diagnostic code
- ARA2020C# reload applied
- ARA2021Reload fell back to L3
- ARA2030Frame over budget
- ARA2101Asset import failed
- ARA2102Asset source missing
- ARA2103Import worker failed
- ARA2104Asset import cancelled
- ARA2201Invalid world data
- ARA2202World cell failed to load
- ARA2203World cell not resident
- ARA2401Network operation rejected
- ARA2500Subject claimed by someone else
- ARA2501Claim already held
- ARA2502Not joined
- ARA2503Change overwritten by a concurrent edit
- ARA2504Change dropped
- ARA2505No such branch session
- ARA2506Branch session in the wrong state
- ARA2507Branch merge kept the live value
- ARA2508Replica out of sync
- ARA2509Undo left others' changes alone
- ARA2510Invalid claim subject
- ARA2511Human sessions only
- ARA2512Branch merge waits for claims
- ARA2701Player crash recorded
- ARA3100Invalid graph structure
- ARA3101Unavailable graph node
- ARA3102Invalid graph connection
- ARA3103Cyclic graph dependency
- ARA3200Material syntax error
- ARA3201Material type mismatch
- ARA3202Missing material reference
- ARA3203Invalid material domain usage
- ARA3204Material variant budget exceeded
- ARA3205Invalid material override
- ARA3206Material shader compilation failed
- ARA3207Legacy material syntax
- ARA3208Possible material text rename
- ARA3301Nothing to draw
- ARA3302Disabled or hidden
- ARA3303Zero scale
- ARA3304NaN or infinite transform
- ARA3305No mesh to draw
- ARA3306Material unusable
- ARA3307Fully transparent
- ARA3308Culled by camera mask
- ARA3309Beyond draw distance
- ARA3310No camera
- ARA3311Excluded from every pass
- ARA3312Behind every camera
- ARA3400Audio source not loaded
- ARA3401Listener beyond max distance
- ARA3402Direct path occluded
- ARA3403Bus muted
- ARA3404Voice virtualized by the voice budget
- ARA3405Source gain is zero
- ARA3406Audio graph error
- ARA3407Invalid mixer document
- ARA3408Invalid music document
- ARA3409Invalid acoustics data
- ARA3410No voice playing
- ARA3600Invalid VFX operation
- ARA3601VFX quality limit reached
- ARA3602Invalid 2D physics command
- ARA3610Invalid terrain operation
- ARA36202D command rejected
- ARA4001Markup does not parse
- ARA4002Unsupported element
- ARA4003Markup nests too deeply
- ARA4004Element without an ID
- ARA4005Duplicate element ID
- ARA4006Invalid attribute
- ARA4007Mixed text content
- ARA4008Invalid component
- ARA4010Stylesheet rule does not parse
- ARA4011Unsupported style value
- ARA4012Unknown theme token
- ARA4013Theme token cycle
- ARA4014Invalid inline style
- ARA4018Raw colour in an editor style
- ARA4020Markup edit does not apply
- ARA4030Fonts missing or invalid
- ARA4031IME composition out of order
- ARA4032Selection splits a grapheme
- ARA4040Invalid node or viewport
- ARA4041Invalid virtual list request
- ARA4042Invalid docking operation
- ARA4043Binding node missing
- ARA4044Invalid widget operation
- ARA4045Focus or capture rule violated
- ARA4046Invalid overlay layer
- ARA4050Glyph atlas request invalid
- ARA4051Invalid GPU UI resource
- ARA4052CPU reference renderer misuse
- ARA4100Box overflows its parent or the viewport
- ARA4101Text exceeds its bounds
- ARA4102Missing glyphs
- ARA4103Text uses a fallback font
- ARA4104Measured text contrast
- ARA4105Contrast cannot be measured
- ARA4106Touch target too small
- ARA4500Editor action failed
- ARA4501Thumbnail or preview failed
- ARA4502Preferences not saved
- ARA4503Engine Protocol transport stopped
- ARA4504Editor frame not rendered
- ARA4505Build or Run Build failed
- ARA4506Scene asset file missing
- ARA4507Saved layout reset
- ARA7001Physics operation failed
- ARA7100Navigation reachability result
- ARA7101NPC cannot reach its move target
- ARA7102NPC is blocked
- ARA7110Behaviour text does not parse
- ARA7111Unknown or duplicate behaviour name
- ARA7112Behaviour type mismatch
- ARA7113Unknown transition target or call
- ARA7114Plain-text rename lost an identity
- ARA7115State tree is stuck
- ARA7116Perception never fired
- ARA7117Brain has no behaviour
- ARA7300Player call failed
- ARA7301Player crashed or hung
- ARA7302Unknown play world
- ARA7303Play assets not ready
- ARA7304Playtest assertion failed
- ARA7305Invalid play request
- ARA7306Asset reimported with a newer importer
- ARA7307Embedded play surface failed
- ARA7310Model or native material unavailable in Play
- ARA7401Missing localization key
- ARA7402Obsolete localization key
- ARA7403Invalid localization data
- ARA7404Invalid locale identifier
- ARA7405Translation response rejected
- ARA7501Invalid save data
- ARA7502Save schema mismatch
- ARA7503Save authority required
- ARA7504Save storage operation failed
- ARA7505Save recovered from backup