Configuration

All options are in config.lua.

General

Option	Default	Description
`Config.Debug`	`false`	Extra debug logging
`Config.Locale`	`'en'`	Locale file from `locales/`
`Config.Brand.logo`	`'logo.png'`	Logo file in `web/build/` (see Installation)
`Config.Brand.name`	`'Nexra'`	Brand name shown in the UI

Framework & interaction

Option	Default	Description
`Config.Framework`	`'auto'`	`auto`, `qbx_core`, `qb-core`, `es_extended`, `standalone`, or `custom`
`Config.Command`	`'outfitbag'`	Place command — only used when `Framework` is `standalone`
`Config.Interact`	`'target'`	`target` or `textui`
`Config.ItemName`	`'outfitbag'`	Inventory item name
`Config.PropModel`	`xm_prop_x17_bag_01b`	World bag prop model
`Config.MaxOwnedBags`	`1`	Max placed bags a player can own at once

Bag lock

Option	Default	Description
`Config.BagLock.DefaultLocked`	`false`	If `true`, newly placed bags start locked (owner-only use)

Shared bag outfits

Option	Default	Description
`Config.SharedBagOutfits.Enabled`	`false`	Allow others to view / equip outfits from unlocked bags
`Config.SharedBagOutfits.GenderCheck`	`true`	Only show outfits for matching gender models
`Config.SharedBagOutfits.MaleModels`	`mp_m_freemode_01`	Male freemode models
`Config.SharedBagOutfits.FemaleModels`	`mp_f_freemode_01`	Female freemode models

Placement

Option	Default	Description
`Config.Placement.PlaceDuration`	`1800`	Place progress duration (ms)
`Config.Placement.PickupDuration`	`1500`	Pickup progress duration (ms)
`Config.Placement.InteractionDistance`	`2.0`	Interact distance
`Config.Placement.StreamDistance`	`75.0`	Bag stream / render distance
`Config.Placement.PlaceOffset`	`vec3(0.0, 0.85, 0.0)`	Offset in front of the player when placing
`Config.Placement.BagHeadingOffset`	`0.0`	Extra heading applied to the placed bag
`Config.Placement.Animation.dict`	`'pickup_object'`	Place / pickup animation dictionary
`Config.Placement.Animation.clip`	`'pickup_low'`	Place / pickup animation clip

Progress cancel

Option	Default	Description
`Config.Progress.Enabled`	`true`	Enable place / pickup progress bars
`Config.Progress.cancelControl`	`73`	Control index (default X)
`Config.Progress.cancelKey`	`'X'`	Displayed cancel key

Preview

Live ped preview layout when the bag UI is open. Adjust these if the preview sits wrong for your resolution or UI scale.

Option	Default	Description
`Config.Preview.Screen`	`x/y/w/h` values	Screen region for the preview
`Config.Preview.Depth`	`3.4000`	Preview depth
`Config.Preview.Ped.zOffset`	`0.1000`	Preview ped height offset
`Config.Preview.Ped.headingOffset`	`-2.0000`	Preview ped heading offset
`Config.Preview.Backdrop.*`	size / position / alpha	Backdrop behind the preview ped
`Config.Preview.Camera.*`	distance, height, fov, ease, etc.	Preview camera settings
`Config.Preview.PoseAnimation`	dict / clip	Idle pose on the preview ped
`Config.Preview.PieceAnimations`	mask / hat / shirt / pants / shoes	On / off animations for piece toggles

Back prop

Optional bag prop attached while the player is carrying the item. Disabled automatically in standalone mode.

Option	Default	Description
`Config.BackProp.Enabled`	`true`	Show the carried bag prop
`Config.BackProp.model`	`hei_p_f_bag_var20_arm_s`	Attached prop model
`Config.BackProp.bone`	`24816`	Attachment bone
`Config.BackProp.pos`	`vec3(-0.11, -0.05, -0.03)`	Attachment position
`Config.BackProp.rot`	`vec3(3.62, 89.8, 191.8)`	Attachment rotation

Providers

Integrations auto-detect from started resources. To force a provider, set it in config.lua:

Config.Framework = 'qb-core'
Config.Inventory = 'ox_inventory'
Config.Clothing = 'illenium-appearance'
Config.Target = 'ox_target'
Config.Notifications = 'ox_lib'

Or use:

Config.Providers = {
    framework = 'qbx_core',
    inventory = 'ox_inventory',
    clothing = 'illenium-appearance',
    target = 'ox_target',
    notifications = 'ox_lib',
}

Configuration

On this page