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:

  1. Boot banner — the SUTY EMOTES banner appears in the server console.
  2. Menu — F3 (or /emotemenu) opens the menu on the right. ↑ ↓ move, Enter opens a category.
  3. Emote — /e dance plays, /e c stops it.
  4. Search — move up past the first row and type wave: the results show up.
  5. Shared — next to another player, pick an emote in Compartidos. They get the card and accept with Y.
  6. Console — in the server console, emotes status prints 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

Merry Christmas.

From Suty.