> For the complete documentation index, see [llms.txt](https://valex.gitbook.io/valex/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://valex.gitbook.io/valex/external/error-codes.md).

# Error Codes

### Complete Error Code List

This document provides a comprehensive reference for all error codes used in the Valex application.

***

### Error Code Format

Error codes follow the format: `0xCCSC`

* **CC**: Category Code (first 2 hex digits)
* **SC**: Subcategory/Specific Error Code (last 2 hex digits)

***

### SUCCESS (0x00XX)

| Code   | Name    | Description                      |
| ------ | ------- | -------------------------------- |
| 0x0000 | SUCCESS | Operation completed successfully |

***

### SYSTEM ERRORS (0x01XX)

| Code   | Name                                  | Description                          | Severity | Recoverable |
| ------ | ------------------------------------- | ------------------------------------ | -------- | ----------- |
| 0x0101 | SYS\_PRIVILEGE\_ELEVATION\_FAILED     | Failed to elevate process privileges | CRITICAL | No          |
| 0x0102 | SYS\_ADMIN\_REQUIRED                  | Administrator privileges required    | CRITICAL | No          |
| 0x0103 | SYS\_PROCESS\_SNAPSHOT\_FAILED        | Failed to create process snapshot    | ERROR    | Yes         |
| 0x0104 | SYS\_INSUFFICIENT\_PERMISSIONS        | Insufficient system permissions      | ERROR    | No          |
| 0x0105 | SYS\_SERVICE\_MANAGER\_ACCESS\_DENIED | Service manager access denied        | ERROR    | Yes         |
| 0x0106 | SYS\_TIME\_SERVICE\_UNAVAILABLE       | Windows Time service unavailable     | WARNING  | Yes         |
| 0x0107 | SYS\_TIME\_SYNC\_FAILED               | Time synchronization failed          | WARNING  | Yes         |
| 0x0108 | SYS\_KERNEL\_DRIVER\_MISSING          | Required kernel driver missing       | ERROR    | No          |
| 0x0109 | SYS\_UNSUPPORTED\_OS\_VERSION         | Unsupported operating system version | ERROR    | No          |
| 0x010A | SYS\_INCOMPATIBLE\_ARCHITECTURE       | Incompatible system architecture     | ERROR    | No          |
| 0x010B | SYS\_SYSTEM\_CALL\_FAILED             | System call failed                   | ERROR    | Yes         |

***

### AUTHENTICATION ERRORS (0x02XX)

| Code   | Name                          | Description                                 | Severity | Recoverable |
| ------ | ----------------------------- | ------------------------------------------- | -------- | ----------- |
| 0x0201 | AUTH\_INITIALIZATION\_FAILED  | Authentication system initialization failed | CRITICAL | Yes         |
| 0x0202 | AUTH\_INVALID\_CREDENTIALS    | Invalid license key                         | ERROR    | No          |
| 0x0203 | AUTH\_LICENSE\_INVALID        | License key is invalid                      | ERROR    | No          |
| 0x0204 | AUTH\_LICENSE\_EXPIRED        | License has expired                         | ERROR    | No          |
| 0x0205 | AUTH\_LICENSE\_SUSPENDED      | License has been suspended                  | ERROR    | No          |
| 0x0206 | AUTH\_SESSION\_EXPIRED        | Authentication session expired              | WARNING  | No          |
| 0x0207 | AUTH\_SERVER\_UNREACHABLE     | Cannot reach authentication server          | ERROR    | Yes         |
| 0x0208 | AUTH\_NETWORK\_TIMEOUT        | Authentication request timed out            | ERROR    | Yes         |
| 0x0209 | AUTH\_INVALID\_RESPONSE       | Invalid server response                     | ERROR    | Yes         |
| 0x020A | AUTH\_HWID\_MISMATCH          | Hardware ID mismatch                        | CRITICAL | No          |
| 0x020B | AUTH\_MAX\_SESSIONS\_REACHED  | Maximum concurrent sessions reached         | ERROR    | No          |
| 0x020C | AUTH\_SUBSCRIPTION\_INACTIVE  | Subscription is inactive                    | ERROR    | No          |
| 0x020D | AUTH\_RATE\_LIMIT\_EXCEEDED   | Too many authentication attempts            | WARNING  | Yes         |
| 0x020E | AUTH\_KEY\_FILE\_CORRUPTED    | License key file corrupted                  | WARNING  | Yes         |
| 0x020F | AUTH\_KEY\_FILE\_READ\_ERROR  | Failed to read key file                     | WARNING  | Yes         |
| 0x0210 | AUTH\_KEY\_FILE\_WRITE\_ERROR | Failed to write key file                    | WARNING  | Yes         |
| 0x0211 | AUTH\_VERIFICATION\_FAILED    | License verification failed                 | ERROR    | Yes         |

***

### SECURITY ERRORS (0x03XX)

| Code   | Name                                | Description                  | Severity | Recoverable |
| ------ | ----------------------------------- | ---------------------------- | -------- | ----------- |
| 0x0301 | SEC\_DEBUGGER\_DETECTED             | Debugger detected            | FATAL    | No          |
| 0x0302 | SEC\_REMOTE\_DEBUGGER\_DETECTED     | Remote debugger detected     | FATAL    | No          |
| 0x0303 | SEC\_HARDWARE\_BREAKPOINT\_DETECTED | Hardware breakpoint detected | FATAL    | No          |
| 0x0304 | SEC\_SOFTWARE\_BREAKPOINT\_DETECTED | Software breakpoint detected | FATAL    | No          |
| 0x0305 | SEC\_SUSPICIOUS\_PROCESS\_DETECTED  | Suspicious process detected  | FATAL    | No          |
| 0x0306 | SEC\_VM\_DETECTED                   | Virtual machine detected     | FATAL    | No          |
| 0x0307 | SEC\_VM\_ARTIFACT\_DETECTED         | VM artifact detected         | FATAL    | No          |
| 0x0308 | SEC\_EXECUTION\_SLOWED              | Execution timing anomaly     | FATAL    | No          |
| 0x0309 | SEC\_MEMORY\_DUMP\_DETECTED         | Memory dump tool detected    | FATAL    | No          |
| 0x030A | SEC\_PE\_HEADER\_CORRUPTED          | PE header corrupted          | FATAL    | No          |
| 0x030B | SEC\_INTEGRITY\_CHECK\_FAILED       | Integrity check failed       | FATAL    | No          |
| 0x030C | SEC\_TAMPER\_DETECTED               | Tampering detected           | FATAL    | No          |
| 0x030D | SEC\_INJECTION\_DETECTED            | Code injection detected      | FATAL    | No          |
| 0x030E | SEC\_HOOK\_DETECTED                 | Function hook detected       | FATAL    | No          |
| 0x030F | SEC\_SANDBOX\_DETECTED              | Sandbox environment detected | FATAL    | No          |
| 0x0310 | SEC\_EMULATOR\_DETECTED             | Emulator detected            | FATAL    | No          |
| 0x0311 | SEC\_UNAUTHORIZED\_MODULE           | Unauthorized module loaded   | FATAL    | No          |
| 0x0312 | SEC\_CODE\_SIGNING\_INVALID         | Code signature invalid       | FATAL    | No          |

***

### DEPENDENCY ERRORS (0x04XX)

| Code   | Name                            | Description                  | Severity | Recoverable |
| ------ | ------------------------------- | ---------------------------- | -------- | ----------- |
| 0x0401 | DEP\_DIRECTX\_MISSING           | DirectX runtime missing      | CRITICAL | No          |
| 0x0402 | DEP\_D3DCOMPILER\_MISSING       | D3D Compiler DLL missing     | CRITICAL | No          |
| 0x0403 | DEP\_VISUAL\_RUNTIME\_MISSING   | Visual C++ Runtime missing   | CRITICAL | No          |
| 0x0404 | DEP\_DOTNET\_MISSING            | .NET Framework missing       | ERROR    | No          |
| 0x0405 | DEP\_WINDOWS\_SDK\_MISSING      | Windows SDK missing          | ERROR    | No          |
| 0x0406 | DEP\_OPENGL\_MISSING            | OpenGL library missing       | ERROR    | No          |
| 0x0407 | DEP\_VULKAN\_MISSING            | Vulkan library missing       | ERROR    | No          |
| 0x0408 | DEP\_SYSTEM\_DLL\_MISSING       | System DLL missing           | ERROR    | No          |
| 0x0409 | DEP\_VERSION\_MISMATCH          | Library version mismatch     | ERROR    | Yes         |
| 0x040A | DEP\_CORRUPTED\_LIBRARY         | Corrupted library file       | ERROR    | No          |
| 0x040B | DEP\_INCOMPATIBLE\_VERSION      | Incompatible library version | ERROR    | No          |
| 0x040C | DEP\_LIBRARY\_LOAD\_FAILED      | Failed to load library       | ERROR    | Yes         |
| 0x040D | DEP\_SYMBOL\_RESOLUTION\_FAILED | Symbol resolution failed     | ERROR    | Yes         |

***

### GAME ERRORS (0x05XX)

| Code   | Name                                | Description                | Severity | Recoverable |
| ------ | ----------------------------------- | -------------------------- | -------- | ----------- |
| 0x0501 | GAME\_NOT\_RUNNING                  | Game is not running        | ERROR    | No          |
| 0x0502 | GAME\_PROCESS\_NOT\_FOUND           | Game process not found     | ERROR    | Yes         |
| 0x0503 | GAME\_WINDOW\_NOT\_FOUND            | Game window not found      | WARNING  | Yes         |
| 0x0504 | GAME\_INVALID\_VERSION              | Invalid game version       | ERROR    | No          |
| 0x0505 | GAME\_UNSUPPORTED\_BUILD            | Unsupported game build     | ERROR    | No          |
| 0x0506 | GAME\_DATA\_MODEL\_INVALID          | Data model invalid         | WARNING  | Yes         |
| 0x0507 | GAME\_VISUAL\_ENGINE\_INVALID       | Visual engine invalid      | WARNING  | Yes         |
| 0x0508 | GAME\_PLAYERS\_INSTANCE\_NOT\_FOUND | Players instance not found | WARNING  | Yes         |
| 0x0509 | GAME\_LOCAL\_PLAYER\_NOT\_FOUND     | Local player not found     | WARNING  | Yes         |
| 0x050A | GAME\_CHARACTER\_NOT\_FOUND         | Character not found        | WARNING  | Yes         |
| 0x050B | GAME\_HUMANOID\_NOT\_FOUND          | Humanoid not found         | WARNING  | Yes         |
| 0x050C | GAME\_CAMERA\_NOT\_FOUND            | Camera not found           | WARNING  | Yes         |
| 0x050D | GAME\_WORKSPACE\_INVALID            | Workspace invalid          | WARNING  | Yes         |
| 0x050E | GAME\_PLACE\_ID\_INVALID            | Place ID invalid           | WARNING  | Yes         |
| 0x050F | GAME\_MEMORY\_READ\_FAILED          | Memory read failed         | ERROR    | Yes         |
| 0x0510 | GAME\_MEMORY\_WRITE\_FAILED         | Memory write failed        | ERROR    | Yes         |
| 0x0511 | GAME\_PATTERN\_SCAN\_FAILED         | Pattern scan failed        | ERROR    | No          |
| 0x0512 | GAME\_OFFSET\_INVALID               | Memory offset invalid      | ERROR    | No          |
| 0x0513 | GAME\_STATE\_CORRUPTED              | Game state corrupted       | ERROR    | Yes         |

***

### NETWORK ERRORS (0x06XX)

| Code   | Name                         | Description                    | Severity | Recoverable |
| ------ | ---------------------------- | ------------------------------ | -------- | ----------- |
| 0x0601 | NET\_CONNECTION\_FAILED      | Network connection failed      | ERROR    | Yes         |
| 0x0602 | NET\_TIMEOUT                 | Network request timed out      | WARNING  | Yes         |
| 0x0603 | NET\_DNS\_RESOLUTION\_FAILED | DNS resolution failed          | ERROR    | Yes         |
| 0x0604 | NET\_SSL\_HANDSHAKE\_FAILED  | SSL handshake failed           | ERROR    | Yes         |
| 0x0605 | NET\_CERTIFICATE\_INVALID    | SSL certificate invalid        | ERROR    | No          |
| 0x0606 | NET\_PROXY\_ERROR            | Proxy configuration error      | ERROR    | Yes         |
| 0x0607 | NET\_FIREWALL\_BLOCKED       | Connection blocked by firewall | WARNING  | Yes         |
| 0x0608 | NET\_NO\_INTERNET            | No internet connection         | ERROR    | No          |
| 0x0609 | NET\_SERVER\_ERROR           | Server returned error          | ERROR    | Yes         |
| 0x060A | NET\_MALFORMED\_RESPONSE     | Malformed server response      | ERROR    | Yes         |
| 0x060B | NET\_RATE\_LIMITED           | Rate limit exceeded            | WARNING  | Yes         |

***

### FILESYSTEM ERRORS (0x07XX)

| Code   | Name                    | Description               | Severity | Recoverable |
| ------ | ----------------------- | ------------------------- | -------- | ----------- |
| 0x0701 | FS\_FILE\_NOT\_FOUND    | File not found            | ERROR    | Yes         |
| 0x0702 | FS\_ACCESS\_DENIED      | File access denied        | ERROR    | No          |
| 0x0703 | FS\_DISK\_FULL          | Disk is full              | ERROR    | No          |
| 0x0704 | FS\_PATH\_TOO\_LONG     | File path too long        | ERROR    | No          |
| 0x0705 | FS\_INVALID\_PATH       | Invalid file path         | ERROR    | No          |
| 0x0706 | FS\_FILE\_CORRUPTED     | File is corrupted         | WARNING  | Yes         |
| 0x0707 | FS\_READ\_ERROR         | File read error           | WARNING  | Yes         |
| 0x0708 | FS\_WRITE\_ERROR        | File write error          | WARNING  | Yes         |
| 0x0709 | FS\_DELETE\_ERROR       | File delete error         | WARNING  | Yes         |
| 0x070A | FS\_CREATE\_DIR\_FAILED | Directory creation failed | WARNING  | Yes         |
| 0x070B | FS\_PERMISSION\_DENIED  | Permission denied         | ERROR    | No          |
| 0x070C | FS\_FILE\_IN\_USE       | File is in use            | WARNING  | Yes         |
| 0x070D | FS\_INVALID\_FORMAT     | Invalid file format       | ERROR    | No          |

***

### MEMORY ERRORS (0x08XX)

| Code   | Name                    | Description              | Severity | Recoverable |
| ------ | ----------------------- | ------------------------ | -------- | ----------- |
| 0x0801 | MEM\_ALLOCATION\_FAILED | Memory allocation failed | CRITICAL | Yes         |
| 0x0802 | MEM\_OUT\_OF\_MEMORY    | Out of memory            | CRITICAL | No          |
| 0x0803 | MEM\_INVALID\_ADDRESS   | Invalid memory address   | FATAL    | No          |
| 0x0804 | MEM\_ACCESS\_VIOLATION  | Memory access violation  | FATAL    | No          |
| 0x0805 | MEM\_PROTECTION\_FAILED | Memory protection failed | ERROR    | Yes         |
| 0x0806 | MEM\_PAGE\_FAULT        | Memory page fault        | FATAL    | No          |
| 0x0807 | MEM\_HEAP\_CORRUPTION   | Heap corruption detected | FATAL    | No          |
| 0x0808 | MEM\_STACK\_OVERFLOW    | Stack overflow           | FATAL    | No          |
| 0x0809 | MEM\_DOUBLE\_FREE       | Double free detected     | FATAL    | No          |
| 0x080A | MEM\_USE\_AFTER\_FREE   | Use after free detected  | FATAL    | No          |
| 0x080B | MEM\_BUFFER\_OVERFLOW   | Buffer overflow detected | FATAL    | No          |

***

### THREAD ERRORS (0x09XX)

| Code   | Name                         | Description                | Severity | Recoverable |
| ------ | ---------------------------- | -------------------------- | -------- | ----------- |
| 0x0901 | THR\_CREATE\_FAILED          | Thread creation failed     | ERROR    | Yes         |
| 0x0902 | THR\_JOIN\_FAILED            | Thread join failed         | ERROR    | Yes         |
| 0x0903 | THR\_DETACH\_FAILED          | Thread detach failed       | ERROR    | Yes         |
| 0x0904 | THR\_DEADLOCK\_DETECTED      | Deadlock detected          | CRITICAL | No          |
| 0x0905 | THR\_MUTEX\_LOCK\_FAILED     | Mutex lock failed          | ERROR    | Yes         |
| 0x0906 | THR\_CONDITION\_TIMEOUT      | Condition wait timeout     | WARNING  | Yes         |
| 0x0907 | THR\_SYNCHRONIZATION\_ERROR  | Synchronization error      | ERROR    | Yes         |
| 0x0908 | THR\_CONTEXT\_SWITCH\_FAILED | Context switch failed      | ERROR    | Yes         |
| 0x0909 | THR\_PRIORITY\_SET\_FAILED   | Thread priority set failed | WARNING  | Yes         |
| 0x090A | THR\_AFFINITY\_SET\_FAILED   | Thread affinity set failed | WARNING  | Yes         |

***

### CONFIG ERRORS (0x0AXX)

| Code   | Name                       | Description                 | Severity | Recoverable |
| ------ | -------------------------- | --------------------------- | -------- | ----------- |
| 0x0A01 | CFG\_INIT\_FAILED          | Configuration init failed   | ERROR    | Yes         |
| 0x0A02 | CFG\_LOAD\_FAILED          | Configuration load failed   | WARNING  | Yes         |
| 0x0A03 | CFG\_SAVE\_FAILED          | Configuration save failed   | WARNING  | Yes         |
| 0x0A04 | CFG\_PARSE\_ERROR          | Configuration parse error   | WARNING  | Yes         |
| 0x0A05 | CFG\_INVALID\_VALUE        | Invalid configuration value | WARNING  | Yes         |
| 0x0A06 | CFG\_MISSING\_KEY          | Missing configuration key   | WARNING  | Yes         |
| 0x0A07 | CFG\_SCHEMA\_MISMATCH      | Schema mismatch             | WARNING  | Yes         |
| 0x0A08 | CFG\_CORRUPTED             | Configuration corrupted     | WARNING  | Yes         |
| 0x0A09 | CFG\_VERSION\_INCOMPATIBLE | Incompatible config version | WARNING  | Yes         |
| 0x0A0A | CFG\_VALIDATION\_FAILED    | Validation failed           | WARNING  | Yes         |

***

### GRAPHICS ERRORS (0x0BXX)

| Code   | Name                             | Description                      | Severity | Recoverable |
| ------ | -------------------------------- | -------------------------------- | -------- | ----------- |
| 0x0B01 | GFX\_DEVICE\_CREATION\_FAILED    | Graphics device creation failed  | CRITICAL | No          |
| 0x0B02 | GFX\_CONTEXT\_CREATION\_FAILED   | Graphics context creation failed | CRITICAL | No          |
| 0x0B03 | GFX\_SWAPCHAIN\_CREATION\_FAILED | Swapchain creation failed        | CRITICAL | No          |
| 0x0B04 | GFX\_SHADER\_COMPILATION\_FAILED | Shader compilation failed        | ERROR    | Yes         |
| 0x0B05 | GFX\_BUFFER\_CREATION\_FAILED    | Buffer creation failed           | ERROR    | Yes         |
| 0x0B06 | GFX\_TEXTURE\_LOAD\_FAILED       | Texture load failed              | WARNING  | Yes         |
| 0x0B07 | GFX\_RENDER\_TARGET\_INVALID     | Render target invalid            | ERROR    | Yes         |
| 0x0B08 | GFX\_VIEWPORT\_INVALID           | Viewport invalid                 | WARNING  | Yes         |
| 0x0B09 | GFX\_DRIVER\_CRASH               | Graphics driver crash            | CRITICAL | No          |
| 0x0B0A | GFX\_OUT\_OF\_VRAM               | Out of video memory              | WARNING  | Yes         |
| 0x0B0B | GFX\_UNSUPPORTED\_FORMAT         | Unsupported graphics format      | ERROR    | No          |
| 0x0B0C | GFX\_PRESENT\_FAILED             | Frame present failed             | ERROR    | Yes         |

***

### LUA ERRORS (0x0CXX)

| Code   | Name                        | Description               | Severity | Recoverable |
| ------ | --------------------------- | ------------------------- | -------- | ----------- |
| 0x0C01 | LUA\_INIT\_FAILED           | Lua initialization failed | ERROR    | Yes         |
| 0x0C02 | LUA\_SCRIPT\_LOAD\_FAILED   | Script load failed        | WARNING  | Yes         |
| 0x0C03 | LUA\_SYNTAX\_ERROR          | Lua syntax error          | WARNING  | No          |
| 0x0C04 | LUA\_RUNTIME\_ERROR         | Lua runtime error         | WARNING  | Yes         |
| 0x0C05 | LUA\_STACK\_OVERFLOW        | Lua stack overflow        | ERROR    | Yes         |
| 0x0C06 | LUA\_MEMORY\_ERROR          | Lua memory error          | ERROR    | Yes         |
| 0x0C07 | LUA\_TYPE\_ERROR            | Lua type error            | WARNING  | No          |
| 0x0C08 | LUA\_API\_ERROR             | Lua API error             | WARNING  | Yes         |
| 0x0C09 | LUA\_ENVIRONMENT\_CORRUPTED | Lua environment corrupted | ERROR    | Yes         |
| 0x0C0A | LUA\_LIBRARY\_MISSING       | Lua library missing       | WARNING  | Yes         |

***

### GENERIC ERRORS (0xFFXX)

| Code   | Name             | Description             | Severity | Recoverable |
| ------ | ---------------- | ----------------------- | -------- | ----------- |
| 0xFF00 | UNKNOWN\_ERROR   | Unknown error occurred  | ERROR    | Yes         |
| 0xFF01 | GENERIC\_FAILURE | Generic failure         | ERROR    | Yes         |
| 0xFF02 | NOT\_IMPLEMENTED | Feature not implemented | WARNING  | No          |
| 0xFF03 | INTERNAL\_ERROR  | Internal error          | ERROR    | Yes         |

***
