House of Noir

Configuration

All config lives in shared/config.lua. Options are grouped below by category.

Core Settings

Key	Values	Description
Config.Framework	"esx" / "qb" / "qbox" / "autodetect"	Framework to use. `"autodetect"` is recommended.
Config.Interaction	"ox-target" / "qb-target" / "textui"	How players interact with the ped to open the shop.
Config.Account	"black_money" / "cash" / "bank"	Account used for regular item purchases.
Config.VipSystem	"builtin" / "wasabi"	`"builtin"` uses the included vip_coin item. `"wasabi"` delegates to wasabi_vipshop.
Config.VipAdminAce	string	Ace permission required to use admin coin commands. Default: `"eclipsys.vipcoins"`.
Config.BlackListedJob	table	Job names denied shop access entirely (e.g. `{'police', 'sheriff'}`).
Config.AllowedFemalePeds	table	Ped model names that pass the female check. Default: `{'mp_f_freemode_01'}`.
Config.WaterMark	true / false	Toggle watermark visibility in the shop UI.
Config.Debug.Prints	true / false	Enable debug output to the server/client console.

Adding Shop Items

Items are organized under Config.Categories. Each entry supports an optional quantity field for bundle purchases.

shared/config.lua

Config.Categories = {
    ['Weapons'] = {
        { name = 'weapon_pistol',  label = 'Pistol',   price = 8000  },
        { name = 'weapon_smg',     label = 'SMG',      price = 15000 },
    },
    ['Ammo'] = {
        -- quantity = 500 means player receives 500x per cart unit
        { name = 'ammo_pistol', label = 'Pistol Ammo', price = 500, quantity = 500 },
    },
}

Adding VIP Exclusives

VIP items live under Config.VipExclusives and use coin_price instead of a cash price.

shared/config.lua

Config.VipExclusives = {
    { name = 'WEAPON_EXAMPLE', label = 'Example Gun', coin_price = 200 },
}

Female ped whitelist

Add any additional female ped model names your players use. The default only includes the standard freemode model.

shared/config.lua

Config.AllowedFemalePeds = {
    'mp_f_freemode_01',
    -- add more female ped models here as needed
}

Admin commands

Restricted by the ace permission in Config.VipAdminAce. Grant access in your server.cfg:

server.cfg

add_ace group.admin eclipsys.vipcoins allow
add_principal license:xxxxxxxx group.vip_admin

Command	Arguments	Description
/give_vipcoins	[player id] [amount]	Give VIP coins to a player
/remove_vipcoins	[player id] [amount]	Remove VIP coins from a player
/check_vipbalance	[player id]	Check a player's current coin balance

All three admin commands work identically regardless of whether VipSystem is set to "builtin" or "wasabi" — the script routes to the correct backend automatically.

Installation

Changelog