Illenium-Appareance re design

Illenium Appearance

A comprehensive player customization script for FiveM servers with advanced features including clothing management, blacklist system, and modern UI.

๐ŸŽฎ How to Use

For Players

Open the Appearance Menu:

  • Use the command configured by your server admin

  • Access through clothing stores or designated areas

  • Use the radial menu (if enabled)

Customize Your Character:

  • Face Features: Adjust facial characteristics

  • Hair & Beard: Choose hairstyles and facial hair

  • Clothing: Select from available clothing items

  • Accessories: Add hats, glasses, watches, etc.

  • Tattoos: Apply tattoos to different body parts

For Admins

Blacklist Manager Access:

  • Type /wl in chat (shortcut command)

  • Type /blacklistmanager in chat

  • Press F9 key

Close the Manager:

  • Press ESC key

  • Click the X button in the top-right corner

๐Ÿšซ Blacklist Manager

Adding Blacklist Items

  1. Select Gender (Male/Female)

  2. Choose Category (Components/Props/Hair)

  3. Click "Add Item" on any subcategory

  4. Fill in the required fields:

    • Drawables: Clothing item IDs (e.g., 4, 5, 6)

    • Textures: Texture variation IDs (e.g., 0, 1, 2)

  5. Set Restrictions (at least one required):

    • Jobs: Specific job names (e.g., police, ambulance)

    • ACEs: Permission names (e.g., admin, vip)

    • Citizen IDs: Select from online players or enter manually

    • Leave empty: Automatically blacklists for everyone

  6. Click "Add Item" to save

Managing Blacklist Items

  • Edit: Click the pencil icon on any item

  • Delete: Click the trash icon on any item

  • Save Changes: Click "Save Changes" in the top header

๐Ÿ”ง Features

Appearance System

  • Character Customization: Full body customization

  • Clothing System: Extensive clothing options

  • Tattoo System: Apply tattoos to different body parts

  • Hair & Beard: Multiple hairstyle options

  • Accessories: Hats, glasses, watches, bracelets

  • Real-time Preview: See changes instantly

Blacklist System

  • Smart Restrictions: Control who can wear specific items

  • Job-Based: Restrict to specific jobs (police, ambulance, etc.)

  • Permission-Based: Restrict to players with specific ACE permissions

  • Player-Specific: Restrict to specific player Citizen IDs

  • Global Blacklist: Blacklist items for everyone

User-Friendly Interface

  • Modern Design: Clean, intuitive interface

  • In-Game Notifications: All feedback appears in-game

  • Player Selection: Easy dropdown to select online players

  • Real-Time Updates: Changes apply immediately

  • Responsive Design: Works on different screen sizes

Categories Available

  • Components: Masks, Upper Body, Lower Body, Bags, Shoes, etc.

  • Props: Hats, Glasses, Ear Accessories, Watches, Bracelets

  • Hair: Hair styles for both genders

  • Face Features: Facial characteristics and overlays

  • Tattoos: Various tattoo categories and designs

๐Ÿ“‹ Requirements

For Using the Appearance System

  • Server Framework: Works with QBCore and ESX

  • Permissions: May require specific permissions for certain features

For Using the Blacklist Manager

  • Admin Permissions: Only administrators can access

  • Server Framework: Works with QBCore and ESX

For Adding Blacklist Items

  • Drawables: Required (clothing item IDs)

  • Textures: Required (texture variation IDs)

  • Restrictions: At least one type (Jobs, ACEs, or Citizen IDs)

๐ŸŽฏ Examples

Blacklist Police Hat for Everyone

  • Drawables: 15

  • Textures: 0, 1, 2

  • Leave restrictions empty โ†’ Blacklists for everyone

Restrict VIP Clothing to VIP Players

  • Drawables: 25, 26, 27

  • Textures: 0

  • ACEs: vip

Restrict Gang Clothing to Specific Players

  • Drawables: 10

  • Textures: 0, 1

  • Citizen IDs: ABC123, DEF456

Character Customization

  • Face: Adjust nose, eyes, mouth, jaw

  • Hair: Choose from multiple hairstyles and colors

  • Clothing: Mix and match different clothing items

  • Accessories: Add hats, glasses, watches

  • Tattoos: Apply tattoos to arms, chest, back, etc.

๐Ÿ”” Notifications

All notifications appear in-game:

  • Green: Success messages

  • Red: Error messages

  • Blue: Information messages

No browser popups or alerts - everything stays in-game!

๐Ÿ›ก๏ธ Security

  • Admin-Only Access: Only administrators can use the blacklist manager

  • Server-Side Validation: All checks happen on the server

  • Permission System: Integrates with your server's permission system

  • Protected Core: Core functionality is protected from modification

๐Ÿ†˜ Troubleshooting

Appearance Menu Issues

Can't open the appearance menu?

  • Check if you're in a designated area

  • Try the configured command

  • Contact your server administrator

Changes not saving?

  • Make sure you confirm your changes

  • Check that you have proper permissions

  • Ensure you're not in a restricted area

Blacklist Manager Issues

Can't open the blacklist manager?

  • Check if you have admin permissions

  • Try the /wl command

  • Contact your server administrator

Items not saving?

  • Make sure you click "Save Changes" in the top header

  • Check that you filled in required fields

  • Ensure you have proper permissions

Need to close quickly?

  • Press ESC key

  • Use /emergencyclose command if stuck

General Issues

Script not working?

  • Check if the script is properly installed

  • Verify all dependencies are installed

  • Contact your server administrator

Performance issues?

  • Check your graphics settings

  • Ensure you have sufficient system resources

  • Contact your server administrator

๐ŸŽจ Customization Tips

For Players

  • Experiment: Try different combinations of clothing

  • Save Outfits: Use the outfit system to save your favorite looks

  • Check Restrictions: Some items may be restricted based on your job or permissions

  • Ask for Help: Contact admins if you need access to specific items

For Admins

  • Plan Restrictions: Think about which items should be restricted

  • Use Jobs: Restrict items to specific jobs for roleplay

  • Test Changes: Always test blacklist changes before applying to production

  • Document Changes: Keep track of what items are restricted and why

๐Ÿ“ž Support

If you need help with the appearance system or blacklist manager:

  1. Check this documentation first

  2. Contact your server administrator

  3. Check server forums or Discord for community help


Note: This script is designed for FiveM servers. Contact your server admin for specific configuration and access permissions.

Last updated