Cut Players Hair
Troubleshooting
Troubleshooting
Common issues
| Symptom | Fix |
|---|---|
Boot fails with FATAL: resource must be named "suty-shave" |
You renamed the folder. Rename it back to exactly suty-shave. |
| The resource doesn't start | ox_lib must start before suty-shave, and OneSync must be on. |
| «Necesitas la maquinita para recortar» while carrying it | The item name must match Config.ShaveItem, and the inventory must have restarted after you added it. |
| Using the clipper does nothing (ox_inventory) | The entry needs client.export = 'suty-shave.useClipper' and consume = 0. Restart ox_inventory after editing items.lua. |
| Using the clipper does nothing (qb-inventory / ESX) | The item must exist in qb-core/shared/items.lua (with useable = true) or in the ESX items table. Don't register another usable item for it. |
| «Recortar» doesn't show when aiming at a player | Config.UseTarget = true, the target in Config.TargetSystem must be running, and the clipper must be in your hand (use it from the inventory). With ShaveConditions set, the option only shows on players who meet them. |
| «Saca la maquinita: úsala desde el inventario» | With Config.RequireInHand = true, take the clipper out with the item before shaving. |
| «El jugador tiene que tener las manos arriba» / «… estar esposado» | Config.ShaveConditions requires that pose. Hands up = the usual hands-up animations. Cuffed = qbx_police / qb-policejob cuffs. |
| «Tienes que estar al lado del jugador» | Get right next to the other player and try again. |
| Nothing happens on a second shave right after the first | The shaver's cooldown is running (Config.Cooldown, 120 s). |
| The other player never gets the request | Config.ShaveConditions.consent is false, so no request is sent: with every condition off, the shave starts without asking. |
| Nobody can shave a certain player | That player is in Config.VIPLicenses with Config.WhitelistEnabled = true. |
You use Config.UseTarget = false and the item only takes the clipper out |
Also set Config.RequireInHand = false: then using the item shaves the closest player. |
| The item image doesn't show | Copy install/ox_inventory/hairclipper.png to ox_inventory/web/images/ (or qb-inventory/html/images/). |
| The shaved player gets their hair back | The lock only lasts Config.ShaveHairLockSeconds (20 min by default). After that it's normal. |
| The shaved player gets another hairstyle instead of bald | Your hair pack uses another number for bald. Set it in Config.BaldHair, separately for male and female. |
/recorteperm doesn't work for an admin |
They must be in the ACE group of Config.AdminGroup (default group.admin), for example add_principal identifier.license:YOUR_LICENSE group.admin. |
| Grants are gone after a restart | Config.PersistGrants = false. Set it to true. |
| «Recortar» shows but other players can't hear the trimmer | The sound fades with distance and is silent at Config.SoundDistance (30 m). Check Config.SoundVolume too. |
Verifying the install
- Boot banner: the server console shows the SUTY SHAVE banner with the version and
Loaded. - Item: give yourself
hairclipper. It shows its image. - In hand: use it. The clipper appears in your right hand.
- Target: aim at another player. Recortar shows.
- Shave: both players play the animation and hear the trimmer. The shaved player ends up bald.
- Lock: the shaved player visits a barber. Their hair is removed again while the lock lasts.
Reporting a bug
Open a ticket on Discord with:
- Your framework, inventory and target, with their versions
- The full F8 / server console error
- Your
config.lua(mask any VIP licenses) - Exact steps to reproduce
