Installation
Getting MBT Emote Menu up and running is straightforward. It sits on top of your existing rpemotes-reborn setup — no emote data or configuration migration is required.
Requirements
| Dependency | Notes |
|---|---|
| rpemotes-reborn | Required — MBT Emote Menu is a NUI frontend for this engine |
| ox_lib | Optional — used for notifications if configured |
| screenshot-basic | Optional — required only for Photo Mode's "Send to Discord" button |
All player data (favorites, recent, binds, playlists, personas, wheel) is stored client-side via KVP — no database tables, no .sql files for any of it.
oxmysql is needed only for the scene editor added in 1.8, which stores scenes server-side. Without it the editor turns itself off and says so in console; everything else works unchanged.
Steps
Download and Extract
Download the resource from your Keymaster/Tebex and extract it into your resources folder (e.g., [mbt]/mbt_emote_menu).
Add to server.cfg
Add mbt_emote_menu after rpemotes-reborn in your server.cfg:
ensure rpemotes-reborn
ensure ox_lib # optional — for notifications
ensure screenshot-basic # optional — for Photo Mode Discord upload
# ... other resources
ensure mbt_emote_menuMBT Emote Menu must start after rpemotes-reborn. The resource declares this dependency in its manifest and will refuse to start if rpemotes-reborn is not running.
Configure
There are two Lua files at the root, and the difference between them matters when you update.
| File | Whose it is | On update |
|---|---|---|
config.lua | Yours. We never touch it | Kept |
default.lua | Ours. The factory values | Overwritten |
config.lua loads after default.lua, so anything you set there wins. Put your changes in config.lua — editing default.lua works, but it comes back on the next release.
Open config.lua and adjust settings to match your server:
- Set
MBT.Languageto your preferred locale ('en','it','es','fr','de','pt'). - Set
MBT.Menu.Layoutto'cinematic'or'default'. - Set
MBT.Menu.OverrideNativeMenu = true(recommended) to suppress rpemotes' own NativeUI menu and redirect the defaultF4key to MBT's interface. - Set
MBT.Admin.CommandandMBT.Admin.Permissionif you want the scene editor on a different command or ACE object.
The theme colours are not in config.lua since 1.8. They ship in default.lua and you change them from the in-game panel — shield icon → Settings. See Configuration → Theme.
Verify
Connect to your server and press F4 (or your configured keybind). The MBT emote menu should open. If OverrideNativeMenu is enabled, rpemotes' default NativeUI menu will no longer appear.
That's it for players — no database setup and nothing to import.
To use the scene editor, two more things apply: oxmysql must be running, and the account that opens it needs the ACE permission (command.mbt_emote_menu by default). Grant it in your server.cfg:
add_ace group.admin command.mbt_emote_menu allowThe scene table is created on first boot — there is no .sql file to run.