Suty
Shower System

Troubleshooting

Troubleshooting

The HUD doesn't show on screen

Check these in order:

  1. showHUD = true in config/main.lua → Config.HygieneSystem. It defaults to false.
  2. useCustomPanel = true — if it's false, values go to qbx_hud instead of the built-in HUD.
  3. You restarted the resource while already in-game. The HUD pulls its config when the NUI loads, but make sure you're fully spawned (past character select). If it still doesn't appear, do a clean restart suty-shower and rejoin once.
  4. You hid it earlier. The hide state is saved per player. Open /hudstyle → "Mover / Ocultar HUD" → click the 👁 eye to bring it back.

The HUD is stuck off-screen / can't drag it to the edge

Update to the latest build — older versions counted the edit toolbar's width in the drag boundary, which blocked the HUD from reaching the right edge. Current builds float the toolbar out of the layout so the HUD can be dragged to any edge. You can also reset its position with the ↺ button in the move toolbar.

/hudstyle says "El HUD está desactivado por el servidor"

That's the showHUD = false (or useCustomPanel = false) guard. Enable both in config/main.lua to use the picker.

I can't shower — "No hay una ducha cerca"

  • You must be within Config.ShowerDistance (default 2.5 m) of a recognised shower prop.
  • The prop must be listed in Config.ShowerProps (config/shower.lua). Use /checkshower to see what the script detects nearby, and add the prop hash if it's missing.

I can't shower — "Debes estar dentro de una casa"

Config.Shower.requireHouse = true requires you to be inside a house/shell. Either go inside, set requireHouse = false, or add the prop to Config.PublicShowerProps so it bypasses the house check (like the prison shower).

"Necesitas jabón para ducharte"

You need the soap item (jabon by default) in your inventory. Confirm the item exists in ox_inventory/data/items.lua and that config/items.lua → Config.Items.soap matches its name.

Water effect is in the wrong place on a custom shower

Run /positionwater near the prop, nudge the effect with the arrow keys / PgUp-PgDn / numpad ±, press ENTER to save, and copy the printed offset into that prop's entry in Config.ShowerProps.

Brushing teeth does nothing

  • You need the toothbrush_paste item in your inventory.
  • Confirm Config.DentalSystem.enabled = true in config/dental.lua.

Deodorant/perfume says "Necesitas ducharte primero"

Deodorant and perfume require a minimum cleanliness to apply (minHygieneRequired, default 50). Shower first, then apply.

attempt to index a nil value (global 'MySQL')

oxmysql must start before suty-shower, and @oxmysql/lib/MySQL.lua must be loaded as a server script (it already is in the shipped manifest). Fix your server.cfg ensure order: ensure oxmysql before ensure suty-shower.

Still stuck?

Open a ticket on Discord with:

  • Your Config.Framework value and framework
  • Whether the issue is the HUD, showering, or the dental track
  • F8 console output (client) or server console errors