Browse docs

Changelog

Full change history for sky_base.

Aug 22, 2026

CurrentAug 22, 2026

Version 1.36.0

Highlights

Added native duty management across ESX, QBCore, and Qbox so duty changes and on-duty counts use the active framework consistently.
Added automatic MSK Garage and MSK Fuel integrations plus Quasar license support through qs-licenses.
Added shared database select and update operations while making transactions explicitly reliable through oxmysql.

Notable Changes

Improved Jobs Creator duty synchronization so QB-based servers accept confirmed framework results and ESX servers can change duty without a separate workaround.
Fixed an issue where Jobs Creator job-list injection could be rejected before shared jobs became available.
Improved MSK vehicle handling so garage storage, plate changes, vehicle keys, and model lookup continue to work when the original network entity is unavailable.
Fixed an issue where RxBilling could reject valid invoices without a player source and corrected Groot billing so personal-to-society invoices use the intended invoice type.
Fixed an issue where ox_inventory capacity prechecks could disagree with the inventory's own item insertion result.
Fixed an issue where player-directory queries could fail when ESX identifier columns used different database collations.

Other Changes

Improved framework logout handling so client and server player state unloads consistently across supported ESX flows.
Improved housing-provider startup ordering so its shared callback registers only after the Base callback runtime is ready.
Improved migration recovery so restarting a resource cannot reuse a stale completed migration state.
Updated the Base selector documentation with explicit msk garage and fuel choices plus the quasar license choice without changing the shipped "auto" defaults.

Changed Files

