Emotes Menu

Configuration

Configuration

Files you can edit

File What is in it
config.lua Every setting on this page
client/customanims.lua Your own emotes — see Custom emotes
client/animations.lua The full emote list
locales/*.lua Particle-effect prompt texts in 29 languages

These files are not encrypted. Restart the resource (or the server) after a change.

Language

Config.MenuLanguage = 'es'

Language of the particle-effect prompts ("Press G to…"), read from locales/. Available: ar, cs, da, de, el, en, es, fa, fi, fr, hu, id, it, lk, lt, nl, no, pl, pt, ro, ru, sl, sq, sr, sv, tr, vi, zhcn, zhtw. A text missing in your language falls back to English.

The menu's own labels (category names, footer hints, the request card) are in Spanish in this version.

Look

Config.Theme     = 'dark'                              -- 'dark' | 'light'
Config.MenuImage = "https://your-cdn.com/banner.gif"   -- banner on top of the menu
Option Default What it does
Config.Theme 'dark' Dark glass card or light card
Config.MenuImage Suty banner Any GIF / PNG / JPG link, ideally a wide banner (about 512×128). Set nil or '' to show the built-in logo and "EMOTES" title instead

Menu

Config.MenuKeybind  = 'F3'
Config.MenuPosition = 'right'
Config.PreviewPed   = false
Option Default What it does
Config.MenuKeybind 'F3' Default key for the menu
Config.MenuPosition 'right' Side of the screen where the preview ped stands ('left' or 'right'). The menu itself always sits on the right
Config.PreviewPed false true shows a copy of your character next to the menu, playing the highlighted emote. Only you see it

FiveM saves keys per player. Changing a default key later only reaches players who never set it themselves; everyone else changes it in Settings → Key Bindings → FiveM.

Cancelling

Config.EnableXtoCancel = true
Config.CancelKey       = 'X'

true registers /emotec on the X key to stop the current emote. /e c always works, whatever you set here.

Emote behaviour

Config.AllowedInCars = true
Config.DisarmPlayer  = false
Option Default What it does
Config.AllowedInCars true Emotes inside vehicles (upper body only). false blocks them with a notification
Config.DisarmPlayer false true puts your weapon away when an emote starts

Aiming or dying always stops the current emote.

Shared emotes

Config.SharedEmotesEnabled = true

false stops players from sending shared emote requests. How requests work is on the Commands page.

Walk styles and moods

Config.PersistentWalk       = true
Config.PersistentExpression = true
Option Default What it does
Config.PersistentWalk true Saves the chosen walk style on the player's PC and re-applies it every minute, so it survives respawns and clothing changes
Config.PersistentExpression true Saves the chosen mood (facial expression)

A saved walk style or mood comes back when the player joins.

Optional keys

All off by default. Turn on the ones you want:

Feature Switch Key option Default key Command
Hands up Config.HandsupEnabled Config.HandsupKeybind Y /handsup
Pointing Config.PointingEnabled Config.PointingKeybind B /point
Crouch Config.CrouchEnabled Config.CrouchKeybind LCONTROL /crouch
Crawl Config.CrawlEnabled Config.CrawlKeybind RCONTROL /crawl
Ragdoll Config.RagdollEnabled Config.RagdollKeybind U /ragdoll

Two extra options:

Config.HandsupInCar    = true   -- allow hands up inside a vehicle
Config.RagdollAsToggle = true   -- true = press to fall, press again to get up | false = hold the key
  • Crouch is skipped automatically while qbx_smallresources is running (it has its own crouch).
  • Key names use FiveM's keyboard names: F3, X, Y, LCONTROL, RCONTROL, CAPITAL…

Notifications

Config.NotificationSystem = 'qbcore'

-- Only used when NotificationSystem = 'custom'
Config.CustomNotification = function(message, type)
    -- type is 'success', 'error' or 'info'
    -- exports['my-notify']:Notify(message, type)
end
Value Shows the message with
'qbcore' (default) QBCore notify (QB-Core, and QBX through its QBCore layer)
'qbox' ox_lib notification
'ox' ox_lib notification
'esx' ESX notification
'native' GTA notification above the minimap
'chat' Chat message
'custom' Your Config.CustomNotification function

Any other value falls back to 'native'.

Colours

Config.UIColors = {
    Primary       = "#ff5e7e",   -- accent colour
    TextPrimary   = nil,         -- main text
    TextSecondary = nil,         -- secondary text
    TextMuted     = nil,         -- muted text
    -- Background, SelectionBg, HoverBg, IconFavorites, IconCustom, IconDances, IconEmotes,
    -- IconProps, IconShared, IconMalePoses, IconFemalePoses, IconExpressions, IconWalks, IconCancel
}
  • Primary is the accent (selected row, highlights).
  • The three text colours use the theme's own colours when left at nil.
  • Background, SelectionBg, HoverBg and the Icon… keys are kept so older configs load; the current theme ignores them.

Notification texts

Config.Locale = {
    ['request_sent']     = 'Solicitud enviada',
    ['request_accepted'] = 'Solicitud aceptada',
    ['request_declined'] = 'Solicitud rechazada',
    ['too_far']          = 'Muy lejos del otro jugador',
    ['favorite_added']   = 'Emote agregado a favoritos',
    ['favorite_removed'] = 'Emote eliminado de favoritos',
    -- ...
}

These six keys are the ones in use. The other keys in the table are not used in this version.

Custom emotes

Add your own animations in client/customanims.lua. They show in a Custom category and play with /e <name> like any other emote.

RP.CustomEmotes = {
    -- simple
    ["mywave"] = {"anim@mp_player_intcelebrationmale@wave", "wave", "My Wave"},

    -- with options
    ["myidle"] = {"anim_dict", "anim_name", "My Idle",
        AnimationOptions = {
            EmoteLoop     = true,    -- loop the animation
            EmoteMoving   = true,    -- allow walking while it plays
            EmoteDuration = 5000,    -- ms, -1 = until cancelled
        }
    },

    -- scenario
    ["mylean"] = {"Scenario", "WORLD_HUMAN_LEANING", "My Lean"},
}

RP.CustomProps = {
    ["mysmoke"] = {"amb@world_human_leaning@female@wall@back_smoking@idle_a", "idle_a", "My Smoke",
        AnimationOptions = {
            EmoteLoop     = true,
            Prop          = "prop_cs_ciggy_01",
            PropBone      = 28422,
            PropPlacement = {0.0, 0.0, 0.0, 0.0, 0.0, 0.0},   -- x, y, z, rotX, rotY, rotZ
        }
    },
}
  • RP.CustomDances takes the same format as RP.CustomEmotes.
  • Up to 5 props per emote: Prop, SecondProp, ThirdProp, FourthProp, FifthProp, each with its own …Bone and …Placement.
  • A wrong animation dictionary or prop name doesn't crash anyone: F8 shows Anim dict invalido or Prop invalido with the name to fix. A bad dictionary skips the emote; a bad prop plays the emote without it.
  • Entries in RP.CustomShared play as solo emotes in this version. To add a real shared emote, add the pair (initiator + partner) to RP.Shared in client/animations.lua, following the entries already there.

Emote list

client/animations.lua holds the full list and is open. Delete any entry you don't want and restart.

The list includes the 18+ emotes from rpemotes-reborn (28 entries marked AdultAnimation = true). There is no switch to hide them; remove them from the file if you don't want them.

Options without effect in this version

Option Note
Config.SearchEnabled The search box is always shown
Config.ExpressionsEnabled The moods category is always shown
Config.WalkingStylesEnabled The walk styles category is always shown
Config.KeybindSlots There are no emote quick slots — players can bind emotes with FiveM's bind command (Commands)
Config.FavKeybindEnabled / Config.FavKeybind Registers /favemote (Caps Lock), which plays the player's first favorite, but the menu has no way to add favorites yet

Merry Christmas.

From Suty.