Open Outfit Menu

The Outfit Menu system in qs-appearance can be triggered externally from other scripts or systems using predefined events. This allows you to open the clothing menu for outfit selection or management from any custom interaction such as NPCs, commands, stores, jobs, and more.


Supported Events

You can trigger the outfit menu with the following events:

1

Native Event (qs-appearance)

This is the standard event provided by qs-appearance. It opens the outfit menu for the current player, allowing them to view, equip, rename or delete their saved outfits.

TriggerEvent('clothing:openOutfitMenu')
2

Compatibility: Illenium Appearance

If you're using systems that were originally built for illenium-appearance, you don't need to change anything. qs-appearance is fully compatible with:

TriggerEvent('illenium-appearance:client:openOutfitMenu')

This means you can use qs-appearance as a drop-in replacement without breaking compatibility in your existing server scripts or third-party resources.


Example Usage

1

From an NPC interaction:

exports['qb-target']:AddBoxZone("outfit_npc", vector3(123.4, 456.7, 78.9), 1.5, 1.5, {
    name = "outfit_npc",
    heading = 90.0,
}, {
    options = {
        {
            label = "Open Outfit Menu",
            icon = "fas fa-tshirt",
            action = function()
                TriggerEvent('clothing:openOutfitMenu')
            end
        }
    },
    distance = 2.0
})
2

From a command:

RegisterCommand("outfits", function()
    TriggerEvent('clothing:openOutfitMenu')
end)
3

From legacy Illenium integrations:

TriggerEvent('illenium-appearance:client:openOutfitMenu') -- Works identically with qs-appearance

Notes

  • You do not need to pass any parameters; the system will detect the player and context automatically.

  • Ensure the player is using a freemode ped model, or the menu may be limited.

  • This menu includes options to equip, rename, delete, and view saved outfits.

Last updated