This script is fully compatible with ESX, QBCore, QBox, and can also run standalone. It includes built-in backward compatibility with qb-radialmenu and qbx_radialmenu via the provide directive — existing scripts that depend on those resources will automatically route to onex-radialmenu.
onex-radialmenu ships with a default qb-radialmenu and qbx_radialmenu configuration out of the box. If you never customized those scripts, everything works automatically — no extra steps needed.
The steps below are only required if you previously edited your qb-radialmenu or qbx_radialmenu config and want to carry those customizations over to onex-radialmenu.
If you previously customized your qb-radialmenu config and want to preserve those changes:
Before making any changes, back up your original qb-radialmenu/config.lua file.
Go to your qb-radialmenu folder and copy everything inside the config.lua file.
Paste it into onex-radialmenu/bridge/qb-radialmenu/config.lua.
Rename the Config variable to qb_Config throughout the file to avoid conflicts with the onex-radialmenu config.
Before:
qb-radialmenu/config.lua1Config = {}2Config.Keybind = 'F1'3Config.Toggle = false4Config.UseWhilstWalking = false5Config.EnableExtraMenu = true6Config.Fliptime = 15000
After:
onex-radialmenu/bridge/qb-radialmenu/config.lua1qb_Config = {}2qb_Config.Keybind = 'F1'3qb_Config.Toggle = false4qb_Config.UseWhilstWalking = false5qb_Config.EnableExtraMenu = true6qb_Config.Fliptime = 15000
Apply this rename to the entire file — all Config. references become qb_Config..
The bridge config is only loaded when QBCore is detected. A framework guard (if Config.Framework ~= 'qb' then return end) at the top of the file ensures it's skipped on other frameworks.
Restart the server to apply your changes.
While you can restart just the resource, we recommend restarting the entire server to ensure all changes are applied correctly.
Use your configured key (default F1) to open the radial menu and confirm your items appear as expected.
Last updated about 1 month ago