sky_base/config/billing/groot.lua
sky_base/config/billing/rxbilling.lua
sky_base/config/config.lua
sky_base/config/framework/esx.lua
sky_base/config/framework/qb.lua
sky_base/config/framework/qbox.lua
sky_base/config/fuel/msk.lua
sky_base/config/garage/msk.lua
sky_base/config/housing/_init.lua
sky_base/config/inventory/ox.lua
sky_base/config/license/main.lua
sky_base/config/license/quasar.lua
sky_base/config/locales/*
sky_base/config/vehiclekeys/msk.lua
sky_base/fxmanifest.lua
sky_base/source/* — delete and reinsert

Update InstructionsA guided update for server owners1.35.11.36.0

Phase 1 of 5

Prepare

Before updating, stop the server and back up the complete sky_base resource plus intentional edits below config/framework, config/billing, config/fuel, config/garage, config/inventory, config/license, and config/vehiclekeys.

Install 1.36.0 as one clean package. Its adapters, manifest, shared runtime, and source files must stay on the same version.

Phase 2 of 5

Replace files

Delete and reinsert the complete resource. At minimum replace fxmanifest.lua, the complete source and config/locales directories, every listed changed adapter, and add config/fuel/msk.lua, config/garage/msk.lua, and config/license/quasar.lua.

Phase 3 of 5

Merge config

/jobconfig is not applicable to sky_base; all Base settings remain plaintext file values. Start from the new config/config.lua.

Config path	`1.35.1`	`1.36.0` shipped value / action
`Config.garage`	`"auto"`	Still `"auto"`; the selector comment adds the explicit option `"msk"`
`Config.license`	`"auto"`	Still `"auto"`; the selector comment adds the explicit option `"quasar"`
`Config.fuel`	`"auto"`	Still `"auto"`; the selector comment adds the explicit option `"msk"`

The executable defaults therefore remain:

config/config.lua

Config.garage = "auto"
Config.license = "auto"
Config.fuel = "auto"

Use Config.garage = "msk" only with msk_garage on ESX. The shipped adapter maps land, boat, and aircraft storage to A, boat_A, and heli_A; preserve or deliberately adapt those identifiers in config/garage/msk.lua. Use Config.fuel = "msk" only with msk_fuel. Use Config.license = "quasar" only with qs-licenses; the license catalogue continues to come from Config.Licenses.catalog, and granting a Quasar license requires the target player to be online.

Phase 4 of 5

SQL & items

No SQL migration or Base-owned inventory item, image, or stream asset is required. New integrations are delivered as provider adapters. Sky.DB.Select and Sky.DB.Update are available to dependent resources, while Sky.DB.Transaction now rejects mysql-async instead of reporting unreliable transaction success.

Phase 5 of 5

Restart & test

The console reports sky_base 1.36.0 before dependent resources start.
ESX, QBCore, or Qbox duty changes and on-duty counts match the active framework state.
Jobs Creator duty changes settle on the framework-confirmed result.
The selected MSK Garage, MSK Fuel, or Quasar license provider starts before Base and completes its core operation.
MSK Garage can store, retrieve, re-plate, and re-key a vehicle even after the original entity is gone.
RxBilling and Groot create the intended invoice type and ox_inventory accepts or rejects items through its own result.
Player logout and relogin clears and rebuilds framework state without stale migration state.
oxmysql database select, update, and transaction calls complete successfully; mysql-async is not used for transactions.

Aug 18, 2026

Version 1.35.1

Highlights

Changed framework duty handling back to the established provider-specific behavior after the temporary shared duty-index implementation.

Notable Changes

Changed QBCore duty updates to use QBCore directly while Jobs Creator counts continue to use its active provider state.
Changed Qbox duty updates and counts to use the native qbx_core paths.
Changed ESX Base duty handling back to its established contract where duty setters are no-ops and Base duty counts return no native on-duty players.

Other Changes

Removed the temporary shared duty-index runtime and its startup state from the Base package.

Changed Files

sky_base/config/framework/esx.lua
sky_base/config/framework/qb.lua
sky_base/config/framework/qbox.lua
sky_base/config/locales/*
sky_base/fxmanifest.lua
sky_base/source/* — delete and reinsert

Update InstructionsA guided update for server owners1.35.01.35.1

Phase 1 of 5

Prepare

Stop the server and back up the complete Base resource plus intentional edits under config/framework.

Install 1.35.1 as one clean package; its framework adapters, manifest, and source runtime must match.

Phase 2 of 5

Replace files

Delete and reinsert the resource. Replace config/framework/esx.lua, qb.lua, qbox.lua, fxmanifest.lua, config/locales, and source completely. Remove any old source/server/framework/duty_index.lua left by 1.35.0.

Phase 3 of 5

Merge config

/jobconfig is not applicable to Base. No executable public config value changed in 1.35.1.

Phase 4 of 5

SQL & items

No SQL, Base-owned inventory item, image, stream asset, or provider secret changed.

Phase 5 of 5

Restart & test

The console reports Base 1.35.1 before dependent resources start.
QBCore and Qbox duty changes/counts reflect their framework or active Jobs Creator state.
ESX-dependent code does not assume Base provides a native duty mutation/count in this patch.
The removed duty-index file is not loaded by the manifest.

Aug 17, 2026

Version 1.35.0

Highlights

SD phone and tablet support - SD Phone can now provide phone numbers, apps, messages, notifications, number lookup, and tablet apps through the shared Base interface.
More provider choices - CDN Fuel is supported, and OP Garages automatically selects its compatible V2 or V3 adapter from the installed version.
More reliable shared callbacks - the shipped callback wait limit doubles to ten seconds, reducing false timeouts on slower servers without changing callback results.

Notable Changes

Phone notification adapters now return a consistent success result, and LB Phone notifications can still be delivered when the phone resource starts after Base.
Jobs Creator duty changes on QB/Qbox use the confirmed framework result and reject client-forged reconciliation events.
Ped interactions can play configured animations before their action runs.
mysql-async recognizes whitespace-prefixed and multi-line read queries, including SHOW, DESCRIBE, and EXPLAIN.
Missing JSON resource files now return a clear diagnostic instead of failing without context.

Other Changes

Database migrations inherit the active database character set and collation.
The Base update link now points to the current documentation location.
OP Garages safely keeps the legacy adapter when its version metadata is missing or invalid.

Changed Files

sky_base/config/config.lua
sky_base/config/framework/qb.lua
sky_base/config/framework/qbox.lua
sky_base/config/fuel/cdn.lua
sky_base/config/garage/op.lua
sky_base/config/garage/op_v3.lua
sky_base/config/locales/*
sky_base/config/phone/d.lua
sky_base/config/phone/esx.lua
sky_base/config/phone/lb-unique.lua
sky_base/config/phone/lb.lua
sky_base/config/phone/qb.lua
sky_base/config/phone/sd.lua
sky_base/config/tablet/sd.lua
sky_base/fxmanifest.lua
sky_base/source/* — delete and reinsert

Update InstructionsA guided update for server owners1.34.01.35.0

Phase 1 of 5

Prepare

Stop the server. Back up the complete sky_base resource and any intentional edits below config/framework, config/fuel, config/garage, config/phone, and config/tablet.

Install 1.35.0 as one clean package. Its adapters, manifest, shared runtime, and source files must stay on the same version.

Phase 2 of 5

Replace files

Delete and reinsert the complete resource. At minimum replace fxmanifest.lua, the complete source and config/locales directories, all changed phone/framework adapters, and add config/fuel/cdn.lua, config/garage/op_v3.lua, config/phone/sd.lua, and config/tablet/sd.lua. Keep the updated config/garage/op.lua together with op_v3.lua.

Phase 3 of 5

Merge config

/jobconfig is not applicable to sky_base; all Base settings remain plaintext file values. Start from the new config/config.lua.

Config path	`1.34.0`	`1.35.0` shipped value / action
`Config.defaultCallbackTimeout`	`5000`	`10000` milliseconds
`Config.phone`	`"auto"`	Still `"auto"`; new explicit option `"sd"`
`Config.tablet`	`"default"`	Still `"default"`; new options `"auto"` and `"sd"`
`Config.fuel`	`"auto"`	Still `"auto"`; new explicit option `"cdn"`
`Config.garage`	Existing selector	No value change; `"op"` now selects a V2/V3-compatible adapter

Apply the changed runtime default when manually merging:

config/config.lua

Config.defaultCallbackTimeout = 10000

With Config.tablet = "auto", SD is recognized from a started sd-tablet; SD tablet operations use sd-phone exports, so start both resources. Use Config.fuel = "cdn" only with cdn-fuel. OP Garages V3 requires its V3 metadata; missing or invalid metadata intentionally keeps the legacy adapter.

Phase 4 of 5

SQL & items

No SQL migration or Base-owned inventory item, image, or stream asset is required. Database schemas created by Base now inherit the database administrator's charset and collation.

Phase 5 of 5

Restart & test

The console reports sky_base 1.35.0 before dependent resources start.
Slow but valid callbacks can complete inside the new 10000 ms limit.
The selected phone and tablet provider can register an app and deliver a notification.
SD tablet mode has both sd-tablet and sd-phone started.
CDN Fuel reads and writes fuel when Config.fuel = "cdn".
Config.garage = "op" stores and retrieves a vehicle on the installed OP V2 or V3 release.
QB/Qbox Jobs Creator duty changes settle on the framework-confirmed state.
A missing JSON resource file writes a useful English diagnostic and returns cleanly.

Aug 12, 2026

Version 1.34.0

Highlights

Unified voice-radio bridge - PMA Voice, SaltyChat, and YACA now expose one shared radio interface with automatic provider selection.
Expanded economy integrations - DevMosaic and Retro banking plus STG Wallet v2 licenses are added, while STG Vanaheim Fuel auto-detection now targets the correct resource and supports explicit "stg-van" selection.
Event-driven duty indexing - ESX, QBCore, and Qbox duty lookups now use synchronized server state instead of repeatedly scanning every connected player, including functional ESX duty changes.

Notable Changes

Numeric PMA radio channels remain numeric; provider-native start/end clicks are configurable, and local plus remote transmit activity is synchronized without echoing a player's own peer event.
SaltyChat traffic state and YACA behavior now match the shared radio contract.
JackSam Billing uses the correct player recipient type and falls back to the target identifier when no sender is supplied; RxBilling sends sender and target in the correct order and derives a stable sender for source-less requests.
Retro Billing is detected explicitly and reports that invoice creation is unsupported instead of selecting an invalid billing path.
Usable items fall back to framework registration when the selected inventory adapter does not implement registration itself.
ox_inventory item-count updates now reach the shared inventory-updated event on Qbox and standalone ox_inventory setups.
The tablet selector now ships as "default" instead of "auto", keeping the bundled Jobs Base tablet as the initial system; "lb" and "roadpad" remain deliberate opt-in values.
The default interaction mode changed from automatic target detection to markers and help notifications; servers can still opt into "auto" or a named target provider.
The event ping ceiling increased from 1000 to 5000 milliseconds for high-latency players.
Currency formatting can override the displayed symbol without changing the selected currency or account.

Other Changes

Streamer-mode enable/disable, reward receipt, inventory-full, and invalid-command responses now follow the selected locale instead of hard-coded English text.
Italian was added as a complete Base locale. All 15 bundled locales now include localized Streamer Mode, reward, command, inventory-full, and command-validation feedback; existing Arabic, Chinese, Czech, Dutch, Finnish, French, German, Portuguese, Russian, Spanish, and Swedish wording was also corrected or clarified.
Public Base documentation was updated for voice, banking, billing, licenses, duty state, currency formatting, and inventory update behavior.
Regression tests now cover event-driven duty indexing and the shared inventory-update bridge.

Changed Files

sky_base/config/banking/devmosaic.lua
sky_base/config/banking/retro.lua
sky_base/config/billing/jacksam.lua
sky_base/config/billing/retro.lua
sky_base/config/billing/rxbilling.lua
sky_base/config/config.lua
sky_base/config/framework/esx.lua
sky_base/config/framework/qb.lua
sky_base/config/framework/qbox.lua
sky_base/config/fuel/stg-van.lua
sky_base/config/inventory/ox_events.lua
sky_base/config/license/main.lua
sky_base/config/license/stg-walletv2.lua
sky_base/config/locales/*
sky_base/config/voice/_init.lua
sky_base/config/voice/pma.lua
sky_base/config/voice/saltychat.lua
sky_base/config/voice/yaca.lua
sky_base/fxmanifest.lua
sky_base/source/* — delete and reinsert

Update InstructionsA guided update for server owners1.33.01.34.0

Phase 1 of 5

Prepare

Stop the server and back up the complete sky_base folder. Save intentional changes under config/banking, config/billing, config/framework, config/fuel, config/inventory, config/license, and other provider directories separately before replacing the package. If SaltyChat is installed, also back up its external config.json.

Install 1.34.0 as one clean package. The voice adapters, duty index, inventory event bridge, manifest entries, locales, and shared runtime must come from the same build.

Phase 2 of 5

Replace files

Delete and reinsert the complete resource. At minimum, replace fxmanifest.lua, the complete source directory, every changed adapter listed under Changed Files, and the complete config/locales directory. Keep the new config/voice directory, config/inventory/ox_events.lua, config/banking/devmosaic.lua, config/banking/retro.lua, config/billing/retro.lua, and config/license/stg-walletv2.lua.

Phase 3 of 5

Merge config

/jobconfig does not manage sky_base. Start from the new config/config.lua and transfer only deliberate server-specific values.

Config path	`1.33.0`	`1.34.0` shipped value / action
`Config.voice`	Missing	`"auto"`; accepts `"none"`, `"pma"`, `"saltychat"`, and `"yaca"`
`Config.voiceRadioSounds.enabled`	Missing	`false`; enable only when provider-native clicks are wanted
`Config.voiceRadioSounds.transmitStartVolume`	Missing	`18`
`Config.voiceRadioSounds.transmitEndVolume`	Missing	`8`
`Config.tablet`	`"auto"`	`"default"`; keeps the bundled Jobs Base tablet active, while `"lb"` and `"roadpad"` are deliberate opt-ins
`Config.license`	`"auto"`	Still `"auto"`; new explicit value `"stg-walletv2"`
`Config.billing`	`"auto"`	Still `"auto"`; new explicit value `"retro"`, whose invoice creation is unsupported
`Config.fuel`	`"auto"`	Still `"auto"`; new explicit value `"stg-van"`; auto now detects `stg-vanaheimfuel` correctly
`Config.banking`	`"auto"`	Still `"auto"`; new explicit values `"devmosaic"` and `"retro"`
`Config.target`	`"auto"`	`"none"`; markers and help notifications are now the default
`Config.maxPing`	`1000`	`5000` milliseconds
`Config.locale`	Existing locale selector	Still unchanged; `"it"` is now available

Add the complete new voice configuration. The following is executable after the main Config table and avoids rebuilding that table:

config/config.lua

Config.voice = "auto"
Config.voiceRadioSounds = {
    enabled = false,
    transmitStartVolume = 18,
    transmitEndVolume = 8,
}
Config.tablet = "default"
Config.target = "none"
Config.maxPing = 5000

Config.tablet changed from "auto" to "default". Leave it at "default" so the bundled Jobs Base tablet remains the initial system. Set "lb" or "roadpad" only when intentionally opting into an installed external provider.

Auto-detection checks for a started supported voice resource, so start the chosen provider before sky_base. For SaltyChat incoming-traffic state, merge this property into the provider's existing file; do not replace the rest of its configuration:

saltychat/config.json

{
  "RequestRadioTrafficStates": true
}

Provider-native clicks should remain disabled when another radio interface already plays its own sounds. Numeric channel IDs are preserved; text channel IDs are mapped by the active provider where necessary. SaltyChat's external property is a prerequisite for incoming activity and is not managed by Base.

Replace config/locales completely. The release adds Italian. Every bundled locale now contains notifications.streamerModeTitle, enabled, disabled, rewardTitle, and commandTitle, plus commandErrors.missingParameter, tooManyParameters, mustBeNumber, cannotUseMeFromConsole, invalidPlayerId, playerNotFound, invalidPercentage, invalidSelection, and invalidBoolean. Select Italian only with Config.locale = "it".

Phase 4 of 5

SQL & items

No SQL migration or Base-owned inventory item is required. Install and start any newly selected external provider before sky_base according to that provider's own documentation. Fuel auto-detection maps stg-vanaheimfuel to "stg-van". Retro Billing cannot create invoices. The ox_inventory bridge is loaded by the new manifest and needs no additional configuration.

Aug 3, 2026

Version 1.33.0

Highlights

Unified tablet integrations - LB Tablet and RoadPad are now supported alongside the bundled Jobs Base tablet, with automatic provider selection and shared app, message, notification, and close actions.
Complete offline license handling - licenses use one selected provider consistently and can be managed by persistent identifier on the built-in standalone, ESX, QBCore, and Qbox backends.
Expanded provider compatibility - added Synz banking/billing, Vivum Target, GKSPHONE v2, JC Vehicle Keys, vehicle-model targets, and missing key-removal behavior for existing providers.
Observable callbacks and logging - callback timing statistics, rate-limited slow-callback warnings, per-level debug controls, and bounded asynchronous log output make runtime issues easier to diagnose.

Notable Changes

Runtime inventory item definitions can be added or updated through the shared framework API.
Currency formatting accepts an optional display-symbol override.
External billing adapters normalize recipients more consistently; Vivum Billing now uses framework identifiers and Quasar billing validates requests before submission.
The default target selection changed from marker-only mode to automatic target detection.
Duplicate license and housing adapter registration is prevented by deterministic manifest loading.
Blip values are normalized before reaching FiveM natives.

Other Changes

Updated the public API documentation for tablets, licenses, inventory registration, targets, callbacks, debug controls, billing, phones, and currency formatting.
Added a focused license-provider regression check and a workspace file for the frontend package manager.

Changed Files

sky_base/config/banking/synz.lua
sky_base/config/banking/tgg.lua
sky_base/config/billing/codem.lua
sky_base/config/billing/corem.lua
sky_base/config/billing/quasar.lua
sky_base/config/billing/synz.lua
sky_base/config/billing/vivum.lua
sky_base/config/config.lua
sky_base/config/framework/esx.lua
sky_base/config/license/_helpers.lua
sky_base/config/license/ak47.lua
sky_base/config/license/bit.lua
sky_base/config/license/codem.lua
sky_base/config/license/cs.lua
sky_base/config/license/custom.lua
sky_base/config/license/esx.lua
sky_base/config/license/main.lua
sky_base/config/license/papa.lua
sky_base/config/license/qb.lua
sky_base/config/license/qbox.lua
sky_base/config/license/standalone.lua
sky_base/config/license/vms.lua
sky_base/config/locales/*
sky_base/config/phone/gks.lua
sky_base/config/tablet/default.lua
sky_base/config/tablet/lb.lua
sky_base/config/tablet/roadpad.lua
sky_base/config/target/_init.lua
sky_base/config/target/custom.lua
sky_base/config/target/ox.lua
sky_base/config/target/qb.lua
sky_base/config/target/tgiann.lua
sky_base/config/target/vivum.lua
sky_base/config/vehiclekeys/jc.lua
sky_base/config/vehiclekeys/msk.lua
sky_base/config/vehiclekeys/qb.lua
sky_base/fxmanifest.lua
sky_base/source/* — delete and reinsert

Update InstructionsA guided update for server owners1.32.11.33.0

Phase 1 of 5

Prepare

Stop the server and back up the complete sky_base folder. Preserve any intentional edits under config/framework, banking, billing, garage, phone, inventory, license, target, tablet, or vehiclekeys separately.

Install 1.33.0 as a clean package. Do not overlay it on 1.32.1, because new adapters and deterministic manifest entries are required together.

Phase 2 of 5

Replace files

Replace fxmanifest.lua, source, and the complete changed provider folders. Keep the new config/tablet, config/license/qbox.lua, config/license/standalone.lua, config/target/vivum.lua, config/banking/synz.lua, config/billing/synz.lua, and config/vehiclekeys/jc.lua files.

Phase 3 of 5

Merge config

/jobconfig does not manage sky_base. Start from the new config/config.lua and transfer only intentional server values.

Config path	`1.33.0` shipped value / action
`Config.tablet`	New: `"auto"`; supported values are `"default"`, `"lb"`, and `"roadpad"`
`Config.license`	Keep `"auto"` or select one provider; new explicit values include `"standalone"` and `"qbox"`
`Config.billing`	`"auto"`; `"synz"` is now available
`Config.banking`	`"auto"`; `"synz"` is now available
`Config.target`	Changed from `"none"` to `"auto"`; use `"none"` to retain marker-only interaction, or select `"vivum"` explicitly
`Config.debug`	Still `false`; remains the legacy master switch for all log levels
`Config.debugLevels.all/debug/info/warn/error`	New: `false`, `false`, `true`, `true`, `true`
`Config.debugQueue.maxEntries/batchSize/batchDelay`	New: `1000`, `10`, `0`
`Config.defaultCallbackTimeout`	Still `5000`; this only limits the local wait and does not cancel or deduplicate server work
`Config.callbackPerformance.enabled/warningsEnabled/warningThreshold/warningCooldown`	New: `true`, `true`, `500`, `300000`

Config.Licenses.catalog remains the additional license catalogue for the selected provider and ships with firstaidcourse. Providers are not merged.

Phase 4 of 5

SQL & items

No Base SQL migration, item registration, or image copy is required. External tablet, phone, banking, billing, target, vehicle-key, and license resources must still be installed and started according to their own documentation.

Phase 5 of 5

Restart & test

The console reports sky_base 1.33.0.
The intended license provider can read and write an online license; supported providers also handle an offline identifier.
The selected tablet can open an app and receive a notification.
The configured target provider shows vehicle-model interactions at the intended vehicle.
Billing, banking, phone, inventory registration, vehicle keys, and currency display work with the selected providers.
Callback statistics and configured log levels behave as expected.
sky_jobs_base and job resources start after Base.

Jul 29, 2026

Version 1.32.1

Highlights

Safer behavior while restrained - handcuffed players can no longer use world markers, target interactions, or registered keybind actions until the restraint is removed.
Framework gang support - QBCore and Qbox gang identity and grade data are now available to compatible Sky resources, while other frameworks continue without gang data.
More reliable cross-framework duty state - ESX jobs without a native duty value now retain the framework-neutral duty fallback used by Jobs Base.

Notable Changes

ox_fuel vehicles fall back to the vehicle's native fuel level when their synchronized fuel state has not initialized yet.
Tgiann Inventory slot lookups now use the inventory's direct slot lookup for better performance.
Handcuffed state is included when shared systems decide whether player actions should be unavailable.
Gang changes from QBCore and Qbox are synchronized for dependent resources.

Other Changes

Updated the public API documentation for gang access and restrained interaction behavior.

Update InstructionsA guided update for server owners1.32.01.32.1

Phase 1 of 5

Prepare

Stop the server and create this backup before replacing files:

Back up	Safe location
Complete `sky_base` folder	Outside the live `resources` folder
Any provider adapter you intentionally customized	Separate `custom-adapters` folder

Install this patch as a clean resource replacement. Do not copy it over 1.32.0.

Phase 2 of 5

Replace files

Use the new package as the base:

Action	Current server path	New package / destination
Delete	`resources/[sky]/sky_base`	Remove only after the backup exists
Copy	—	Copy the complete new `sky_base` folder
Keep from new release	`fxmanifest.lua`, `source`, and `config/framework`	Required for restrained actions, gang data, and duty synchronization
Keep from new release	`config/fuel/ox.lua` and `config/inventory/tgiann.lua`	Required for the fuel and inventory fixes
Merge only if customized	Your provider adapters	Reapply intentional edits to the matching new adapter

Phase 3 of 5

Merge config

/jobconfig does not manage sky_base.

No executable value in config/config.lua changed between 1.32.0 and 1.32.1. Keep the new file and transfer only your existing framework/provider selections or other intentional server-specific values.

Phase 4 of 5

SQL & items

No SQL migration, inventory definition, or image installation is required.

Phase 5 of 5

Restart & test

Keep this dependency order:

server.cfg

ensure sky_base
ensure sky_jobs_base
# Start dependent Sky resources afterward.

Check the patch on a staging server:

The console reports sky_base 1.32.1.
Handcuffed players cannot use Sky interaction points, target actions, or Sky keybind actions.
Removing the restraint restores those actions.
ox_fuel vehicles report a valid fuel level immediately after spawn.
Tgiann Inventory actions still resolve the correct slot.
ESX duty state remains correct after job and duty changes.
QBCore/Qbox gang-aware dependent features receive the current gang.

Jul 27, 2026

Version 1.32.0

Highlights

Broader plug-and-play provider support - added integrations for CodeM Garage, TeamsGG Billing, Vivum Billing, Quasar Fuel Stations, x-fuel, and tgiann-target, including automatic detection.
Customizable vehicle-property handling - vehicle serialization, restoration, key handling, removal, and post-spawn behavior now live in a public configuration file so servers can adapt garage behavior without editing protected runtime files.
More complete vehicle persistence - ESX- and QB-compatible property names now preserve additional wheel, tyre, window, door, livery, color, health, and modification data when vehicles are stored and restored.
More reliable framework and provider flows - QB/Qbox character lifecycle handling, ESX progress completion, phone fallbacks, controlled vehicle deletion, and disabled interaction markers now behave consistently.

Notable Changes

Billing can pass optional human-readable source context, such as a job or speed-camera name, to supported invoice providers.
okokBilling now supports personal invoices as well as society invoices.
Vivum Billing resolves recipients through lb-phone; CodeM Garage integration supports ESX and QBCore.
Inventory results now expose normalized durability, and ps-inventory weapon transfers preserve ammunition and metadata.
Added a non-blocking database write path for resource-stop persistence.
Server callbacks can now be consumed by integrations through the documented export interface.
YSeries phone integration starts only when its matching provider is selected.

Other Changes

Updated the public API and provider documentation.
Updated the resource version to 1.32.0.

Update InstructionsA guided update for server owners1.31.01.32.0

Phase 1 of 5

Prepare

Stop the server before changing any resource files. Download sky_base 1.32.0 from the CFX Portal, then make this backup:

Back up	Safe location
Your complete current `sky_base` folder	Outside the live `resources` folder
Any provider files you customized yourself	A separate folder named `custom-adapters`

Do not copy the new release over the old folder. A clean replacement prevents deleted or renamed scripts from remaining active.

Phase 2 of 5

Replace files

Use the new download as the clean base:

Action	Current server path	New package / destination
Delete	`resources/[sky]/sky_base`	Remove only after the backup exists
Copy	—	Copy the new `sky_base` folder to `resources/[sky]/sky_base`
Keep from new release	`sky_base/fxmanifest.lua` and `sky_base/source`	Do not restore these from the backup
Merge only if customized	Your backed-up provider adapter	Apply your intentional edits to the matching new adapter

Before continuing, confirm that the new folder contains:

config/vehicle_functions.lua
the current config/billing, fuel, garage, inventory, phone, progress, and target folders
config/framework/qb.lua and config/framework/qbox.lua

Phase 3 of 5

Merge config

/jobconfig does not manage sky_base. Open the new config/config.lua and transfer only the selections you intentionally changed in the old file. The shipped executable defaults did not change.

Keep "auto" when you want automatic detection. Pin a provider only when your server deliberately uses it:

Integration	New manual value	Important requirement
CodeM Garage	`garage = "codem"`	ESX or QBCore; this adapter does not support Qbox
TeamsGG Billing	`billing = "tgg"`	Matching billing resource must start first
Vivum Billing	`billing = "vivum"`	Requires `lb-phone`
Quasar Fuel Stations	`fuel = "qs-fuelstation"`	Matching fuel resource must start first
x-fuel	`fuel = "xfuel"`	Matching fuel resource must start first
tgiann-target	`target = "tgiann"`	Or use `"auto"` to detect it

Example: change only the line for the provider you want to pin.

config/config.lua

 Config = {
-    garage = "auto",
+    garage = "codem",
     billing = "auto",
     fuel = "auto",
 }

If you customized vehicle serialization, keys, deletion, or post-spawn behavior, move those edits into the new config/vehicle_functions.lua; never restore the old source implementation.

Phase 4 of 5

SQL & items

No SQL migration and no new inventory item are required for sky_base 1.32.0.

Provider resources still need to be installed and started according to their own documentation. sky_base only supplies the integration adapters.

Phase 5 of 5

Restart & test

Keep the dependency order in server.cfg:

server.cfg

# Start your framework, SQL, inventory, and selected providers first.
ensure sky_base
ensure sky_jobs_base
# Start Sky job resources after both bases.

Complete these checks before reopening the server:

The console reports sky_base version 1.32.0.
The selected framework and inventory load without adapter errors.
One vehicle stores and restores its fuel and modifications correctly.
The configured garage, billing, phone, progress, and target integrations work.
sky_jobs_base and the installed Sky jobs start after sky_base.

Jul 23, 2026

Version 1.31.0

Highlights

Cross-framework player-state synchronization - shared death, last-stand, handcuff, and custom player states can now be read and updated consistently across ESX, QBCore, Qbox, vRP, and custom framework integrations.
Improved Jaksam Inventory compatibility - weapon transfers now use the required uppercase weapon names, slot-aware item operations are supported, metadata updates use the inventory's native flow, and usable items register correctly.
Correct ESX garage storage tables - the AK47 and BP garage adapters now use owned_vehicles on ESX while retaining player_vehicles for QB-based frameworks.
Clearer version checks - update checks are cached, can return their result through callbacks, and display more useful installed/latest version states and notices.

Notable Changes

Active text interaction prompts now update every frame while a player remains in interaction range.
QB and Qbox status handling now uses the current framework metadata APIs.
Ox Inventory item lookups handle empty count responses safely.
Custom framework templates now include the shared player-state bridge contract.

Other Changes

Updated the public API documentation for player states and version information.
Updated the resource version to 1.31.0.

Jul 20, 2026

Version 1.30.0

Highlights

Custom integration templates for every major provider type - ready-to-edit adapters are now included for frameworks, banking, billing, fuel, garages, housing, inventories, licenses, phones, progress bars, targets, and vehicle keys.
Expanded third-party compatibility - added direct support for Zyke Garages, Zyke vehicle keys, and YSeries phones, while RoadPhone custom applications are validated more reliably.
Vehicle-aware target interactions - supported target providers can register vehicle-wide and bone-specific actions, enabling precise rescue and equipment interactions.
Faster and safer database maintenance - transactions now behave atomically across supported database drivers, migration schema discovery is batched, and configured column encodings are enforced consistently.

Notable Changes

Added persistent instructional help panels for multi-action controls and status guidance.
Added framework-independent relative status removal for supported ESX, QB, and QBox setups.
Corrected RxBilling invoice arguments so invoice details reach the provider properly.
ESX job-member data now refreshes after job changes instead of retaining stale entries.
Added version caching for dependent resources and reduced repeated version lookups.
Added the missing Chinese, Spanish, French, Dutch, Polish, Serbian, and Swedish locale files.
The shipped target setting remains none, so target integrations are opt-in and servers without a target resource start safely.

Other Changes

Disabled debug mode in the shipped default configuration.
Removed obsolete internal update notes and unused banking code.
Updated the resource version to 1.30.0.

Jul 11, 2026

Version 1.29.0

Highlights

More reliable database startup - dependent resources now wait until migrations have actually completed before continuing, preventing startup races during schema updates.
Improved interactive ped appearance - peds using interaction profiles now start with their intended default component variation.

Notable Changes

Migration sequencing corrected - migration consumers no longer continue merely because a migration left the pending queue; completion is now the deciding state.
Updated default license example - the shipped license configuration now uses the first-aid course entry.

Other Changes

Updated the resource version to 1.29.0.

Jul 8, 2026

Version 1.28.0

Highlights

Expanded third-party adapter support — sky_base now adds support for pc-banking, nass_billing, stg-van, and ic3d, extending compatibility across banking, billing, fuel, and vehicle key setups.
VMS Documents v2 license support — vms_documentsv2 is now available as a license provider, giving more servers a direct license integration option.
Improved ped appearance handling — spawned peds now preserve their built-in visual variations more reliably instead of being reset to a generic look.

Notable Changes

Shared account support for pc-banking — society and shared-account flows now work with pc-banking, including auto-detection and manual selection support.
Broader auto-detection coverage — nass_billing, stg-van, and ic3d are now picked up automatically when using the standard "auto" configuration flow.
More reliable QB / QBox player lookups — invalid player identifiers are handled more cleanly, reducing bad framework-side lookup behavior in edge cases.
More tolerant query handling — database queries now behave more safely when no parameter list is passed.

Other Changes

Bone labels now use clearer skeletal naming.
Phone-related unsupported-feature logging is now more consistent.

Jul 5, 2026

Version 1.27.0

Highlights

Billing is now routed more consistently through the configured provider — sky_base no longer depends on a single framework-specific billing path and better respects the active billing setup across supported servers.
Inventory slot metadata support was expanded — more supported inventory backends can now work with direct slot-based metadata updates, improving compatibility for metadata-driven item workflows.
Arabic locale added — sky_base now ships with Arabic translations in addition to the existing language set.

Notable Changes

More consistent billing requests across providers — billing data is normalized more cleanly before being handed to the active backend, reducing provider-specific inconsistencies.
Batch-friendly framework job lookups — framework-side job-member data retrieval is now better suited for grouped lookups, improving efficiency in larger job-related flows.
Clearer ESX inventory behavior — setups using native ESX inventory now report unsupported slot/metadata behavior more clearly instead of failing ambiguously.

Other Changes

Internal shared utility code was consolidated to keep the base layer leaner and more consistent.

Jul 2, 2026

Version 1.26.0

Highlights

New license-provider layer with papa_licensecreator and bit-licenses support — sky_base now supports both systems for license handling and adds a dedicated Config.license selector, so license management can be auto-detected or pinned explicitly like the other adapter-based features.
17mov Phone custom app support — 17mov_Phone is now supported as a phone backend for custom Sky phone apps, app messaging, and phone notifications.
Faster streamed interaction NPC handling — interaction peds now spawn more efficiently in larger setups, reducing visible delays when multiple nearby NPCs need to appear.

Notable Changes

More reliable license granting on QB / QBox — license assignment now works correctly even for players who do not already have existing license entries.
Clearer ESX license behavior — ESX setups without a running license backend now report the problem cleanly, making license-related setup issues easier to identify.
Fallback license catalog — sky_base now supports a configurable fallback license list so license UIs remain usable on providers that do not expose their own catalog.
Optional papa_licensecreator item handout — license grants can now also hand out the matching physical license item when using papa_licensecreator.
More reliable okokPhone custom apps — custom phone apps registered through okokPhone now consistently use the correct owning resource.
Quieter ESX diagnostics by default — ESX-specific job debug logs now respect debug mode properly, reducing unnecessary console noise on production servers.
New NPC streaming throttle setting — Config.streamNpcMaxSpawnsPerPass lets you control how many streamed interaction NPCs may spawn in a single pass.

Other Changes

Existing license handling is now more consistent across supported frameworks and providers.

Download sky_base from the CFX Portal.
Create a backup.
Replace the /source folder.
Replace /fxmanifest.lua (version 1.26.0).
Replace the /config/framework folder (license handling and ESX logging behavior updated).
Replace the /config/phone folder (new 17mov.lua; okokPhone custom app handling updated).
Add the new /config/license folder.
In config/config.lua, add the new license selector and the new streamed-NPC option:

+license = "auto", -- auto, esx (esx_license), qb (metadata), cs (cs_license), ak47 (ak47_idcardv2), codem (codem-wallet), papa (papa_licensecreator), bit (bit-licenses) - can be customized in config/license
+streamNpcMaxSpawnsPerPass = 4, -- max number of streamed interaction NPCs to spawn in one streaming pass; higher values reduce visible spawn delay for groups

In config/config.lua, add the new fallback license configuration:

Config.Licenses = {
    catalog = {
        { type = "driver", label = "Driver License" },
        { type = "weapon", label = "Weapon License" },
        { type = "business", label = "Business License" },
    },
    papaGiveItem = false,
}

Adjust the catalog entries to match the license ids used by your active license system if needed. Set papaGiveItem = true only if you want papa_licensecreator grants to also hand out the physical item. 10. If you keep your existing config/config.lua, review debug as well — the new default is false. 11. No SQL migration required.

Jun 29, 2026

Version 1.25.0

Highlights

Built-in default notification & help-prompt UI — sky_base now ships its own on-screen notification and "Press E" help-prompt UI, replacing the bare native GTA notifications. Notifications support a type/colour (info, success, error, warn) and a custom duration, for a consistent look across every Sky resource out of the box.
New phone integrations: RoadPhone, okokPhone, and qs-smartphone V3 — all three are now supported phone backends, auto-detected and selectable via Config.phone. okokPhone and RoadPhone also support custom phone apps and app notifications through the existing phone bridge.
Inventory layer rebuilt, clean adapter style — one focused file per inventory under config/inventory/, a shared normalization layer, and a single set of fallbacks. Adapters are smaller and consistent, and the framework files shrank substantially.
New inventory support: core_inventory, origen_inventory, jpr-inventory — auto-detected and selectable via Config.inventory = "core", "origen", or "jpr".
Framework-native inventory is the default — when no standalone inventory is detected, the framework's own inventory (ESX/QBCore/Qbox/VRP) is used and fully driven by the framework. Pin it explicitly with Config.inventory = "esx" | "qb" | "qbox" | "vrp".
Richer inventory API — stashes, shops, trunk and vehicle-plate helpers are now exposed through the bridge for inventories that support them, and report cleanly as unsupported otherwise.

Notable Changes

okokPhone adapter — phone-number lookups, custom app registration, and notifications now route through okokPhone. Auto-detected when Config.phone = "auto", or pin it with "okok".
qs-smartphone V3 adapter — Quasar's smartphone V3 is now a supported phone backend, auto-detected or selectable with Config.phone = "qs".
roadphone adapter — RoadPhone is detected and prioritised when Config.phone = "auto"; custom RoadPhone apps are supported (RoadPhone registers custom apps statically, so a custom app returns a config.json entry).
codem banking now uses framework-native banking — the dedicated codem banking adapter has been removed. Config.banking = "codem" now resolves to your framework's own banking backend (qb on QBCore, renewed on Qbox, esx otherwise) and logs an informational note. No action needed for Config.banking = "auto".
New vehicle-key providers — added AK47 vehicle keys (Config.vehiclekeys = "ak47") and jc_vehiclekeys (alias Config.vehiclekeys = "jota"), both auto-detected.
DS-ServerCreator garage detection — DS-ServerCreator is now auto-detected as a garage backend and added to the garage value list (ds-servercreator).
ESX legacy shared-object loading — sky_base now resolves the ESX shared object through both the modern export and the legacy esx:getSharedObject path, so it no longer aborts when the export is briefly unavailable during a server restart. This prevents dependent resources (e.g. sky_mechanicjob) from losing usable-item handling after a full restart.
Configurable interaction marker draw buffer — new Config.interactionDrawBuffer controls the extra range beyond interactionDistance where markers are rendered and tracked, for finer control over marker visibility.
Czech locale — added Czech (cz) translations.
All inventory logic now lives under config/inventory/. Framework-native inventory moved into config/inventory/native/<framework>.lua; the config/framework/<framework>.lua files now contain framework logic only and are much smaller. The active inventory is selected once and routed to a single adapter — no more per-function resource branching.
New Sky.FW inventory functions: RegisterStash, OpenStash, ClearStash, AddStashItems, OpenPlayerInventory, RegisterShop, OpenShop, AddTrunkItems, UpdatePlate, plus helpers GetResourceName, GetPlayerInventory, GetItemBySlot, GetItemInfo, StripPNG, StripWebp. When the active inventory does not support a feature, the call logs an English debug line and returns false.
⚠️ AddItem / RemoveItem signature changed — both are now (source, item, amount, slot, metadata). The legacy force argument is removed and an optional slot is added at position 4 (RemoveItem can target a specific slot, then metadata-match, then any). All Sky resources (police / ambulance / mechanic / jobs_base) are already migrated. External resources that called Sky.FW.AddItem(src, item, amount, force, metadata) with a force boolean, or Sky.FW.RemoveItem(src, item, amount, metadata) with metadata at position 4, must update to the new argument positions. All other inventory/weapon functions keep their names, signatures, and return shapes (RemoveItem still returns the number removed).
EmmyLua annotations — every Sky.FW inventory function now carries ---@param/---@return documentation.
Inventory read caching for every inventory — HasItem (short TTL), the item catalog, and item labels are now cached uniformly across all inventories (previously framework-native only), cutting repeated export calls. Sky.FW.InvalidateItemCountCache(source, itemName?) clears the HasItem cache.
Consistent metadata matching & slot normalization across every adapter, resolving subtle differences between inventories in metadata-filtered lookups.

Other Changes

Removed the automatic +1.0 Z offset on type-1 interaction markers — markers now draw at their configured coordinates, while explicit per-marker offsets still apply.
Removed config/banking/codem.lua — codem banking now maps to the framework-native banking backend.
Removed config/inventory/{esx,qb,qbox,vrp}.lua — framework-native inventory now lives under config/inventory/native/.
Auto-detection registers core_inventory, origen_inventory, and jpr-inventory; origen is preferred over ox when both are present.

Download sky_base from the CFX Portal.
Create a backup.
Replace the /source folder (includes the new built-in notification UI files).
Replace /fxmanifest.lua (version 1.25.0; loads the notification UI page and the rebuilt inventory layer).
Replace the /config/framework folder (inventory logic removed from each framework file; ESX legacy shared-object fix).
Replace the /config/functions.lua file (new default notification & help-prompt UI).
Replace the /config/phone folder (new roadphone.lua; okok.lua, qs.lua updated for okokPhone and qs-smartphone V3).
Replace the /config/vehiclekeys folder (new ak47.lua, jota.lua).
Replace the /config/banking folder and delete the old config/banking/codem.lua if you keep customized files (codem now uses framework-native banking).
Replace the /config/locales folder (new cz.lua).
Replace the /config/inventory folder — it now holds the per-inventory adapters plus a new native/ subfolder. Delete the old config/inventory/esx.lua, qb.lua, qbox.lua, and vrp.lua if you keep customized files (their logic moved to config/inventory/native/).
In config/config.lua, update the value-list comments:

-phone = "auto", -- auto, esx, qb, d, gks, lb, lb-unique, yseries, codem, roadphone
+phone = "auto", -- auto, esx, qb, qs, d, gks, lb, lb-unique, yseries, codem, okok, roadphone
-garage = "auto", -- auto, esx, qb, qbox, quasar, okok, jg, cd, bp, my, vms, op - can be customized in config/garage
+garage = "auto", -- auto, esx, qb, qbox, quasar, okok, jg, cd, bp, my, vms, op, ds-servercreator - can be customized in config/garage
-vehiclekeys = "auto", -- auto, qb, vehicles_keys, mrnewb, mk, quasar, wasabi, msk, brutal, kiminaze - can be customized in config/vehiclekeys
+vehiclekeys = "auto", -- auto, qb, vehicles_keys, mrnewb, mk, quasar, wasabi, msk, brutal, kiminaze, ak47, jota - can be customized in config/vehiclekeys
-inventory = "auto", -- auto, esx, qb, qbox, vrp, ox, qs, ps, codem, tgiann, jaksam, ak47, one, hex - can be customized in config/inventory
+inventory = "auto", -- auto, esx, qb, qbox, vrp, ox, qs, ps, codem, tgiann, jaksam, ak47, one, core, origen, jpr, hex - can be customized in config/inventory

Config.phone, Config.garage, Config.vehiclekeys, and Config.inventory all default to "auto" and pick up the new adapters automatically — set a specific value only to pin one manually. To tune marker draw range, add interactionDrawBuffer (optional):

+interactionDrawBuffer = 20.0, -- extra range beyond interactionDistance where markers are drawn and tracked

If you call Sky.FW.AddItem / Sky.FW.RemoveItem from your own resources: update the 4th argument — it is now slot (not force). Replace a force boolean with nil, and for RemoveItem move metadata to the 5th position (RemoveItem(src, item, amount, nil, metadata)). Sky's bundled job resources are already updated.
No SQL migration required.

Jun 25, 2026

Version 1.24.0

Highlights

New one_inventory support — auto-detected and selectable via Config.inventory = "one". Item, metadata, slot, and weapon handling all route through one_inventory.
New codem banking backend — auto-detected and selectable via Config.banking = "codem". Job/society balances are read and updated through codem banking, with an automatic fallback to your framework's banking when needed.
Custom phone apps — sky_base can now register custom phone apps and push app notifications through the active phone adapter (currently lb, codem, and roadphone), so dependent resources can surface their own phone UI and alerts.
Streamed interaction NPCs — interaction-point peds now spawn and despawn based on player proximity, lowering the client entity count and improving performance on maps with many NPCs. Controlled by Config.streamNpcEnabled (set false for the previous "always spawned" behaviour).

Notable Changes

one_inventory adapter — adds config/inventory/one.lua and registers one_inventory in auto-detection. Config.inventory = "auto" picks it up automatically; set "one" to pin it.
codem banking adapter — adds config/banking/codem.lua. Auto-detection recognises codem banking and prefers it when present, resolving the correct backend and ensuring job accounts exist on first use.
Custom phone app exports — exports["sky_base"]:RegisterCustomPhoneApp(app), exports["sky_base"]:SendCustomPhoneAppMessage(identifier, data), and exports["sky_base"]:SendPhoneAppNotification(data) are available for supported phone adapters. RoadPhone custom apps return a config.json entry because RoadPhone registers custom apps statically.
Interaction NPC streaming options — new Config.streamNpcDistance (range a player must be within for an NPC to exist) and Config.streamNpcRefreshMs (how often the streaming pass re-evaluates distances) tune the new behaviour.
Database index management — Sky.DB.Migrate now ensures declared indexes are present on already-existing tables, creating plain indexes asynchronously in the background so startup is not blocked. A new Sky.DB.EnsureIndex utility adds an index or unique key to an existing table; it is idempotent and safe to call on tables sky_base does not own. Unique keys are applied only when a table is first created, to avoid failures on pre-existing data.
Standardized job-member lists — Sky.FW.GetJobUsers now includes each member's name on ESX, QBCore, and QBox, removing a separate name lookup per member (faster boss menus).
ESX weapon name normalization — weapon names passed to ESX are now consistently upper-cased, preventing case-sensitivity failures on weapon add, remove, and possession checks.
Ordered resource auto-detection — when several running resources could map to the same config option, detection now follows a defined priority order instead of an arbitrary one.

Other Changes

Removed the dedicated hex inventory bridge — with Config.inventory = "hex", sky_base now uses the configured framework's own inventory functions instead of a separate adapter file.
Interaction NPCs are now cleaned up on resource restart, preventing orphaned peds.
Optimized marker interaction handling for interaction points.

Download sky_base from the CFX Portal.
Create a backup.
Replace the /source folder.
Replace /fxmanifest.lua (version 1.24.0).
Replace the /config/phone folder (all phone adapters updated for custom phone app support).
Replace the /config/framework folder (esx.lua, qb.lua updated).
Replace the /config/inventory folder — adds the new one.lua and deletes the removed hex.lua (delete the old config/inventory/hex.lua if you keep customized files).
Replace the /config/banking folder (new codem.lua).
In config/config.lua, update the phone/inventory/banking value-list comments and add the new NPC-streaming options:

-phone = "auto", -- auto, esx, qb, d, gks, lb, lb-unique, yserie, codem
+phone = "auto", -- auto, esx, qb, d, gks, lb, lb-unique, yseries, codem, roadphone
-inventory = "auto", -- auto, esx, qb, qbox, vrp, ox, qs, ps, codem, tgiann, jaksam, ak47, hex - can be customized in config/inventory
+inventory = "auto", -- auto, esx, qb, qbox, vrp, ox, qs, ps, codem, tgiann, jaksam, ak47, one, hex - can be customized in config/inventory
-banking = "auto", -- auto, sky, crm, qs, okok, bablo, fd, rx, tgg, kartik, esx, qb, renewed, wasabi, groot, ak47, jaksam - can be customized in config/banking
+banking = "auto", -- auto, sky, crm, codem, qs, okok, bablo, fd, rx, tgg, kartik, esx, qb, renewed, wasabi, groot, ak47, jaksam - can be customized in config/banking
+streamNpcEnabled = true, -- only spawn interaction-point NPC peds while the player is within streamNpcDistance (set false for legacy: peds exist everywhere at once)
+streamNpcDistance = 100.0, -- range a player must be within for an interaction NPC ped to exist; despawns past streamNpcDistance + 20%
+streamNpcRefreshMs = 1000, -- how often (ms) the streaming pass re-evaluates ped distances when no point is in interaction range

Config.phone = "auto", Config.inventory = "auto", and Config.banking = "auto" pick up the new adapters automatically — set "roadphone", "one", or "codem" only to pin them manually. 10. No SQL migration required.

Jun 22, 2026

Version 1.23.0

Highlights

Fixed usable items on vRP — Sky.FW.RegisterUsableItem now registers and executes the supplied callback through the vRP inventory API. Required items such as the job tablet work correctly even when their alternative radial-menu entry point is disabled.
Safer RTX Housing integration — the rtx_housing adapter now handles missing or invalid property data without causing runtime errors.

Notable Changes

vRP usable-item callbacks — registered items now receive a Use action that forwards the player source and item data through the shared callback contract.
vRP tablet access — players carrying the configured tablet item can open it from their inventory when Config.Tablet.enabled and Config.Tablet.requireItem are enabled, without depending on Config.JobRadial.enabled.
RTX Housing property guard — the adapter verifies that property is a table before accessing property.doors. Nil and non-table values return early, preventing runtime errors in config/housing/rtx.lua.

Other Changes

vRP no longer creates registered usable items without an executable action.

Jun 18, 2026

Version 1.22.0

Highlights

codem-wallet license integration for ESX — codem-wallet is now supported as a primary license-management system. The shared Sky.FW license functions can correctly read and manage player licenses on ESX servers that use codem-wallet, extending framework compatibility.
Unified job-cache synchronization across frameworks — ESX, QBCore, and QBox client job-change events now explicitly notify the server through the centralized sky_base:updateJob flow. This keeps the server-side player job cache current while reducing duplicated framework-specific synchronization logic.

Notable Changes

QBCore / QBox job updates — QBCore:Client:OnJobUpdate now triggers sky_base:updateJob on the server, ensuring job changes immediately refresh the shared server-side player cache.
Streamlined ESX job updates — the client-side esx:setJob handler now triggers the centralized server update directly, removing the need for separate server-side esx:setJob and sky_base:updateJob listeners to perform the same cache refresh.
External job-cache invalidation — added a dedicated event listener that invokes the centralized player job-cache update logic. External resources can therefore request a cache refresh even when the normal esx:setJob event is not fired.
Predictable ESX duty values — Sky.FW.GetJobData now consistently returns false for duty status when the underlying ESX framework does not define an onDuty field. Duty checks therefore always receive a boolean instead of sometimes receiving nil.
VMT lightbar vehicle-property restore — saved modLightbar values are now reapplied to vehicle modification slot 49. Lightbar selections captured in vehicle properties persist correctly through garage spawning, mechanic tuning saves, and other Sky.Vehicle:SetVehicleProperties restore flows.

Other Changes

Older vehicle-property payloads without modLightbar remain compatible.
Job synchronization behavior is now more consistent between ESX, QBCore, and QBox.

Jun 15, 2026

Version 1.21.0

⚠️ You MUST replace the `/config/framework` folder

Many servers keep their customized framework files and skip this folder on updates — do not skip it this time. The job & duty security hardening and the new caching live in esx.lua / qb.lua / qbox.lua. If you keep the old framework files, the cache stays vulnerable and job/duty state will be out of sync. Merge any custom edits into the new files instead of keeping the old ones.

Security update — this release hardens the player job & duty cache. After updating sky_base, also update sky_jobs_base and every Sky job resource (sky_ambulancejob, sky_policejob, sky_mechanicjob) to their matching releases so job and duty state stays in sync. See Update Instructions.

Highlights

Security — hardened player job & duty cache. Job and duty changes are now resolved server-side directly from your framework instead of trusting data sent by the client. This protects the cache that every Sky job script relies on to authorize on-duty actions. Requires the matching sky_jobs_base update.
Performance — comprehensive data caching. Inventory data (item lists, labels, and item-possession checks) and job-member lists are now cached across ESX, QBCore, and Qbox, sharply reducing repeated database queries and inventory/export calls for noticeably better responsiveness on busy servers.
bcs_companymanager banking & billing support — auto-detected when Config.banking = "auto" / Config.billing = "auto", or pin it with "companymanager". Shared company balances and bill sending now route through bcs_companymanager. Updated value lists.

Notable Changes

ESX duty no longer reset on a cache refresh — on standard ESX (which has no native duty field) an on-duty player was being flipped off whenever the cache refreshed; duty state is now preserved.
Multi-character logout clears the cache server-side (QBCore / Qbox) — switching characters no longer leaves the previous character's job cached until the next login.
More reliable Qbox player loading — the correct player is now identified on load and license checks are guarded, so a missing player record or license no longer throws an error.
Faster boss menus on QBCore & Qbox — member lists now include character names directly, removing a separate database lookup for each offline member.
ESX job-grade sync — when a job definition is updated, its ESX job grades are now refreshed so grade changes apply without a restart.
Consistent gender detection — gender is now compared as strings across all frameworks, preventing mismatches between stored string and numeric values.
More robust admin-command permissions — admin commands are now wired to both FiveM's native restricted-command system and Sky's own permission checks for more reliable gating.
RTX Housing dispatch fix — corrected the coordinates sent for dispatch, fixing wrong locations for the ambulance job.
tgiann inventory — fixed an item label display issue.

Other Changes

ESX item-possession checks now aggregate stacked items correctly when no metadata is specified.
ESX job-grade salaries are no longer overwritten when a job definition is updated — a salary is only applied when the grade is first created.

Download sky_base from the CFX Portal.
Create a backup.
Replace the /source folder.
Replace the /fxmanifest.lua (version 1.21.0).
⚠️ REQUIRED — replace the /config/framework folder (esx.lua, qb.lua, qbox.lua). This is not optional for this release, even if you normally keep your customized framework files. The job & duty security hardening, data caching, gender detection, and boss-menu member names all live here — merge any custom edits into the new files rather than keeping the old ones.
Replace the /config/banking folder (new companymanager.lua).
Replace the /config/billing folder (new companymanager.lua).
Replace the /config/inventory folder (tgiann.lua updated).
Replace the /config/housing folder (rtx.lua updated).
Required — update sky_jobs_base and every Sky job resource (sky_ambulancejob, sky_policejob, sky_mechanicjob) to their matching releases. The job & duty cache hardening changes how job and duty updates reach the server; running older job resources against this release can leave job or duty state out of sync.
No SQL migration. Config.banking = "auto" and Config.billing = "auto" detect bcs_companymanager automatically; set either to "companymanager" only to pin it manually. The shipped config/config.lua is unchanged — optionally update its value-list comments so the new option is listed (informational only, no behaviour change):

-billing = "auto", -- auto, esx, codem, codemv2, okok, jacksam, quasar, vms, rxbilling, wasabi, corem, fd, groot
+billing = "auto", -- auto, esx, codem, codemv2, okok, jacksam, quasar, vms, rxbilling, wasabi, corem, fd, groot, companymanager
-banking = "auto", -- auto, sky, crm, qs, okok, bablo, fd, rx, tgg, kartik, esx, qb, renewed, wasabi, groot, ak47, jaksam - can be customized in config/banking
+banking = "auto", -- auto, sky, crm, qs, okok, bablo, fd, rx, tgg, kartik, esx, qb, renewed, wasabi, groot, ak47, jaksam, companymanager - can be customized in config/banking

Jun 8, 2026

Version 1.20.0

Highlights

Added okokGasStation fuel support — auto-detected and selectable via Config.fuel = "okokGasStation" (alias "okokfuel"). Updated value list: auto, lc, ox, legacy, rcore, hex, okokGasStation, okokfuel, native.

Notable Changes

ESX + Quasar inventory — wholesale/shop purchases no longer fail with a false "Not enough inventory space" message; free space is now checked through qs-inventory instead of the generic ESX carry check.
QBCore / Qbox — player-load handling now hooks the correct OnPlayerLoaded event, so dependent scripts reliably receive sky_base:playerLoaded.
ESX — duty status now always resolves to a real boolean (true / false) instead of occasionally returning nil, for consistent duty checks.
codemv2 billing — expanded the codemv2 billing integration.
Fixed vehicles incorrectly getting default tire smoke after spawn, garage restore, or mechanic tuning loads — the saved on/off state is now respected.
Interaction points are processed more efficiently, improving performance and input responsiveness on servers with many interaction points.

Other Changes

Added an option to force individual Sky.Debug messages to print even when global debug is disabled (developer aid).
Hardened global config-table initialization so core tables are set up consistently before other config files load.

Download sky_base from the CFX Portal.
Create a backup.
Replace the /source folder.
Replace the /fxmanifest.lua (now loads the new config/init.lua).
Add the new /config/init.lua file.
Replace /config/config.lua (global table init moved to init.lua; fuel value-list comment updated).
Replace the /config/fuel folder (new okokGasStation.lua).
Replace the /config/inventory folder (qs.lua updated).
Replace the /config/framework folder (esx.lua, qb.lua, qbox.lua updated).
Replace the /config/billing folder (codemv2.lua updated).
No SQL migration. Config.fuel = "auto" picks up okokGasStation automatically; set "okokGasStation" only to pin it manually:

-fuel = "auto", -- auto, lc, ox, legacy, rcore, hex, myFuel, native
+fuel = "auto", -- auto, lc, ox, legacy, rcore, hex, okokGasStation, okokfuel, native

Jun 4, 2026

Version 1.19.0

Highlights

vms_cityhall billing support — auto-detected when Config.billing = "auto". Bills are now sent in the correct invoice line-item format and preserve the full society account name.

Notable Changes

ESX + jobs_creator — the player job & duty cache now stays in sync when players are hired, fired, or toggle duty through jobs_creator. These actions bypass the standard ESX job events, which previously left the cache stale for ESX players.
Qbox — boss-menu job data no longer errors on stale or missing player records; offline-player lookups are now guarded and a failed lookup logs the affected identifier instead of crashing the menu.
Fixed a Lua error ("attempt to perform unsupported operation on a vector value") when an interaction marker is configured with an offset.
Fixed a false type-validation error when registering callbacks.

Other Changes

Added Portuguese (pt) locale.

Jun 1, 2026

Version 1.18.0

Highlights

Added a new unified currency & formatting system — the new Sky.Currency API plus a public config/currency.lua let you define custom currencies and display formatters (symbol, symbol position, thousands/decimal separators, rounding, digit grouping, and time/clock formatting). Ships with ready-to-use money and time-based examples and is fully extensible.
Added an internal, database-backed banking option — set Config.banking = "sky" to let sky_base manage job/society accounts in its own database, with no external banking resource required. Additionally Config.useSkyBankingFallback (default false) makes sky_base fall back to its own accounts whenever the selected banking resource is unavailable.
Added a unified housing entrance resolution system — a new /config/housing folder with adapters for multiple housing scripts (nolag, qs, rtx, rx, sn, vms) and a server-side fallback so entrance locations resolve reliably.

Notable Changes

Added Jaksam banking support — auto-detected and selectable via Config.banking = "jaksam". Updated value list: auto, sky, crm, qs, okok, bablo, fd, rx, tgg, kartik, esx, qb, renewed, wasabi, groot, ak47, jaksam.
Added Jaksam and Wasabi progressbar support — selectable via Config.progressbar. Updated value list: auto, esx, ox, qb, mythic, hex, jaksam, wasabi. Servers running multiple Jaksam Creator resources are now handled correctly.
Added myFuel support — auto-detected and selectable via Config.fuel = "myFuel". Updated value list: auto, lc, ox, legacy, rcore, hex, myFuel, native.
Improved tgiann, qs, and codem inventory integrations for more consistent item, metadata, and weapon handling.
Shared/society banking accounts are now auto-created on first access (kartik & qb banking) — jobs added after the banking resource has started work without a server restart.

Other Changes

Raised the default interactionDistance to 2.0 and added a new Config.defaultMarkerSize (default 1.2) used when a marker has no explicit scale.
Config.showMarkersWithTarget now defaults to true, so configured interaction markers stay visible alongside an active target backend.

Download sky_base from the CFX Portal.
Create a backup.
Replace the /source folder.
Replace the /fxmanifest.lua (loads the new config/currency.lua and the config/housing files).
Add the new /config/currency.lua file.
Add the new /config/housing folder (nolag.lua, qs.lua, rtx.lua, rx.lua, sn.lua, vms.lua, _init.lua).
Replace the /config/banking folder (new sky.lua, jaksam.lua; kartik.lua, qb.lua updated).
Replace the /config/progress folder (new jaksam.lua, wasabi.lua).
Replace the /config/fuel folder (new myFuel.lua).
Replace the /config/inventory folder (tgiann.lua, qs.lua, codem.lua updated).
Replace the /config/framework folder (qb.lua updated).
In config/config.lua, update the value-list comments and add the new options:

-progressbar = "auto", -- auto, esx, ox, qb, mythic, hex
+progressbar = "auto", -- auto, esx, ox, qb, mythic, hex, jaksam, wasabi
-fuel = "auto", -- auto, lc, ox, legacy, rcore, hex, native
+fuel = "auto", -- auto, lc, ox, legacy, rcore, hex, myFuel, native
-banking = "auto", -- auto, crm, qs, okok, bablo, fd, rx, tgg, kartik, esx, qb, renewed, wasabi, groot, ak47
+banking = "auto", -- auto, sky, crm, qs, okok, bablo, fd, rx, tgg, kartik, esx, qb, renewed, wasabi, groot, ak47, jaksam
+useSkyBankingFallback = false, -- use sky_base's own DB-backed accounts when the selected banking resource fails; set banking = "sky" to force it
-interactionDistance = 1.2,
+interactionDistance = 2.0,
+defaultMarkerSize = 1.2, -- default marker scale when marker.scaleX / marker.scaleY / markerSize is not set
-showMarkersWithTarget = false,
+showMarkersWithTarget = true,

Config.banking = "auto", Config.fuel = "auto", and Config.progressbar = "auto" pick up the new adapters automatically — set a specific value only to pin one manually.

May 22, 2026

Version 1.17.0

Highlights

Added progressbar adapter system — new unified Sky.Functions.Progress / Sky.Functions.Bar API with auto-detection across esx, qb, ox, mythic, and hex progressbar resources. Configure via Config.progressbar = "auto" (or pin a specific adapter). Updated value list: auto, esx, qb, ox, mythic, hex.

Notable Changes

Added jacksam jobscreator support on the QBCore framework — jobs created through jacksam's jobscreator are now recognized by the QBCore framework integration.

Other Changes

No additional changes.

Download sky_base from the CFX Portal.
Create a backup.
Replace the /source folder.
Replace the /config/framework folder (qb.lua updated — jacksam jobscreator integration).
Add the new /config/progress folder (adapters: esx.lua, qb.lua, ox.lua, mythic.lua, hex.lua).
Replace the /fxmanifest.lua (progress adapter files are loaded on the client).
Add the new progressbar option to config/config.lua:

+progressbar = "auto", -- auto, esx, qb, ox, mythic, hex

"auto" picks up the running progressbar resource automatically. Set it to a specific value (e.g. "hex") to pin a particular adapter.

May 18, 2026

Version 1.16.0

Highlights

Added hex_4_inventory support — auto-detected and selectable via Config.inventory = "hex". Updated value list: auto, esx, qb, qbox, vrp, ox, qs, ps, codem, tgiann, jaksam, ak47, hex.

Notable Changes

Fixed Sky.FW.AddJobGrade on ESX and QBCore silently misbehaving on the duplicate-grade guard — the existence check was being called with the full gradeData table instead of the grade number, so it never reported "grade already exists" correctly. Adding grades through Sky.FW.AddJobGrade now reliably skips ones that are already registered.
Removed a leftover debug print that fired for every item on every Qbox inventory normalization call (console spam, no behaviour change).

Other Changes

No additional changes.

May 15, 2026

Version 1.15.0

Highlights

Added qb-inventory support - auto-detected and selectable via Config.inventory = "qb-inv".
Added normalized inventory slot and metadata helpers for supported inventory adapters.
Added Russian locale support via Config.locale = "ru".

Notable Changes

Added Dynamic Interaction point distance
Inventory item metadata handling was improved for several adapters, including metadata-aware item and weapon removal where the inventory backend supports it.

Other Changes

No additional changes.

May 11, 2026

Version 1.14.0

Breaking — the admin permission system has been replaced. After updating sky_base, every Sky job resource (sky_jobs_base, sky_ambulancejob, sky_policejob, sky_mechanicjob) must also be updated to the matching release, and three one-time ACEs must be added to your server.cfg. See Update Instructions.

Highlights

New admin permission system — Sky.Config.AdminGroups and the related Sky.FW.IsAdmin / Sky.FW.HasGroup / Sky.FW.GetGroup are gone. Each job's Config.CommandPermissions table is now the single source of truth for who can use which admin command. At server start sky_base auto-emits add_ace group.<g> sky_<resource>.<command> allow for every entry, and admin commands resolve via a single IsPlayerAceAllowed check at runtime. Fixes the QBox bug where every admin command silently denied admins because qbx_core:HasPermission was deprecated in qbx_core v1.8.0 and removed. QBCore wires both group.* and qbcore.* prefixes for resilience; on ESX the same group.* ACE principals are picked up via es_extended's setGroup.
Added g-banking and g-billing support (groot) — auto-detected and selectable via Config.banking = "groot" / Config.billing = "groot".
Added AK47 banking and AK47 inventory support — auto-detected and selectable via Config.banking = "ak47" / Config.inventory = "ak47".

Notable Changes

Added codem-phone integration — auto-detected and selectable via Config.phone = "codem". Updated value list: auto, esx, qb, d, gks, lb, lb-unique, yserie, codem.
Fixed qb-target compatibility on QBCore servers — radial menus and workshop-creator zones now register correctly. The shim was using the wrong export names (AddSphereZone / AddGlobalOption), causing zones to silently no-op on QBCore.
Interaction points now support a per-point forceMarkerInteraction flag — when set, that single interaction always uses marker + help notification, even if a target backend (ox_target / qb-target) is active. Useful for specific markers that should stay as markers regardless of the global target setting.
Added a global Config.showMarkersWithTarget toggle (default false) — when set to true, configured interaction markers stay drawn alongside the target backend instead of being hidden. Pairs with the per-point forceMarkerInteraction flag for finer control: server-wide on/off via this setting, per-interaction override via the flag.

Other Changes

No additional changes.

Download sky_base from the CFX Portal.
Create a backup.
Replace the /source folder.
Replace the /config/framework folder.
Replace the /config/banking folder (new groot.lua, ak47.lua).
Replace the /config/billing folder (new groot.lua).
Replace the /config/inventory folder (new ak47.lua).
Replace the /config/phone folder (new codem.lua).
Replace the /config/target folder (qb.lua updated).
Required — add the three permission bootstrap ACEs to your server.cfg, before ensure sky_base:

add_ace resource.sky_base command.add_ace allow
add_ace resource.sky_base command.add_principal allow
add_ace resource.sky_base command.remove_principal allow

Without these, sky_base cannot wire the per-command ACE entries on boot and every admin command will deny everyone except the server console. 11. Breaking — remove the Config.AdminGroups block from config/config.lua. It is no longer read:

-Config.AdminGroups = {
-    "god",
-    "superadmin",
-    "admin"
-}

Update the Config value-list comments to include the new adapters (purely informational — "auto" still works):

-phone = "auto", -- auto, esx, qb, d, gks, lb, lb-unique, yserie
+phone = "auto", -- auto, esx, qb, d, gks, lb, lb-unique, yserie, codem
-billing = "auto", -- auto, esx, codem, codemv2, okok, jacksam, quasar, vms, rxbilling, wasabi, corem, fd
+billing = "auto", -- auto, esx, codem, codemv2, okok, jacksam, quasar, vms, rxbilling, wasabi, corem, fd, groot
-inventory = "auto", -- auto, esx, qb, qbox, vrp, ox, qs, ps, codem, tgiann, jaksam
+inventory = "auto", -- auto, esx, qb, qbox, vrp, ox, qs, ps, codem, tgiann, jaksam, ak47
-banking = "auto", -- auto, crm, qs, okok, bablo, fd, rx, tgg, kartik, esx, qb, renewed, wasabi
+banking = "auto", -- auto, crm, qs, okok, bablo, fd, rx, tgg, kartik, esx, qb, renewed, wasabi, groot, ak47

(Optional) The new Config.showMarkersWithTarget toggle is added next to target in config/config.lua. Default false preserves the existing behaviour (markers hidden while a target backend is active); set to true to keep markers visible alongside the target backend:

 target = "none", -- none (default: marker + help notification), ox, qb, auto - ...
+showMarkersWithTarget = false, -- keep drawing configured interaction markers when target is enabled

Required — update every Sky job resource to its matching release (sky_jobs_base, sky_ambulancejob, sky_policejob, sky_mechanicjob). Older versions still call the removed Sky.FW.IsAdmin and will deny every admin command after the sky_base update.
For each job, review the new Config.CommandPermissions table in that job's config/config.lua and adjust the allowed groups per command if needed. The default { "god", "superadmin", "admin" } keeps the previous behaviour for QBox / QBCore / ESX servers using the standard admin groups.

May 8, 2026

Version 1.13.0

Highlights

Added fd_banking billing integration — auto-detected and selectable via Config.billing = "fd". Updated value list: auto, esx, codem, codemv2, okok, jacksam, quasar, vms, rxbilling, wasabi, corem, fd.
Added hex_3_fuel fuel adapter — auto-detected and selectable via Config.fuel = "hex". Updated value list: auto, lc, ox, legacy, rcore, hex, native.

Notable Changes

Renewed-Banking: jobs that are added after Renewed-Banking has already started now work without a server restart — their accounts are created on first use.
Renewed-Banking: Sky.Job.AddMoney / Sky.Job.RemoveMoney now correctly return false when the underlying transaction is rejected, so callers can react to a failed payment.
Interaction NPCs configured without a pedHash are now skipped with a warning instead of breaking the spawn flow.

Other Changes

No additional changes.

Apr 30, 2026

Version 1.12.0

Highlights

Added Wasabi Banking (wasabi_banking) support — auto-detected and selectable via Config.banking = "wasabi".
Renamed the banking key "qbox" to "renewed" for the Renewed-Banking integration. Updated value list: auto, crm, qs, okok, bablo, fd, rx, tgg, kartik, esx, qb, renewed, wasabi.

Notable Changes

Breaking: if you previously set Config.banking = "qbox" for Renewed-Banking, change it to Config.banking = "renewed". Config.banking = "auto" still detects Renewed-Banking automatically without changes.
Fixed interaction NPC onSpawn callbacks not firing when an existing entity is reused (e.g. when a station creator rebuilds while preserving the existing ped). scenario and onSpawn hooks now also apply to preserved peds.
Improved Qbox job grade normalization for consistency with other framework integrations.
Added a debug warning when vehicle keys are added or removed without a configured key adapter handler — helps diagnose Config.vehiclekeys misconfigurations.

Other Changes

No additional changes.

Download sky_base from the CFX Portal.
Create a backup.
Replace the /source folder.
Replace the /config/framework folder.
Replace the /config/banking folder (qbox.lua was renamed to renewed.lua, new wasabi.lua and _init.lua were added).
Breaking — In config/config.lua, if you set the banking system manually:

-banking = "qbox", -- Renewed-Banking
+banking = "renewed", -- Renewed-Banking (renamed from "qbox")

Or stay on banking = "auto" and the Renewed-Banking adapter is picked automatically.

Apr 27, 2026

Version 1.11.0

Highlights

Added qb-target support alongside ox_target via a new Config.target selector ("ox", "qb", "auto", or "none"). The backend is loaded from the new /config/target folder and replaces the marker + help-notification interaction when a target backend is active.
Default Config.target = "none" keeps the existing marker + Press E behaviour for every existing server — target backends are strictly opt-in.

Notable Changes

Breaking: Config.enableOXTarget has been removed. Replace it with Config.target = "ox" (or "qb" / "auto" / "none").
Reverted the Qbox permission detection change from 1.10.1 — Qbox admin / group checks use qbx_core:HasPermission again.

Other Changes

No additional changes.

Download sky_base from the CFX Portal.
Create a backup.
Replace the /source folder.
Replace the /config/framework folder.
Add the new /config/target folder.
In config/config.lua, replace the removed enableOXTarget flag:

-enableOXTarget = false,
+target = "none", -- none (default: marker + help notification), ox, qb, auto - can be customized in config/target. "auto" picks a started target resource and replaces the normal marker interaction, only opt-in.

Apr 22, 2026

Version 1.10.1

Highlights

Improved weapon handling across ox_inventory, qs-inventory, ps-inventory, jaksam, codem, and tgiann — weapon add, remove, and carry checks now go through each inventory's native logic for cleaner behaviour.
Qbox admin and permission detection updated for Qbox v1.8.0 compatibility — now uses the native FiveM ACE permission system.
Interaction NPCs can now play a GTA scenario on spawn and run a custom setup callback (e.g. give armor, equip weapons, add extra tasks) through new optional scenario and onSpawn options.

Notable Changes

Removed a leftover debug message that printed on every Qbox permission check.

Other Changes

No additional changes.

Apr 20, 2026

Version 1.10.0

Highlights

Banking system refactored into dedicated per-banking adapter files (crm, qs, okok, bablo, fd, rx, tgg, kartik, esx, qb, qbox), replacing inline framework code.
Added Config.banking selector with auto detection (matches the existing inventory, fuel, and vehiclekeys pattern).
Added Config.defaultCallbackTimeout to control the timeout for client-triggered callbacks.
Added metadata propagation for jaksam_inventory AddItem / RemoveItem calls.

Notable Changes

Fixed weapon transfer handling across QBCore and Qbox frameworks.

Other Changes

No additional changes.

Download sky_base from the CFX Portal.
Create a backup.
Replace the /source folder.
Replace the /config/framework folder.
Replace the /config/inventory folder.
Add the new /config/banking folder.
In config/config.lua, add the new options:

Config.banking = "auto" -- auto, crm, qs, okok, bablo, fd, rx, tgg, kartik, esx, qb, qbox - can be customized in config/banking
Config.defaultCallbackTimeout = 5000 -- default timeout for client-triggered callbacks in ms

Apr 13, 2026

Version 1.9.0

Highlights

Inventory system refactored into dedicated per-inventory adapter files (ox, qs, jaksam, codem, ps, tgiann, esx, qb, qbox, vrp), replacing inline framework code.
Added Corem support (crm-billing and crm-banking) for billing and society money management across ESX, QB, and QBox.

Notable Changes

Default language changed from German to English.

Other Changes

No additional changes.

Download sky_base from the CFX Portal.
Create a backup.
Replace the /source folder.
Replace the /config/locales folder.
Replace the /config/framework folder.
Replace the /config/billing folder.
Add the new /config/inventory folder.
In config/config.lua, change the default language if needed:

-Config.Locale = "de"
+Config.Locale = "en"

Apr 6, 2026

Version 1.8.0

Highlights

Added fuel bridge system with auto-detection for lc_fuel, ox_fuel, LegacyFuel, rcore_fuel, and native GTA fallback.
Added dedicated vehicle key adapter section with support for brutal, mk, mrnewb, msk, qb, quasar, vehicles_keys, wasabi, and kiminaze.
Added centralized Sky.DB.Migrate() for declarative database migrations across all Sky-Systems scripts.
Added support for wasabi-billing, RxBilling, and 17mov_Phone.

Notable Changes

Added migration tracking system to synchronize resource initialization with pending database schema updates.
Added retry logic for sky_base export loading (up to 5s) to prevent failures from resource load order issues.
Added cd_garage persistent vehicle plate update trigger when license plates are modified.
Added Qbox support to the Quasar garage adapter.
Added inventory-full notification when calling Sky.Reward.

Other Changes

Fixed Quasar garage compatibility issues with Qbox.
Fixed case-insensitive weapon detection across ESX, QB, and Qbox frameworks.

Mar 30, 2026

Version 1.7.0

Highlights

Added Sky.FW.GetPlayerDirectoryQueryConfig for QB, QBox, and VRP frameworks.
Added tgg-banking support for society money management across ESX, QB, and QBox.
Added kartik-banking support for society money management across ESX, QB, and QBox.

Notable Changes

Added hex_4_inventory support for ESX with pcall fallbacks for missing ESX item methods.
Fixed GetPlayerDirectoryQueryConfig for QB and QBox.

Other Changes

Fixed SanitizeForSQL stripping Unicode characters; now preserves Unicode letters and removes only SQL-dangerous characters.

Mar 23, 2026

Version 1.6.0

Highlights

Fixed missing locales variable in Security.lua causing nil index error in cooldown function.
Interaction points now support reusing existing NPC entities and preserving peds on rebuild (keepNpc).

Notable Changes

Added GetPlayerDirectoryQueryConfig function for ESX framework.
Fixed import.lua initialization order so Sky table is initialized before export assignment.
Optimized polling intervals for callbacks and database queries to reduce CPU overhead.
Interaction loop now runs at 0ms when in range for frame-accurate marker rendering.

Other Changes

OxMySQL errors now log failing queries through Sky.Debug before propagating.
Added Finnish translation.

Mar 16, 2026

Version 1.5.0

Highlights

Refactored ESX player retrieval to direct ESX.GetPlayerFromId() calls for better compatibility.
Inventory items now include metadata across ESX, QB, and QBox.

Notable Changes

ChangePlayerName now synchronizes live player metadata in addition to DB updates.
Added normalizeInventoryMetadata() helper to unify metadata/info handling.
Improved qs-banking compatibility with resource/export fallbacks and automatic society_ prefix fallback.
Added VMS/CMS billing integration (config/billing/vms.lua).

Other Changes

Fixed Locales variable capitalization in shared initialization.

Mar 9, 2026

Version 1.4.0

Highlights

Added ox_inventory metadata support for item handling across ESX, QB, and QBox.
Added support for ESX 1.13+ static methods.

Notable Changes

Player data retrieval now properly distinguishes source IDs and string identifiers.
ESX version detection now uses resource metadata instead of dynamic checks.
Standardized player data access via runPlayerMethod helper.

Other Changes

Fixed getFirstname and getLastname calls for ESX.
Updated qs-banking integration to correct export/property for balances.
Refactored database module debug string formatting.

Introduction

sky_base is a crucial component for all Sky-Systems scripts, designed to enhance performance, streamline configuration, and provide a unified framework for easier management. This guide will introduce you to sky_base and walk you through its configuration and use.

Introduction

sky_jobs_base is the shared foundation for all Sky-Systems job scripts — providing the tablet system, dispatch, radial menu, garage, storage, and more.

Changelog

Version 1.36.0

Version 1.35.1

Version 1.35.0

Version 1.34.0

Version 1.33.0

Version 1.32.1

Version 1.32.0

Version 1.31.0

Version 1.30.0

Version 1.29.0

Version 1.28.0

Version 1.27.0

Version 1.26.0

Version 1.25.0

Version 1.24.0

Version 1.23.0

Version 1.22.0

Version 1.21.0

⚠️ You MUST replace the /config/framework folder

Version 1.20.0

Version 1.19.0

Version 1.18.0

Version 1.17.0

Version 1.16.0

Version 1.15.0

Version 1.14.0

Version 1.13.0

Version 1.12.0

Version 1.11.0

Version 1.10.1

Version 1.10.0

Version 1.9.0

Version 1.8.0

Version 1.7.0

Version 1.6.0

Version 1.5.0

Version 1.4.0

⚠️ You MUST replace the `/config/framework` folder