Troubleshooting

"Something went wrong" when entering a garage

Usually a vehicle spawn failure. Check the server console for error output. Common causes:

OneSync is not enabled on the server
The interior position is invalid or unreachable
The garage definition is missing required fields (run validation in the builder)

Confirm OneSync is enabled in your server.cfg
Check the server console for routing bucket errors
Make sure the interior is loaded correctly - the vehicle slots must be within the interior's bounds

The framework setting does not match your actual framework, or the database column mapping is wrong.

ESX requires framework = "esx" and ESX column names (owner, vehicle, stored)
QB-Core requires framework = "qb-core" and QB column names (citizenid, mods, state)
QBox requires framework = "qbox" and the same column names as QB-Core

See Getting Started for the correct mappings.

The /garages command (or your custom builderCommand) requires permissions. Check these in order:

ACE permission - ktx_garages.builder must be granted in your server.cfg:
```
add_ace group.admin ktx_garages.builder allow
```
Framework groups - your player's group must be in builder.allowedGroups (default: admin, superadmin)
allowEveryone - set to true to bypass all permission checks

If none of these are configured, nobody can open the builder.

Check coOwnership.allowEntryWhenOwnerOffline in your config. When set to false, co-owners can only enter while the garage owner is online.

Verify your vehicleTypeGroups config includes the correct GTA vehicle class IDs
Make sure the type whitelist or blacklist is enabled in the garage definition
The vehicle's GTA class must match one of the IDs in the type group

QBox ignores the persistVehicles config setting. You must enable the QBox convar in server.cfg:

set qbx:enableVehiclePersistence true

See the Persistence Guide for details.

Set persistVehicles = true in shared/config.lua. The default is false.

ox_lib must start before ktx_garages in your server.cfg:

ensure ox_lib
ensure ktx_garages

If ox_lib is missing entirely, the resource will error on load with a message about ox_lib being required.

Make sure oxmysql is running and connected to your database
Check that your MySQL credentials are correct in server.cfg
The auto-created tables (ktx_garages, ktx_garages_builder, ktx_garages_coowners, ktx_garages_logs) require CREATE TABLE permissions