Troubleshooting

Installation Issues

Resource Not Starting

Symptom: Server console shows error when starting oxide-clothing.

Solutions:

1. Ensure dependencies are loaded first:

   ensure qb-core
   ensure oxmysql
   ensure PolyZone
   ensure oxide-clothing

2. Check for missing files:

   • web/dist/index.html must exist
   • Run npm run build in the web/ folder if missing

3. Verify database connection in oxmysql

Database Errors

Symptom: Errors about missing tables or columns.

Solutions:

1. Run the install script:

   source sql/install.sql

2. If migrating from qb-clothing:

   source sql/migrate.sql

3. Check MySQL user has CREATE TABLE permissions

---

UI Issues

UI Not Opening

Symptom: Nothing happens when entering a clothing store or using /skin.

Solutions:

1. Check F8 console for NUI errors

2. Verify web/dist/ folder exists with built files

3. Check fxmanifest.lua references correct paths:

   ui_page 'web/dist/index.html'
   
   files {
       'web/dist/index.html',
       'web/dist/assets/*.js',
       'web/dist/assets/*.css',
   }

4. Rebuild UI:

   cd web
   npm install
   npm run build

UI Stuck Open

Symptom: UI won't close, ESC doesn't work.

Solutions:

1. Type in chat: /e c to cancel animations
2. Reconnect to the server
3. Check for JavaScript errors in F8

Sliders Not Working

Symptom: Moving sliders doesn't change appearance.

Solutions:

1. Ensure you're using a freemode model (mp_m_freemode_01 or mp_f_freemode_01)
2. Other ped models don't support face customization
3. Check F8 for NUI callback errors

---

Appearance Issues

Appearance Not Saving

Symptom: Changes don't persist after relogging.

Solutions:

1. Check server console for database errors

2. Verify player has valid citizenid

3. Enable debug mode:

   Config.Debug = true

4. Check character_appearance table has data

Wrong Appearance After Relog

Symptom: Character looks different after reconnecting.

Solutions:

1. Ensure oxide-clothing:server:LoadAppearance is triggered on spawn
2. Check for conflicting appearance resources
3. Verify migration was successful if coming from qb-clothing

Skin Tone Not Matching Parents

Symptom: Character's skin doesn't look like selected parents.

Solutions:

1. This is a feature - skin and shape parents can differ
2. Use the skin tone slider to adjust blend
3. Select different skin parents if needed

---

Clothing Issues

Clothing Not Applying

Symptom: Selected clothing doesn't appear on character.

Solutions:

1. Check if the drawable/texture combination is valid for the ped
2. Some items are gender-specific
3. Verify character_clothing table has correct data

Props Disappearing

Symptom: Hats/glasses disappear randomly.

Solutions:

1. Check for animations that remove props
2. Entering vehicles may remove certain props
3. Use /hat or /glasses to re-enable

Outfit Not Loading

Symptom: Saved outfit doesn't apply correctly.

Solutions:

1. Check if outfit was saved with a different ped model
2. Verify outfit exists in character_outfits table
3. Some items may not be compatible across genders

---

Performance Issues

Lag When Opening UI

Symptom: FPS drops when opening customization menu.

Solutions:

1. This is normal for first open (asset loading)
2. Subsequent opens should be faster
3. Reduce graphics settings if persistent

High Memory Usage

Symptom: Memory increases over time.

Solutions:

1. Ensure UI properly closes (check NUI focus)
2. Restart resource periodically if needed
3. Check for memory leaks in browser console (F8)

---

Compatibility Issues

Conflicts with Other Resources

Symptom: Other clothing/appearance resources interfere.

Solutions:

1. oxide-clothing provides qb-clothing - remove the original
2. Check for duplicate event handlers
3. Ensure only one appearance resource handles spawn

External Resources Not Working

Symptom: Resources that used qb-clothing events don't work.

Solutions:

1. oxide-clothing handles these events:

   • qb-clothing:saveSkin
   • qb-clothing:loadPlayerSkin
   • qb-clothing:saveOutfit
   • qb-clothes:* variants

2. If using custom events, update to oxide-clothing events

Multi-Character Issues

Symptom: Appearance loads for wrong character.

Solutions:

1. Ensure character switch properly triggers appearance reload
2. Check citizenid is correct when loading
3. Verify database queries use correct citizenid

---

Debug Mode

Enable detailed logging:

-- In config.lua
Config.Debug = true

This prints:

• Event triggers with data
• Database operations
• NUI communication
• Errors with stack traces

Logs appear in F8 console with [oxide-clothing] prefix.

---

Getting Help

If your issue isn't listed:

1. Enable debug mode and check logs
2. Check F8 browser console for JavaScript errors
3. Verify database tables exist and have data
4. Check server console for Lua errors
5. Test with a fresh character

When reporting issues, include:

• Server console output
• F8 console output
• Steps to reproduce
• Resource version