esx_accessorymanager
esx_accessorymanager adds a radial wardrobe to ESX Legacy for taking off and restoring clothing and props. Config keys, client exports, F11 keybind and setup.
esx_accessorymanager is a client-only radial menu that lets players take off and put back the clothing and props they are currently wearing: hat, glasses, mask, watch, top, pants, shoes and more. Use it when you want a quick wardrobe toggle (for example "take off mask") without building outfits or shops.
Not in the official docs
This addon is not covered on docs.esx-framework.org. Everything below is taken from the resource source.
Overview
| Resource | esx_accessorymanager |
| Side | Client only (NUI) |
| Dependencies | esx_lib, es_extended, skinchanger |
| Database | None |
| Open with | F11 key mapping or /accessories |
| Supported peds | mp_m_freemode_01 and mp_f_freemode_01 only |
The radial menu has 13 sectors: watch, glasses, mask, necklace, earrings, pants, shoes, top (with arms), hat, bag, undershirt, bracelet and vest. The center button restores everything removed by this resource. Two extra tools are available:
- Fix accessories reapplies all current props from the skin, useful when a hat or glasses visually disappear.
- Fix hair toggles the hairstyle to drawable
0(for example to hide hair under a helmet) and back to the saved hairstyle and colors.
Removing a vest only hides the drawable. It does not change gameplay armor.
The menu refuses to open (or closes itself) while the player is dead, ragdolling, falling, cuffed, in the pause menu, has LocalPlayer.state.invBusy set, already has NUI focus, or sits in a vehicle (unless allowed).
Installation
No SQL file. Start it after its dependencies:
ensure esx_lib
ensure es_extended
ensure skinchanger
ensure esx_accessorymanagerThe NUI ships prebuilt in html/, there is no build step.
Configuration
All keys live in config.lua.
| Key | Default | Description |
|---|---|---|
Config.Locale | GetConvar('esx:locale', 'en') | Locale for labels. English and Spanish are included; missing keys fall back to English. |
Config.EnableControls | true | Registers the accessorymanager key mapping. The /accessories command exists either way. |
Config.Radial.Command | 'accessories' | Chat command that toggles the menu. |
Config.Radial.DefaultKey | 'F11' | Default key of the key mapping. Players can rebind it in the FiveM settings. |
Config.Radial.ActionCooldown | 350 | Minimum milliseconds between two wardrobe actions. |
Config.Radial.AllowInVehicle | false | Allow opening the menu inside a vehicle. |
Config.Radial.Undressed.male | { tshirt = 15, torso = 15, arms = 15, pants = 61, shoes = 34 } | Drawables used when a male freemode ped takes off these items. |
Config.Radial.Undressed.female | { tshirt = 15, torso = 15, arms = 15, pants = 15, shoes = 35 } | Same for the female freemode ped. |
Config.Radial.Animation.Enabled | true | Play a clothing animation before each change. |
Config.Radial.Animation.Timeout | 500 | Milliseconds to wait for the animation dictionary to load before skipping the animation. |
Config.Radial.Animation.Duration | 900 | Fallback animation length in milliseconds. |
Config.Radial.Animation.Flag | 49 | Fallback animation flag. |
Config.Radial.Animation.Default | { dict = 'clothingshirt', anim = 'try_shirt_positive_d' } | Animation for categories without an own entry (tshirt). |
Config.Radial.Animation.ByCategory | per category | Per category { dict, anim, flag, duration }. helmet uses separate on and off clips. repairHair is used by the Fix hair button. |
Items other than tops, undershirts, pants and shoes are removed by setting drawable 0 (components) or clearing the prop (-1). If you run a custom clothing pack where 15, 61 or 34 are real clothes, adjust Undressed.
Client exports
OpenAccessoryMenu
exports.esx_accessorymanager:OpenAccessoryMenu()Opens the radial menu. If it is already open, the call closes it (toggle). Does nothing when the player cannot use the menu right now.
CloseAccessoryMenu
exports.esx_accessorymanager:CloseAccessoryMenu()Closes the menu and releases NUI focus.
InvalidateWardrobe
exports.esx_accessorymanager:InvalidateWardrobe()Forgets all items removed by the menu and the Fix hair state. Call it after your own script changes the outfit without going through skinchanger:loadSkin or skinchanger:loadClothes (those two events already invalidate automatically).
Example: open the wardrobe from a radial or target menu of another resource.
RegisterCommand('wardrobe', function()
if GetResourceState('esx_accessorymanager') ~= 'started' then return end
exports.esx_accessorymanager:OpenAccessoryMenu()
end, false)Client events
| Event | Type | Description |
|---|---|---|
esx_accessorymanager:openMenu | Local event | Same as the OpenAccessoryMenu export. Use TriggerEvent, it is not a network event. |
The resource listens to esx:playerLoaded and esx:onPlayerLogout (clears state), esx:onPlayerDeath (closes the menu) and the skinchanger load events. When the resource stops, it restores every removed item if skinchanger is still running.
Security notes
The NUI only sends an action id (max 32 characters) from a fixed allowlist. Drawables, textures and models are never taken from the UI; every value is validated against the active ped with IsPedComponentVariationValid and the prop variation natives. There are no server events, so the resource cannot be abused to give items or money.
Integration tips
- esx_accessories: both can run together. esx_accessories sells and saves items; esx_accessorymanager only toggles what is worn.
- Inventories: set
LocalPlayer.state.invBusy = truewhile your inventory is open to block the radial menu. - Custom skin scripts: if you apply clothes without skinchanger, call
InvalidateWardrobeafterwards so "restore" does not bring back old items.
Common issues
- "This character model is not supported." The player uses an addon or story ped. Only the two freemode models are supported.
- Item greyed out. The item is already in its "off" state, or the off values from
Undressedare not valid for the ped. - F11 conflicts with another script. Change
Config.Radial.DefaultKey. Existing players keep their old binding until they rebind it, because FiveM stores key mappings per client.
Related
Frequently asked questions
Independent documentation
Last updated on
esx_accessories
Set up esx_accessories for ESX Legacy. Covers mask, helmet, glasses and ear shops, the datastore SQL, every config key, server events, callbacks and the J keybind.
esx_addonaccount
esx_addonaccount stores extra money accounts such as society funds in ESX Legacy. Covers SQL setup, the account object, exports, events and pitfalls.