How to add new Deliveries

This guide explains how to add new delivery services and items to RTX Housing System.

Delivery configuration is located in:

configs/deliveries.lua

You will usually edit three main sections:

• Config.Deliveries – delivery services & items

• Config.Dancers – dancer NPC definitions (Dancers service only)

• Config.DancerDances – dancer animation list (optional)

---

1) Delivery Service Structure (Config.Deliveries)

Each delivery service is defined as a table inside Config.Deliveries.

Service fields explained

• id Unique delivery service identifier Used internally and must be unique (except dancers, see below).

• name Service name shown in UI.

• description Short description shown in UI.

• useCart Enables shopping cart system (multiple items in one order).

• allowQuantity Allows ordering multiple quantities of the same item.

• icon FontAwesome icon used in UI.

• items List of purchasable items.

---

2) Delivery Items (standard items)

Each item inside a service contains:

• id Item name given to the player after delivery. Must exist in your inventory system.

• title Item name shown in UI.

• description Short description shown in UI.

• price Item price.

Rules

• Item id must be unique inside the service

• Item id must be a valid inventory item

Example: Standard delivery service (click to expand)

{
    id            = "cluckinbell",
    name          = "Cluckin’ Bell",
    description   = "When hunger strikes, Cluckin’ Bell delivers the knockout.",
    useCart       = true,
    allowQuantity = true,
    icon          = "fa-drumstick-bite",

    items = {
        { id = "chickenburger", title = "Cluckin’ Big Burger", description = "Two patties, zero clucks given", price = 32 },
        { id = "cluckinfries",  title = "Cluckin’ Fries",      description = "Salted by tears",               price = 10 },
    }
},

---

3) DANCERS delivery service (special rules)

Important — special service

• The delivery service ID MUST ALWAYS BE:

id = "dancers"

• You CANNOT create new dancer delivery categories

• You can ONLY add or edit items inside the existing dancers service

Dancer items rules

Each dancer item:

• id → must be unique

• id → links directly to Config.Dancers

• image → required

• useImage = true → required

Example: Dancer item

{ 
    id = "dancer1",
    title = "Fufu",
    description = "The queen of slow grinds",
    price = 500,
    image = "img/dancers/dancer1.webp",
    useImage = true
},

---

4) Define dancer NPCs (Config.Dancers)

Each dancer must exist in Config.Dancers.

Fields explained

• model → ped model name

• componentvariations → clothing / component setup

The key must match the dancer item id.

Example: Dancer definition

Config.Dancers = {
    ["dancer1"] = {
        model = "s_f_y_stripper_02",
        componentvariations = {
            [1] = {componenttype = 2, drawableid = 2, textureid = 0, paletteid = 0},
        }
    },
}

---

5) Add more dances (Config.DancerDances)

You can add unlimited animations for dancers.

Each entry contains:

• animdict

• animname

Example: Adding a new dance

Config.DancerDances[7] = {
    animdict = "mini@strip_club@private_dance@part2",
    animname = "priv_dance_p2",
}

---

Restart & test

1

Restart housing

Run:

restart rtx_housing

2

Open delivery menu

Open the delivery menu inside a property.

3

Test

• ordering items

• cart system (if enabled)

• dancer spawning & animations

---

Common mistakes

• Creating another dancers service (ID must be dancers)

• Missing dancer definition in Config.Dancers

• Item ID does not exist in inventory

• Duplicate service IDs

---

Need help?

If you want, we can add delivery services or dancers for you. Contact us on Discord: https://discord.gg/rtxdev