esx_animations

esx_animations is a client-side emote menu for ESX Legacy. Players open it with F3, pick a category and play an animation, a GTA scenario (smoking, fishing, taking photos) or a walking style. It ships with a NUI interface and can fall back to the classic esx_context menu.

OverviewCopy Anchor Link

InstallationCopy Anchor Link

ensure es_extended
ensure esx_context
ensure esx_animations

No database changes are needed.

Usage in gameCopy Anchor Link

The keys are registered with RegisterKeyMapping, so each player can change them under Settings, Key Bindings, FiveM. The menu does not open while the player is dead. While the NUI is open, several controls (F2, F3, F4, F6, F7, Enter and exit vehicle) are disabled so other menus do not open behind it.

ConfigurationCopy Anchor Link

The default categories are festives, greetings, work, humors, sports, misc, attitudem (walk styles) and porn (adult gestures). Remove the last one if it does not fit your server.

Config.Animations formatCopy Anchor Link

Config.Animations = {
    {
        name  = 'greetings',     -- unique id of the category
        label = 'Greetings',     -- shown in the menu
        items = {
            { label = 'Hello', type = 'anim', data = { lib = 'gestures@m@standing@casual', anim = 'gesture_hello' } },
            { label = 'Smoke', type = 'scenario', data = { anim = 'WORLD_HUMAN_SMOKING' } },
            { label = 'Confident', type = 'attitude', data = { lib = 'move_m@confident', anim = 'move_m@confident' } },
        }
    },
}

TranslationsCopy Anchor Link

The labels in config.lua are English. The localization folder contains complete replacement configs: br, cs, de, en, fi, it, nl, pl, ru, sl, sr and sv (for example de_config.lua). Copy the one you need over config.lua. The NUI language follows the esx:locale convar.

Client exportsCopy Anchor Link

GetConfigCopy Anchor Link

local config = exports.esx_animations:GetConfig()

Returns the full Config table of the resource, including Config.Animations.

SetConfigCopy Anchor Link

exports.esx_animations:SetConfig(newConfig)

SetConfig replaces the table instead of merging it, so always start from GetConfig():

local config = exports.esx_animations:GetConfig()

config.Animations[#config.Animations + 1] = {
    name = 'gang',
    label = 'Gang',
    items = {
        { label = 'Lean on wall', type = 'scenario', data = { anim = 'WORLD_HUMAN_LEANING' } },
    }
}

exports.esx_animations:SetConfig(config)

The change is client-side only and lasts until the resource restarts. Run it on every client, for example on esx:playerLoaded.

Common issuesCopy Anchor Link

• Animation does nothing: the dictionary or clip name is wrong. Check the name with a tool such as the FiveM natives reference or an animation list.
• Walk style sticks after /cleartasks: walk styles are not tasks. Apply a different attitude entry, or call ResetPedMovementClipset in your own code.
• Menu looks like the old ESX menu: Config.UseNui is false.

RelatedCopy Anchor Link

• esx_context
• Streaming module
• Addons overview

Frequently asked questions