Initializing

Secure Protocol Active

Configuration Reference — MBT Rpemotes UI | MalibuTech

Configuration (`config.lua`)

All MBT Rpemotes UI settings live in config.lua. There are no in-game admin panels — every option is set here and applied on resource start.

Quick Overview

Section	Purpose
`MBT.Language` / `MBT.Debug`	Locale selection and debug logging
`MBT.RpemotesResource`	rpemotes resource name (auto-detected by default)
`MBT.Menu`	Keybind, command, layout, position, auto-close, watermark, native menu override
`MBT.Features`	Toggle favorites, recent emotes, quick bind, emote wheel, shared popup, preview ped
`MBT.EmoteWheel`	Wheel key, slot count, remove key
`MBT.Categories`	Category visibility and display order
`MBT.Theme`	Six hex color tokens sent to the NUI
`MBT.Ecosystem`	Integration with other MBT scripts
`MBT.JobPermissions`	Per-emote job restrictions with framework auto-detection
`MBT.Notification`	Notification function wrapper (ox_lib, ESX, QB, etc.)

Global Settings

`MBT.Language`

Type: string — Default: 'en'

Locale used for all UI text. Supported values: 'en', 'it', 'es', 'fr', 'de', 'pt'. Additional locales can be added by creating a file in the locales/ folder.

`MBT.Debug`

Type: boolean — Default: false

Enables verbose console logging for development. Set to false on production servers.

`MBT.RpemotesResource`

Type: string | nil — Default: nil

The resource name of the rpemotes engine to integrate with. When nil, auto-detection tries rpemotes-reborn, then rpemotes, then rp-emotes. Force a specific name only if auto-detection fails.

Key	Type	Default	Description
`Keybind`	`string`	`'F4'`	Key that opens/closes the MBT emote menu
`Command`	`string`	`'mbt_emotes'`	Chat command alternative to the keybind

Features (`MBT.Features`)

Key	Type	Default	Description
`Favorites`	`boolean`	`true`	Enable the favourites tab and star button per emote
`RecentEmotes`	`boolean`	`true`	Track and display recently played emotes in the Recent tab

Emote Wheel (`MBT.EmoteWheel`)

Key	Type	Default	Description
`Key`	`string`	`'Z'`	Hold this key to open the emote wheel
`Slots`	`number`	`8`	Number of slots on the wheel (maximum 8)

Categories (`MBT.Categories`)

An ordered array of category definitions. Each entry has:

Field	Type	Description
`type`	`string`	Internal rpemotes category key — do not change
`label`	`string`	Display name shown in the tab bar
`icon`	`string`	Lucide icon name rendered next to the label

Default order: Emotes → Props → Dances → Shared → Expressions → Walk Styles → Animals → Emojis.

Reorder entries to change the tab order. Hidden categories are still accessible via search.

Theme (`MBT.Theme`)

Six hex color tokens (without #) customizing the entire NUI. All values are sent to the React UI at resource start.

Key	Default	Purpose
`Accent`	`'00fb8a'`	Primary accent color (buttons, highlights, active states)
`Background`	`'0C0E14'`	Full-screen background
`Card`	`'141720'`	Panel and card surface color

MBT Ecosystem Integration (`MBT.Ecosystem`)

Key	Type	Default	Description
`MetaClothes`	`boolean`	`false`	Set to `true` if `mbt_meta_clothes` v2 is installed
`WearableProps`	`boolean`	`false`

When enabled, the UI can surface relevant clothing/prop context while browsing emotes.

Job Permissions (`MBT.JobPermissions`)

Key	Type	Default	Description
`Enabled`	`boolean`	`true`	Master toggle — disable to allow all players access to all emotes
`Framework`	`string`	`'auto'`	Framework for job lookups: `'auto'`, , , , or

'auto' detection order: ESX → QBox → QBCore → standalone.

Example:

MBT.JobPermissions = {
    Enabled = true,
    Framework = 'auto',
    Emotes = {
        ['handcuff'] = { 'police', 'sheriff' },
        ['mechanic']  = { 'mechanic', 'bennys' },
    },
}

Players without a matching job will see the emote greyed out with a lock icon.

Notification (`MBT.Notification`)

A callback function called whenever MBT Rpemotes UI needs to send a player notification. data contains title, description, type, and duration. Uncomment or write your own integration:

MBT.Notification = function(data)
    -- ox_lib
    exports.ox_lib:notify({ title = data.title, description = data.description, type = data.type })
    -- ESX
    -- ESX.ShowNotification(data.description)
    -- QBCore
    -- QBCore.Functions.Notify(data.description, 'primary')
end

Configuration (config.lua)

Quick Overview

Global Settings

MBT.Language

MBT.Debug

MBT.RpemotesResource

Menu Settings (MBT.Menu)

Features (MBT.Features)

Emote Wheel (MBT.EmoteWheel)

Categories (MBT.Categories)

Theme (MBT.Theme)

MBT Ecosystem Integration (MBT.Ecosystem)

Job Permissions (MBT.JobPermissions)

Notification (MBT.Notification)