atlasBridge is designed to run with no configuration — it auto-detects your framework, inventory, and target system at startup. Every convar below is optional; set one only to force a choice or to enable an opt-in feature.
All convars use
setr (replicated, readable client and server) except the Discord secrets, which use set so the token never reaches clients.Quick reference
Providers
Framework
auto | esx | qb | qbx | default | custom
default:"auto"
Selects the framework provider.
auto detects in the order qbx_core → es_extended → qb-core → default. Set custom to load editable/framework/{server,client}.lua. See the Providers guide for detection rules and the Custom Framework page for the adapter contract.Inventory
auto | ox | qb | qs | esx | default | custom
default:"auto"
Selects the inventory provider.
auto detects in the order ox_inventory → qb-inventory → qs-inventory → es_extended (legacy) → default. Set custom to load editable/inventory/{server,client}.lua. See Custom Inventory.Target / interaction
The target system has its own convar —atlas:target, not atlas:ui:target.
auto | ox | qb | own | custom
default:"auto"
Selects the target / interaction provider.
auto detects in the order ox_target → qb-target → own (the bridge’s world-anchored prompts). Unlike framework/inventory, target resolves per call, so start order matters less.UI
own | ox | framework | auto | custom
default:"own"
The global UI mode. The default is the bridge’s own zero-dependency NUI —
ox_lib is opt-in, not automatic. ox swaps every supported call site to ox_lib (which must be started); framework uses the framework’s native notify (notifications only); auto resolves to own (kept for compatibility — it detects ox_lib started → ox, a non-default framework → framework, otherwise own). Anything a chosen provider does not implement falls back to the bridge’s own NUI automatically.
You can override any individual UI subsystem. A per-subsystem convar wins over the global
atlas:ui; leaving it blank inherits atlas:ui. The full subsystem list is exactly:
The radial menu is always the bridge’s own NUI and is not configurable.
Theme color
hex color
default:"#F487F4"
The accent color used across bridge UI and marker props. Accepts any valid hex string. The color is live — it follows marker-prop recolor at runtime. The true default is
#F487F4.Death detection
atlasBridge detects most player deaths automatically (via CEventNetworkEntityDamage and a health watcher). Only set this convar if your server uses a custom death/ambulance system and an Atlas resource fails to react when a player dies.
event name
An extra death event to route through the bridge. Use the event name from your death/ambulance system. Leave it unset on a standard server.
Debug
true | false
default:"false"
Enables verbose detection and networking logs. Turn it on while diagnosing provider detection or net issues, then turn it off for production.
Discord
Discord is optional and disabled unless both values are set. Store these withset, never setr.
bot token (set)
Your Discord bot token. The bridge talks to the Discord REST API directly with no separate bot process. The token is only ever used in an
Authorization header server-side.guild id (set)
Your Discord server (guild) ID. Required for role and member lookups.