Onex Base changelog
3 releases since 13 Jan 2026 · latest 1.37.0
1.37.0
Latest11 May 202636 viewsNew1
- getClosest ped lookup now supports an optional model filter, allowing you to target only peds of a specific model when finding the nearest ped to a player.
Improved1
- Vehicle info resolution now uses a unified lookup across all supported frameworks, improving consistency and reliability when retrieving vehicle data regardless of which framework your server runs.
Fixed6
- Fixed an issue in qb-inventory weight checks where the per-unit item weight was not being read correctly, which could allow players to carry more than the configured limit.
- Fixed a vehicle info lookup that could fail or return incorrect results when a vehicle model was passed as a number instead of a string.
- Vehicle license plates are now consistently normalized to the standard padded 8-character format at the point they enter the system, preventing mismatches when looking up or storing plate data.
- Fixed script version checking so that the resource name is handled case-insensitively, preventing false update warnings when the resource folder name uses different capitalisation.
- Increased the timeout for resource scanning during initialisation, resolving cases where servers with a large number of resources could fail to complete startup checks.
- Fixed client-side restricted commands not passing permission checks correctly, meaning players who should have had access were incorrectly blocked from using those commands.
Files changed12
adapters/inventory/config/1 file
- qb-inventory.lua
config/framework/esx/1 file
- methods.lua
config/framework/qb/1 file
- methods.lua
config/framework/qbx/1 file
- methods.lua
packages/addCommand/2 files
- client.lua
- server.lua
packages/getClosest/1 file
- client.lua
resource/modules/utilities/1 file
- server.lua
resource/modules/vehicles/3 files
- client.lua
- server.lua
- shared.lua
1.35.1
26 Mar 202624 viewsBefore you update
Breaking change
Clothing adapter parameter key changed from appearance to `data`
Breaking change
openCharacterCreation renamed to `openFirstCharacterMenu` in clothing adapter
Breaking change
Packages moved from packages/ to adapters/ — adapter wrapper packages (notify, fuel, vehicleKeys, target, progressBar) relocated
New19
- Adapter system overhaul — adapters now self-register with lazy-loading and escrow protection, reorganized into
adapters/directory with per-script config files - New appearance/clothing adapter with methods for ESX, QBCore, and QBX frameworks — supports applying skins to non-player peds (ESX)
- New multichar adapter for framework-agnostic character selection management
- Zone system ultra-optimization — GLM native polygon containment, grid-based spatial partitioning for O(1) queries, idle CPU optimization when no zones active
- Global cache system (
ocache) exposed to external resources via loader — per-resource live values with automatic polling - Server-side vehicle management — vehicle info retrieval, plate generation, and advanced vehicle spawning with unified StateBag system
- Client-side vehicle module for spawn handling, property management, and vehicle information retrieval
- Local weather/time override — client-side API using FiveM natives for per-player weather and time control
- Streaming request now supports audio bank request and cleanup functions
- Broken FiveM artifact detection on startup — warns if your server artifact has known issues
getClosestPlayerrenamed to `getClosest` — now also supports ped and vehicle lookup- Added `gradeName` field to job schema across all frameworks
- Standalone mode now auto-triggers
playerLoadedevents without a framework - Added `isFirst` argument to the unified player loaded event
- Framework-aware progress bar detection system with new adapter configs
- Added rcore_clothing adapter support
- Added qbx_vehiclekeys native adapter to bypass bridge delays
- ESX framework events (
load/unload) are now optional in framework config - Package loading system reorganized into hybrid, isolated, and shared categories with escrow protection
Improved5
- ESX logout and character deletion logic simplified
- Cache inlined into loader for per-resource live values
- VehicleKeys centralized RPC method registration and configuration retrieval
- Zones migrated debug checks to convar system and removed unused GLM fallbacks
- Renamed
openCharacterCreationtoopenFirstCharacterMenuin clothing adapter
Fixed22
Fixed crypto import collision with FiveM's globalThis.crypto — now uses named import .
It fixed base error with latest fivem artifacts . Here is the following error that was causing : [ c-scripting-core] Creating script environments for onex-base [ script:onex-base] Error loading script dist/server.js in resource onex-base: TypeError: Cannot set property crypto of [object global] which has only a getter [ script:onex-base] stack: [ script:onex-base] TypeError: Cannot set property crypto of [object global] which has only a getter [ script:onex-base] at @onex-base/dist/server.js:3:74612 [ c-scripting-core] Failed to load script dist/server.js.
Fixed ESX gender comparison using wrong type (number vs string)
Fixed ESX character session cleanup and removed deprecated multichar spawn logic
Fixed ESX character slot extraction from identifier for onPlayerJoined event
Fixed QBX character login return logic
Fixed QBCore job/duty event source extraction
Fixed gender normalization in player data for QBCore and Qbox
Fixed QBX license validation compatibility
Fixed adapter config loading for late-detected resources on onResourceStart
Fixed adapter nil-safety checks and improved error handling across all adapters
Fixed MySQL delete operations and outfit column retrieval error handling
Fixed vehicleDamage adapter config loading using unified loader
Fixed qs-vehiclekeys removeKeys adapter passing hash instead of mode
Fixed progressBar ox_lib export call and normalized disable parameters
Fixed illenium-appearance config for character creation
Fixed qb-spawn apartment detection and simplified adapter logic
Fixed framework detection race condition between Qbox and QBCore using ordered detection
Fixed hot-reload and resource detection issues in adapter system
Fixed addCommand to use same-resource RPC calls instead of cross-resource
Fixed player login handling simplification for QBCore methods
Fixed cache removing coords from client polling loop to avoid unnecessary updates
Fixed isolated package environment to use correct globals (_ENV instead of _G)
Files changed27
adapters/12 files
- clothing/
- drawText/
- fuel/
- inventory/
- notify/
- progressBar/
- spawn/
- target/
- vehicleDamage/
- vehicleKeys/
- vehicleProperties/
- weather/
config/2 files
- adapters/
- framework/
dist//1 file
- server.js
loader.lua/1 file
- loader.lua
packages/7 files
- _rpc/
- _cache/shared.lua
- _require/shared.lua
- zones/
- getClosest/client.lua
- weather/shared.lua
- streamingRequest/client.lua
resource/4 files
- modules/players/
- modules/vehicles/
- core/
- api/shared.lua
1.20.1
13 Jan 202614 viewsBefore you update
Config file
Check config/config.lua
Added licenseType option for player license, added useProxy option for late-loading adapters Copy your settings across instead of overwriting the file.
New7
- Added server-side vehicle info system for getting vehicle details
- Added universal proxy system for adapters that load after onex-base
- Added support for MrNewbVehicleKeys adapter
- Added configurable license type for player license retrieval
- Added job duty update event handling
- Added cache invalidation for resource updates
- Auto-sync vehicle properties after spawn
Fixed11
- Fixed adapter queued operations not working correctly
- Fixed qs-vehiclekeys not working properly
- Fixed cron jobs breaking after resource restart
- Fixed inventory item metadata not passing correctly for ox_inventory
- Fixed inventory useable item callback data format
- Fixed box zone debug visualization
- Fixed ESX gender values not showing correctly
- Fixed job duty event not detecting duty status properly
- Fixed server events not receiving player source correctly
- Fixed clothing appearance not applying correctly
- Fixed default license type config
Files changed3
config/1 file
- config.luaHas your settings
config/adapters/2 files
- vehicleKeys.lua
- inventory.lua