This guide explains how to utilize events and exports with the onex-emotes script. It assists you in opening menus, fetching data, and loading player models.
IMPORTANT NOTE ➤ You should be familiar with Lua and the basics of FiveM events and exports. It's also helpful to have some basic knowledge of HTML and CSS.
Use this event or export to open the emote menu.
return value : boolean
With this event or export, you can play any emote without needing to open the menu. It is useful for animations like eating food or other scenarios.
ARGUMENTS :
category: string
all_emotes or valid_emote_categYou can also use all_emotes as the category, so you don't need to specify each time which category your desired emote belongs to.
emote_name: stringped: number (optional)
If you set this to false, it will use the default value PlayerPedId(). To have a different player/ped play the animation, specify that player/ped.
coords: vector3 (optional)
A vector3 representing the coordinates where the emote will be played. As this is optional, you can also set it to false, which will play the emote at the player's current position.
rotation: vector3 (optional)
A vector3 representing the rotation of the player. When the emote is played, the ped's rotation will change if this value is not false/nil. You can also set it to false, which will use the player's current rotation.
Cancel playing animation.
Use this export to get whether the emote can be canceled right now.
Set the state to determine if the emote can be canceled at this moment, either by a trigger or by the player.
You can use this to block or unblock the emote from playing.
ARGUMENTS :
canplay : boolean
Use this export to know can player right now play emote or not.
ARGUMENTS :
canplay : boolean
Use this export to change current walk style.
RESET WALK STYLE :
For resetting walk style to default , pass walk_styleName argument value to reset.
walk_styleName : string --> reset
Use this to restore the walking style. If you've reset the walking style for a task and want to reapply the previously saved style, you can achieve that with this export.
Use this export to change current expression.
RESET EXPRESSION :
For resetting expression to default , pass expression_name argument value to reset.
expression_name : string --> reset
Use this to restore the face expression. If you've reset the expression for a task and want to reapply the previously saved style, you can achieve that with this export.
To access the Emotes object, inside onex-emotes/shared/emotes.lua.
This is the Emote Menu's upper section:
If a player has enabled or disabled any of these options via the menu, you can also control these settings programmatically through an event.
USE CASE: Suppose you are playing a food animation, and you need to enable or disable the movement button accordingly. You can achieve this by setting up the configuration as shown below.
If you don’t want to modify a particular setting, such as emoteloop, simply exclude it from the Settings table. For instance, if you only want to control the upperbody setting, you can do so like this:
It will help you to know the current player settings whether it's canmovealways or any other setting.
KEYS ARE:
canmovealwaysemoteloopupperbodypreviewIt will RETURN : string
Last updated 2 months ago