⚙️ Basic Configuration
All configuration is done in shared/config.lua. This page covers the essential settings.
Framework Detection
Config.Framework = 'auto' -- Options: 'auto', 'qbcore', 'qbox', 'esx'| Value | Description |
|---|---|
'auto' | Automatically detect framework (recommended) |
'qbcore' | Force QBCore |
'qbox' | Force QBox (QBX) |
'esx' | Force ESX |
ℹ️ Recommended: Leave this as
'auto'unless you have issues with detection.
Debug Mode
Config.Debug = false -- Enable debug printsSet to true to enable debug messages in the server console. Useful for troubleshooting.
⚠️ Warning: Disable debug mode in production as it can spam your console.
Tebex Integration
Config.Tebex = {
enabled = true,
storeUrl = 'https://your-store.tebex.io/',
packages = {
['starter_pack'] = { coins = 100, name = 'Starter Pack' },
['basic_pack'] = { coins = 250, name = 'Basic Pack' },
['premium_pack'] = { coins = 500, name = 'Premium Pack' },
['ultimate_pack'] = { coins = 1000, name = 'Ultimate Pack' },
},
}| Option | Description |
|---|---|
enabled | Enable/disable Tebex integration |
storeUrl | Your Tebex store URL (shown when clicking "Buy Coins") |
packages | Package definitions - must match Tebex package names exactly |
See Tebex Integration for detailed setup instructions.
Notification System
Config.Notifications = {
system = 'auto', -- 'auto', 'ox_lib', 'qb', 'esx', 'okokNotify', 'custom'
duration = 5000,
position = 'top-right',
}Inventory System
Config.Inventory = {
system = 'auto', -- 'auto', 'ox_inventory', 'qb-inventory', 'qs-inventory'
}Admin Permissions
Config.Admin = {
permissionSystem = 'ace', -- 'ace', 'group', 'custom'
acePermission = 'command.donator.admin',
adminGroups = { 'admin', 'god', 'superadmin' },
}Using ACE Permissions
Add this to your server.cfg:
add_ace group.admin command.donator.admin allowUsing Group Permissions
If using QBCore/ESX groups, set permissionSystem = 'group' and define allowed groups in adminGroups.
Next Steps
- Theme & UI - Customize colors and appearance
- NPC Settings - Configure the shop NPC
- Shop Items - Add items to your store