XyraL FAQ
The things people ask most. If yours isn’t here, the Discord is the fastest way to get an answer.
Are the Cipher scripts really free?
Yes. Every one is free to use on any server you own or operate, including commercial ones, with the full source included. No paid tier, no key system, no escrow, nothing behind a Discord role. The only restriction is that you can’t redistribute or resell them.
Do they work with QBCore, or only QBox?
Four of the five support both, through a framework bridge that detects which you’re running at startup:
- Both QBox and QBCore — Cipher, Cipher Admin, Cipher Drone, Cipher Trucking
- QBox only — Cipher MDT
Each script page lists its frameworks, and so does its fxmanifest.lua.
Is there escrow, obfuscation or a licence key?
None of it. Every file is plain readable Lua and JavaScript. Nothing phones home, nothing needs activating, and nothing stops working if a server goes down.
Can I edit them for my server?
Yes — change whatever you like for a server you own or operate. What you can’t do is redistribute or resell them, in original or modified form. Full terms are in the LICENSE file in each repository.
What do I need installed?
Most need ox_lib, oxmysql and a framework. Some also need ox_target or an inventory resource. The exact list is at the top of every setup guide, and Getting started explains what each dependency actually does.
Do I need to import a SQL file?
Depends on the script. Some ship a SQL file to import once. Others — Cipher Trucking, for example — create and migrate their own tables on first start, so there’s nothing to import and updates handle themselves. The setup guide says which.
It starts fine but a feature does nothing. What’s wrong?
Almost always a config value pointing at a resource you don’t run. These fail silently — nothing errors, the feature just doesn’t happen:
- Vehicle keys — the vehicle spawns but the engine won’t start.
- Appearance — clothing and ped buttons do nothing.
- Inventory — item actions silently no-op.
The config generator sets these correctly for Admin and Trucking.
I updated and now I get errors about missing columns or nil values
Nearly always a partial update — files copied one at a time with a new folder missed. Replace the entire resource folder and restart. A missing global like attempt to index a nil value (global 'Framework') means a file that defines it never loaded, not that the line it points at is wrong.
Can I use these on a server that takes donations or sells perks?
Yes. Commercial servers are explicitly allowed. The restriction is on selling the scripts, not on how you run your server.
Will you add feature X?
Possibly — open an issue on the relevant repository and say what you’re trying to do rather than just what to add; it usually leads somewhere better. The roadmap shows what’s already planned.
How do I report a bug properly?
Open an issue on the script’s repository with:
- Framework (QBox or QBCore) and script version
- The full console error, not a screenshot of one line
- What you did to trigger it
- Anything you’ve changed in the config
Every script page has a “Report a bug” link that pre-fills most of this. For setup help rather than a bug, Discord is faster.