💿Installation

📦 Installation

Before you start, make sure your server meets all the requirements listed below.

---

✅ Requirements

Dependency	Version	Notes
oxmysql	Latest	Required for database storage
ox_lib	Latest	Required for notifications and UI components
ox_target	Optional	For target-based bag interaction
qb-target	Optional	Alternative target system

If you don't use ox_target or qb-target, the script will automatically fall back to key-based interaction (G to pick up, E to open)

---

🗂️ Step 1 — Add the Resource

1. Download the resource from your Tebex keymaster

2. Extract the folder and place it inside your server's resources directory

resources/
└── [0bug]/
    └── 0bug_outfitbag/
        ├── client/
        ├── server/
        ├── html/
        ├── config.lua
        └── fxmanifest.lua

1. Add the following line to your server.cfg:

ensure 0bug_outfitbag

Make sure oxmysql and ox_lib are started before 0Bug_OutfitBag in your server.cfg.

---

🗄️ Step 2 — Import the SQL (Optional - We use auto create)

Run the following SQL in your database (via phpMyAdmin, HeidiSQL, or any MySQL client):

CREATE TABLE IF NOT EXISTS zerobug_outfits (
    id INT AUTO_INCREMENT PRIMARY KEY,
    identifier VARCHAR(100) NOT NULL,
    name VARCHAR(100) NOT NULL,
    outfit_data LONGTEXT NOT NULL,
    is_public TINYINT(1) DEFAULT 0,
    date_created TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    INDEX idx_identifier (identifier),
    INDEX idx_public (is_public)
)

---

🎒 Step 3 — Add the Bag Item

Add the outfitbag item to your inventory resource.

---

QBCore — qb-core/shared/items.lua

['outfitbag'] = {
    name = 'outfitbag',
    label = 'Outfit Bag',
    weight = 500,
    type = 'item',
    image = 'outfitbag.png',
    unique = true,
    useable = true,
    shouldClose = true,
    combinable = nil,
    description = 'A bag to store and manage your outfits.'
},

---

ESX — Insert into database

INSERT INTO `items` (`name`, `label`, `weight`, `rare`, `can_remove`)
VALUES ('outfitbag', 'Outfit Bag', 500, 0, 1);

---

ox_inventory — ox_inventory/data/items.lua

['outfitbag'] = {
    label = 'Outfit Bag',
    weight = 500,
    stack = false,
    close = true,
    description = 'A bag to store and manage your outfits.',
},

📸 Place the item image outfitbag.png (included in the resource) into your inventory's images folder

---

⚙️ Step 4 — Configure the Script

Open config.lua and set your framework:

Config.Framework = {
    enabled = true,
    type = 'QB', -- 'ESX', 'QB', 'QBox', or 'Standalone'
    multicharacter = true,
}

Set your target system (or disable for key-based):

Config.Target = {
    enabled = true,
    system = 'qb-target', -- 'ox_target' or 'qb-target'
    distance = 2.5,
    pickupKey = 'G',
    openKey = 'E',
}

See the full Configuration page for all available options.

---

▶️ Step 5 — Start & Test

1. Restart your server (or use ensure 0Bug_OutfitBag in the console)

2. Give yourself the item in-game:

/giveitem [playerid] outfitbag 1

1. Use the item from your inventory to place the bag

2. Press F4 or type /clothing to open the wardrobe

✅ If the UI opens and the bag appears in the world, you're good to go!

---

❗ Troubleshooting

The bag item doesn't work / nothing happens when I use it

• Make sure the item is registered correctly in your inventory resource

• Confirm oxmysql and ox_lib are started before 0Bug_OutfitBag

• Check your server console for any Lua errors

Target interaction doesn't appear on the bag

• Verify your Config.Target.system matches your installed target resource

• Make sure ox_target or qb-target is started before 0Bug_OutfitBag

• If neither is installed, set Config.Target.enabled = false to use key interaction