House of Noir

Installation

No SQL required. Drop the resource, configure, add your inventory items, and start.

Steps

Copy the resource

Place the eclipsys_blackmarket folder into your server's resources directory.

Add to server.cfg

Add ensure eclipsys_blackmarket after your framework and ox_lib.

Configure

Open shared/config.lua and set your framework, interaction type, account, and VIP system. See the Configuration page for all options.

Set ped location(s)

Open server/location.lua and set your ped spawn coordinates and heading. Use a female model to match the script theme.

Add items to your inventory

Make sure every name value in Config.Categories and Config.VipExclusives exists in your inventory resource. If using the built-in VIP system, also add the vip_coin item — see below.

Restart your server

Full server restart recommended on first install.

server.cfg

# framework (one of):
ensure es_extended
# ensure qb-core
# ensure qbx_core

ensure ox_lib
ensure ox_inventory   # or your inventory of choice
ensure eclipsys_blackmarket

VIP coin item (built-in system only)

If you're using Config.VipSystem = "builtin", add this entry to your ox_inventory/data/items.lua:

ox_inventory/data/items.lua

['vip_coin'] = {
    label       = 'VIP Coin',
    weight      = 0,
    stack       = true,
    close       = false,
    description = 'House of Noir VIP currency',
},

Ped location

server/location.lua

local BlackMarket = {
    [1] = {
        ped     = 'a_f_y_business_02',   -- keep models female
        coords  = vector3(-456.98, 1092.09, 327.55),
        heading = 90.0
    },
}

Ped locations are defined and managed entirely server-side. Clients cannot extract spawn coordinates from this file.

Troubleshooting

"Please try again in a moment..." — Ped model not registered yet. Wait ~5 seconds after spawning before attempting to open the shop.

"Ladies only" message — Your current ped model is not listed in Config.AllowedFemalePeds. Add the model name to the list.

UI not opening — Make sure you are within ~5m of the ped.

Items not appearing in shop — Make sure every item name in Config.Categories exists in your inventory resource.

VIP tab not working — If using "builtin", ensure vip_coin is registered in ox_inventory. If using "wasabi", ensure wasabi_vipshop is running. Enable Config.Debug.Prints = true to trace issues.

Overview

Configuration