Emotes Menu
Troubleshooting
Troubleshooting
Common issues
| Symptom | Fix |
|---|---|
Console says This resource must be named "suty-emotes" |
You renamed the folder. Rename it back to exactly suty-emotes. |
| The resource doesn't start at all | OneSync is off or the server artifact is older than 5848. Turn OneSync on and update your artifacts. |
F3 opens another menu, or /e plays animations from another script |
Another emote menu is still running. Remove rpemotes / dpemotes / similar and restart. |
F3 does nothing after you changed Config.MenuKeybind |
FiveM keeps each player's saved key. The player rebinds it in Settings → Key Bindings → FiveM, or uses /emotemenu. |
/e <name> says Emote no encontrado |
The name is wrong. Every row in the menu shows its /e name on the right. |
Some emotes don't play and F8 shows Anim dict invalido |
The animation isn't in your game build (enforce a recent sv_enforceGameBuild), or a custom emote has a typo in its dictionary. |
The emote plays without its prop and F8 shows Prop invalido |
The prop model isn't available: a typo in a custom emote, or a prop from a newer game build. |
The G prompt shows but other players don't see the effect |
They're too far away. Effects are only drawn for players close enough to see you. |
| Shared emote says No hay nadie cerca | No player within 5 m. Walk up to them. |
| Shared emote says Muy lejos del otro jugador | Get within 3 m of the other player. |
| The request card disappears by itself | It expires after 15 seconds, or the sender left the server. |
| Shared emote says Emotes compartidos deshabilitados | Config.SharedEmotesEnabled = false. |
| Hands up, pointing, crouch, crawl or ragdoll keys do nothing | They're off by default. Turn on Config.HandsupEnabled, Config.PointingEnabled, Config.CrouchEnabled, Config.CrawlEnabled or Config.RagdollEnabled. |
Crouch is on in the config but doesn't work, and F8 mentions qbx_smallresources |
By design: qbx_smallresources has its own crouch and suty-emotes leaves it to that one. |
Pressing X also triggers something from another script |
Two scripts use the same key. Change Config.CancelKey or the other script's key. |
| Walk style is gone after respawning | With Config.PersistentWalk = true it comes back within a minute. Pick it again in the menu to apply it right away. |
| Walk style or mood isn't kept after reconnecting | Config.PersistentWalk / Config.PersistentExpression is false. |
| "Press G" prompts are in the wrong language | Set Config.MenuLanguage (see Configuration). |
| The banner on top of the menu is empty | The Config.MenuImage link doesn't load. Use another link, or set it to nil for the built-in logo. |
| No notifications appear | Config.NotificationSystem doesn't match what your server runs. 'ox' / 'qbox' need ox_lib started. |
| Consumables (eat / drink) don't play their animation | The script must trigger animations:client:EmoteCommandStart or call exports['suty-emotes']. Scripts hard-wired to exports['rpemotes'] need that line changed — see Exports. |
| I want to hide the 18+ emotes | There's no switch. Delete the entries marked AdultAnimation = true from client/animations.lua. |
Verifying the install
Run these checks in order on a clean restart:
- Boot banner — the SUTY EMOTES banner appears in the server console.
- Menu — F3 (or
/emotemenu) opens the menu on the right.↑↓move,Enteropens a category. - Emote —
/e danceplays,/e cstops it. - Search — move up past the first row and type
wave: the results show up. - Shared — next to another player, pick an emote in Compartidos. They get the card and accept with
Y. - Console — in the server console,
emotes statusprints the status box.
Reporting a bug
If something is still broken after the checks above, open a ticket in our Discord with:
- Your framework (QBX, QB-Core, ESX or standalone) and server artifact
- Your
sv_enforceGameBuild - Your
config.lua - The F8 lines printed when the problem happens
- The emote name and the exact steps to reproduce it
