Suty
Slap & Groin-Kick

Troubleshooting

Troubleshooting

Common issues

Symptom Fix
Boot fails with FATAL: resource must be named "suty-slap" You renamed the folder. Rename it back to exactly suty-slap.
/slap and /patada aren't registered at all ox_lib isn't starting before suty-slap. In server.cfg, move ensure ox_lib above ensure suty-slap.
/slap runs but no animation plays Brief network hitch when loading the animation set. Try again immediately.
Animation plays but there's no sound The resource files got corrupted in your install — re-extract the package.
Other players don't hear the slap Working as designed — slap sound only plays for players within 30m. Move closer to verify.
The right-click "Bofetear" / "Patada" options don't appear Either Config.UseTarget = false, or the chosen target system (ox_target / qb-target) isn't started. Check that Config.TargetSystem matches what you have running.
Slap on target works but the receiver doesn't see the animation Receiver disconnected mid-animation, or they were out of network sync range. With OneSync Infinity this is rare; with stock OneSync, receivers must be within ~150m.
Every attempt shows "Funcion deshabilitada" Config.Enabled = false. Set it to true and restart.
Every attempt shows "No tienes permiso para usar este comando" Config.RequirePermission = true and you haven't been granted. An admin needs to run /slapperm <yourId> on.
/slapperm doesn't appear in F8 suggestions for an admin Their ACE group doesn't match Config.AdminGroup (default group.admin). Either add the admin to that group, or change Config.AdminGroup to match their existing group.
Permission grants disappear after server restart Config.PersistGrants = false. Set it to true for KVP-backed persistence.
VIP-listed player can still be slapped The VIP whitelist needs the player's license without the license: prefix. Use getplayer [id] in the server console, copy the hex string after license:, and request the update via support.
Cooldown feels like more than 2 minutes The cooldown starts at the beginning of your slap, not the end. Slap animation (~6s) + 2-minute cooldown = roughly 2:06 between back-to-back slaps. Working as intended.
Target gets pulled in at a weird angle / clips into geometry The auto-positioning rotates and offsets the receiver in front of the slapper. If you're on uneven ground, on stairs, or against a wall, the receiver may clip. Move to flat open ground and try again.

Verifying the install

Run these checks in order. Each should produce the expected result on a clean restart:

  1. Boot banner — Suty Slap ASCII art appears in the server console with v1.0.0 | Loaded. If missing, the anti-rename check halted the resource.

  2. Command registration — In F8, type /sla and /pa — both /slap and /patada should appear in suggestions with the help text from Config.CommandHelp.

  3. Admin command (if RequirePermission = true) — In F8 as an admin, type /slappe — /slapperm <id> <on|off> should appear.

  4. Animation — Walk next to another player, /slap. Both peds play the slap animation simultaneously.

  5. Sound — You + the target + anyone within 30m hears the slap. Players further away should not.

  6. Right-click (if UseTarget = true) — Aim at a player ped with your target system. "Bofetear" and "Patada" options appear within 3m.

Reporting a bug

If something is still broken after the checks above, open a ticket in our Discord with:

  • Your server framework + version (QBX vs QB-Core, plus build number)
  • Your entire config.lua (mask any sensitive admin identifiers)
  • The first 30 lines printed by suty-slap on resource start
  • Exact reproduction steps
  • Whether ox_target or qb-target is running (and which version)