Introduction

Welcome to the MBT Rpemotes UI documentation!

MBT Rpemotes UI is a premium NUI replacement for the rpemotes-reborn emote engine. It replaces the default NativeUI menu with a fully custom React interface while keeping full compatibility with rpemotes-reborn's emote library — no emote data migration needed, no breaking changes to existing setups.

Key Features

1800+ Emotes, 8 Categories

Supports the full rpemotes-reborn emote library split into eight browseable categories: Emotes, Props, Dances, Shared, Expressions, Walk Styles, Animals, and Emojis. Each category can be individually shown or hidden from the menu.

Favorites & Recent Emotes

Players can mark any emote as a favourite with a single click. The Favourites tab preserves both the selection and the custom sort order across sessions using KVP storage (no SQL required). A separate Recent tab automatically tracks the last 12 played emotes (configurable).

Quick Bind (NUM1–NUM6)

Drag any emote onto a numbered slot in the menu to bind it to a numpad key. Pressing the bound key plays the emote immediately without opening the menu.

Emote Wheel

Hold Z (configurable) to open an 8-slot radial wheel. Scroll while holding to cycle through the assigned emotes. Release to play the selected one — no cursor interaction needed. Emotes are removed from a slot by pressing X while the wheel is open.

Playlists

Players can create named emote sequences that play automatically one after another. Playlists are stored client-side via KVP.

Partner Finder

The Shared emotes category includes a built-in partner finder panel. Players search for nearby partners directly from the UI. When a partner is selected, the shared emote invitation is sent and tracked inline with an accept/decline popup.

Animated Preview Ped

Hovering over any emote in the menu renders a live animated ped preview in a floating window, showing exactly what the emote looks like before activating it.

Two Layouts

Panel position (left/right) is independently configurable.

Full Theme Customization

Six color tokens (Accent, Background, Card, Text, SubText, Border) are sent to the NUI at startup via MBT.Theme. Change any hex value in config.lua to fully re-skin the interface without touching any UI files.

Six Languages

Built-in localization for English, Italian, Spanish, French, German, and Portuguese. Set MBT.Language in config.lua to the desired locale. Additional languages can be added by creating a new file in the locales/ folder.

Job Permissions

Individual emotes can be restricted to specific server jobs. Players without the required job see the emote greyed out with a lock icon. Framework detection is automatic (ESX → QBox → QBCore → standalone) or can be forced explicitly.

MBT Ecosystem Integration

Optional integration with mbt_meta_clothes and mbt_wearable_props. When enabled, the UI surfaces relevant outfit/prop context while browsing emotes.

What's in v1.0.0

This is the initial public release of MBT Rpemotes UI. Everything listed above is included from day one — favorites, recent, quick bind, emote wheel, playlists, partner finder, preview ped, job permissions, full theme support, and six languages.

Target Audience

Designed for server owners who want a modern, polished emote interface without rebuilding their emote engine. If you already run rpemotes-reborn, you can install this resource alongside it in minutes — no configuration migration required.