Onex Base changelog

3 releases since 13 Jan 2026 · latest 1.37.0

1.37.0Latest
1 new6 fixed1 improved
11 May36 views

New1

  • 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

fxmanifest.lua
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 views
19 new22 fixed5 improved3 breaking27 files

Before 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
  • getClosestPlayer renamed to `getClosest` — now also supports ped and vehicle lookup
  • Added `gradeName` field to job schema across all frameworks
  • Standalone mode now auto-triggers playerLoaded events 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 openCharacterCreation to openFirstCharacterMenu in 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 views
7 new11 fixed3 files

Before 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