Rpemotes-reborn is a community-driven FiveM emote menu allowing players to express themselves in roleplay with custom animations, countless facial expressions, walk styles, and props.

Rpemotes-reborn is free, and will always be free: accept no substitutes or reproductions from scummy people reselling other's hard work against agreements made with creators. We're committed to the open-source community and the dozens of contributors who put hard work into rpemotes to provide the community with free emotes and props.

Want to help support them? Check out our credits section at the bottom of the Readme and support those creators!

Interested in joining our community? You can find our Discord here.

Features 🛠️

• Emote Preview & Placement - View and place emotes before using them!

• Customizable Banner (Change the image, text, and text color)

• Emote Search Function 🔎

• Community contributed custom animations 🕺

• Group emotes: Dance, salute, and more with 2 or more people

• Exit Emotes: Exit out of emotes with smooth transitions

• Persistent Facial Expressions and Walkstyles via client KVP

• Easily convert Menyoo to RPEmotes 🔄

• Hide Adult Emotes 🔞

• Hide Animal Emotes ⛔

• Animal Emotes 🐩

• Shared Particle Effects: emotes with smoke effects, fire, and more 💨

• QB-Core + ESX Framework & KVP Keybinding Support ⚙️

• Support for shared and couple poses/animations 👫

• Persistent Disabling Of Idle Camera via KVP 🎥

• Easy To Understand Configuration File ⚙️

• Props Extractor for anti-cheat scripts 💾

• Crouching 🐞

• Crawling 🐛

• Finger Pointing 👆

• Ragdoll 😵

• Hands up 🙌

• Working Binoculars 👀

• News Camera 🎤📹

Available in the following languages:

Albanian, Brazilian Portuguese, Chinese (Simplified), Chinese (Traditional), Czech, Danish, Dutch, English, Finnish, French, German, Greek, Hungarian, Indonesian, Italian, Lithuanian, Norwegian, Persian, Polish, Romanian, Russian, Serbian, Sinhala, Slovenian, Spanish, Swedish, Turkish, Vietnamese

Languages can be selected and/or added in the config.lua.

All languages were translated or contributed by the FiveM community, with the odd exception of using Google Translate.

English is the original language and will always be up to date with correct translations. Otherwise, German is currently the only translation which is complete and verified by a native speaker. Other translations might be incomplete or partially lacking in quality. English is used as a fallback for missing translations. Compare your language file to the English one to find and add missing translations.

If you find any incorrect translations or would like to add more languages, please make a pull request with the corrections.

Exports and Documentation

Find our documentation here

The rpemotes-reborn resource has the following exports:

exports["rpemotes-reborn"]:EmoteCommandStart(emoteName, textureVariation) -- deprecated, prefer Execute() below
exports["rpemotes-reborn"]:Execute(emoteName, emoteType, textureVariation) -- plays any emote type through its native handler
exports["rpemotes-reborn"]:EmoteCancel(forceCancel) – forceCancel is optional
exports["rpemotes-reborn"]:IsPlayerCrouched()
exports["rpemotes-reborn"]:IsPlayerProne()
exports["rpemotes-reborn"]:StopPlayerProne(force) -- force is optional
exports["rpemotes-reborn"]:GetPlayerProneType() -- returns the type of prone the player is in, either "onfront" or "onback"
exports["rpemotes-reborn"]:IsPlayerCrawling()
exports["rpemotes-reborn"]:IsPlayerPointing()
exports["rpemotes-reborn"]:IsPlayerInAnim() -- returns current animation name or nil
exports["rpemotes-reborn"]:IsPlayerInHandsUp()
exports["rpemotes-reborn"]:toggleBinoculars()
exports["rpemotes-reborn"]:toggleNewscam()
exports["rpemotes-reborn"]:getWalkstyle() -- Gets walk style of player, used to detect certain walk. useful for applying effects while doing certain walks like tripping or other "funny" effects.
exports["rpemotes-reborn"]:setWalkstyle(name, force) -- name = "move_m@alien" or any other, force = optional bool. Lets you set or force a walk style, useful for scripts like retrieving a style before drinking and restoring it after sobering up.
exports["rpemotes-reborn"]:toggleWalkstyle(bool, message) -- bool to allow the user to change their walkstyle in the menu or not / message to show the user (optional, default is :"You are unable to change your walking style right now.")"
exports["rpemotes-reborn"]:GetEmoteCatalog() -- Returns the merged emote list (emotes, shared, expressions, walks, emojis)

GetEmoteCatalog() is a client export intended for external menu resources. It returns nil, "catalog_not_ready" until the animation list has been converted, then a cached list (rebuilt only when the list is reconverted), so it is safe to call repeatedly. The result is a flat array of every emote, shared emote, expression, walk and emoji. Each entry carries name and emoteType plus the internal fields the conversion pass produced (dict, anim, label, scenario, AnimationOptions, ...); emoji entries carry name, emoteType and emoji (the glyph). The shape mirrors rpemotes' internal data, so consumers adapt it to their own view model.

Having issues with players using emotes when/where they're not supposed to? Use the following where needed. This would be somewhere like if you want to disable emotes in jail or when someone is handcuffed/escorted. We've also added one for blocking emote cancels!

