Configuration - YB Scripts Documentation

Editable files

File	Scope	Purpose
`config.lua`	Shared	Safe feature settings, UI behavior, commands, limits, and presets
`editable/server.lua`	Server only	Owners, groups, permissions, inventory bridge, and private connectivity settings
`editable/server/webhooks.lua`	Server only	Discord URLs, category routing, identity, and audit presentation
`editable/client.lua`	Client	Notifications, revive, appearance, inventory, fuel, and vehicle key integrations

Never place webhook URLs, private identifiers, credentials, or other secrets in config.lua or a client file.

Framework

Automatic
QBox
QBCore
ESX

Config.Framework = 'auto'

Config.Framework = 'qbox'

Config.Framework = 'qb'

Config.Framework = 'esx'

Owners and groups

Configure bootstrap owners, default groups, permission categories, protected groups, and high-level permissions in editable/server.lua. See Permissions and duty for the complete model.

Duty

Config.Duty = {
    defaultOn = false,
}

When defaultOn is false, staff must use Go On Duty before opening the full panel or running staff actions.

Branding

Use a server name or a logo:

Config.Branding = {
    useServerName = true,
    serverName = 'My Server',
    logoUrl = '',
}

Commands and keybinds

Setting	Default
`Config.Command`	`admin`
`Config.OpenKey`	`F6`
`Config.StaffChatKey`	`F7`
`Config.NoclipCommand`	`noclip`
`Config.NoclipKey`	`F2`
`Config.ShowNamesCommand`	`shownames`
`Config.DevTools.key`	`F9`

Reports and evidence

Config.Reports controls /report, categories, anti-spam limits, dispatch controls, message length, and evidence.

Config.Reports.evidence.provider = 'screencapture'
-- auto | screencapture | screenshot-basic

screencapture supports screenshots and short video evidence.
screenshot-basic supports screenshots only.

Screen viewing and screenshots

Config.Screenshot controls live-view limits, capture dimensions, frame rate, bitrate, and the provider used for manual screenshots.

Start with 960 × 540, 30 FPS, and 1000 Kbps. Reduce these values for servers with weaker player connections.

Inventory and items

The server bridge detects ox_inventory, qs-inventory, qb-inventory, and compatible providers. Configure delivery limits in Config.Items:

nearbyRadius
maxSelectedItems
maxAmountPerItem
maxTargets
hiddenItems

Edit provider-specific behavior only in editable/server.lua and editable/client.lua.

Economy and property storage

Config.Economy controls the leaderboard, cache duration, money items, vehicle storage, and housing presets. Included presets:

qbx_properties
qb-apartments
qb-houses
ox_property
esx_property

For QBox properties with ox_inventory, use:

Config.Economy.properties.script = 'qbx_properties'

Saved stashes are resolved as qbx_properties_<property_name> and matched to the owner’s citizen ID.

Dashboard and cleanup

Config.Dashboard.playerChart configures sampling and chart history.
Config.IgnoreZones protects defined areas from vehicle cleanup.
Config.IgnoreModels protects specific vehicle models.
Config.Cleanup controls countdown limits and default exclusions.
Config.AnnouncementUI controls duration, position, colors, size, and borders.

Logs and Discord

Config.Logs controls the in-panel memory history and automatic categories. Configure Discord delivery in editable/server/webhooks.lua.

Use one webhook for everything

Set PRIMARY_WEBHOOK. Categories assigned to it share the same Discord channel.

Use separate category channels

Add individual URLs to Config.Webhooks.staff, reports, bans, inventory, resources, or screenshots.

Disable a route

Leave both the category and its fallback empty.

Protected resources

Config.ProtectedResources blocks accidental changes to critical resources. Set Config.AllowOwnerProtectedResourceActions = false when even owners must be prevented from stopping or restarting them.

Debug mode

Keep Config.Debug = false in production. Enable it only while reproducing an integration issue, collect the relevant console output, then disable it again.

​Editable files

​Framework

​Owners and groups

​Duty

​Branding

​Commands and keybinds

​Reports and evidence

​Screen viewing and screenshots

​Inventory and items

​Economy and property storage

​Dashboard and cleanup

​Logs and Discord

​Protected resources

​Debug mode

Editable files

Framework

Owners and groups

Duty

Branding

Commands and keybinds

Reports and evidence

Screen viewing and screenshots

Inventory and items

Economy and property storage

Dashboard and cleanup

Logs and Discord

Protected resources

Debug mode