LocalPlayer.state:set('canEmote', false, true) -- Blocks players from emoting
LocalPlayer.state:set('canEmote', true, true) -- Allows players to emote

LocalPlayer.state:set('canCancel', false, true) -- Blocks players from using emote cancel
LocalPlayer.state:set('canCancel', true, true) -- Allows players to use emote cancel

Menu Keybind 🎛️

The keybind uses RegisterKeyMapping. By default the configured keybind in the initial config.lua will be the default key, however once the keybind is set for a user it'll remain and can be changed in the users settings under Esc > settings > keybinds > fivem.

Menu key:

COMMAND:	ACTION:
F4	Open / Close RPEmotes menu

Server owners can change this in the config.lua.

Alternatively, the player base can set their menu keybind to open rpemotes-reborn

Esc > settings > keybinds > fivem

• More keybinds are now using key mappings which means that they are now available in your FiveM settings to change (RagdollKeybind)

Keybinds 🎛️

To use the features, enable the setting in config.lua

Keybinding = false,

Alternatively, you can use the keybind command that comes with FiveM without having to use SQL, by entering the following into F8:

bind keyboard "Yourbutton" "e youremote". To remove the keybind, type "unbind keyboard "Yourbutton".

Menu Customization: Header

To edit the header, find the image in the main directory of rpemotes-reborn and edit the image in your program of choice. The image dimensions are 512 x 128.

Do not change the name of the image file.

Example Banner:

Note for users of older versions of rpemotes: Previously, the banner was hosted through a web link on an image hosting website. Due to various image hosting sites dealing with large amounts of traffic from FiveM, they cut off access to FiveM.

Menu Customization: Title

In theconfig.lua file, server owners can set the MenuTitle or simply leave it blank. Ideally, this should be 11 characters or less without any spaces. You can also set the font and decide whether or not you want an outline and MenuPosition. The available fonts are as follows:

    -- 0 : Chalet London
    -- 1 : House Script
    -- 2 : Monospace
    -- 4 : Chalet Comprime Cologne
    -- 7 : Pricedown

Additional customizations can be found in the config. Please note due to limitations by Imgur and Discord; images can not be directly linked from either platform. You may link directly to an image from the forums, or just leave it blank.

Increments

Pressing 'LEFT ALT' on the keyboard allows players to scroll through the menu one by one, or by 10.

Alternatively, players can use the SHARE button on an Xbox controller or OPTIONS button on a Playstation controller.

Ragdoll 🥴

• To enable ragdoll, change RagdollEnabled = false, to true in config.lua.

• Much like the menu key, RagdollKeybind is also using RegisterKeyMapping. It is currently set to U by default (server side) however can be set to the player's preferred keybind in the FiveM keybinds setting found in the settings menu within the Esc Menu.

• New setting: RagdollAsToggle, this will make either the ragdoll be a toggle or a hold key

Finger Pointing & Hands Up 👆

Once enabled, players can press B on the keyboard to enable standalone finger pointing, and Y to put their hands up, without the need for unnecessary frameworks or "small resources".

Much like everything else in the menu, server owners can change these keybinds to their own preferences.

COMMAND:	ACTION:
B	Toggle Finger Pointing
Y	Toggle Hands Up
/pointing	Toggle Finger Pointing
/handsup	Toggle Hands Up

Crouching & Crawling

Crouching:

RIGHT CONTROL. Players can move forward, back, left, and right as well as turn around. Press SPACEBAR to switch from stomach to back. Pressing the RIGHT CONTROL key while running will have the player "dive into" a crouching animation.

Crawling:

Server owners can opt in to either overriding the stealth/action animation when pressing the LEFT CONTROL keybind or have players tap LEFT CONTROL twice to switch from stealth to crouch (when enabled in the config.lua file)

Chat Commands

COMMAND:	ACTION:
LEFT CONTROL	Toggle Crouching On / Off
RIGHT CONTROL	Toggle Crawling On / Off
/crouch	Toggle Crouching On / Off
/crawl	Toggle Crawling On / Off

---

Moods & Walkstyles 😜🚶‍♂️

Moods and walk styles can be set from the menu. These will save to your character and reapply when exiting a vehicle, or loading back into the server as they are saved via client-side KVP.

COMMAND:	ACTION:
F4	Opens RPEmotes menu
/walks	See A List Of Walkstyles In Chat
/moods	See A List Of Walkstyles In Chat
/reset mood	Remove preferred mood and set default
/reset walk	Remove last walkstyle and set default

Having problems with users "abusing" certain walk styles? rpemotes-reborn checks if a user has an "abusable" walk style saved and clears it when a player joins. Alternatively, you can use a resource like rpemotes-punishment to trip players abusing these emotes.

Just want to remove them? Delete the following walk styles from Animationlist.lua:

Bigfoot, Hurry, Hurry2, Hurry3, Flee, Flee2, Flee3, Flee4, and Flee5

No Idle Animations or Idle Cam 📷

By default, we ship empty idle animation overrides in rpemotes-reborn that stop default male and female peds from playing GTA's random idle "fidget" animations like scratching, nose-picking, and weight-shifting while standing still.

To re-enable them, delete the following folder: stream/[Custom Emotes]/noidleanimations/

No Idle Cam allows players to disable the idle camera animation on f