Kits

A kit is a group of items the player receives in a SINGLE purchase. Unlike a lootbox, the player receives EVERYTHING included in the kit.

---

How to create a kit

1. Admin panel → Catalog → Create product
2. Product type: Kit
3. In the "Kit contents" block, add items:

Each item in the kit:
├── ID — unique identifier
├── Name — shown to the player
├── Image (optional) — CDN URL
└── Payload — what is delivered in-game

Supported payload types within a kit:

Type	What is delivered	Example
item	Item via RCON	AK-47 × 1
currency	Currency (scrap, etc.)	1000 scrap
command	RCON command	addgroup {player} vip
recipe	Blueprint	Blueprint × 1

---

Qty (quantity)

Each item in the kit has its own quantity:

• item: qty — number of units (e.g. 64 bullets)
• currency: amount — currency units (e.g. 1000 scrap)
• command/recipe: always 1 (qty is not applicable)

---

Item images in a kit

The storefront resolves images in three ways (by priority):

1. Custom imageUrl — if the store owner uploaded an image manually
2. Rust CDN — for item entries with a rustItem.id specified, the storefront uses cdn.tirify.shop/rust-items/{id}.png
3. Placeholder — if no source yields an image, a standard icon from the Icons set is shown

Do not use rustclash.com

Icons from wiki.rustclash.com/item/... are hotlink-protected (403 error). Always provide your own imageUrl or rely on our CDN.

---

How the player sees a kit

On the storefront a kit is displayed as follows:

1. Product tile — standard card, same as any product
2. Quick-view — clicking opens a dialog with details
3. "Kit contents" section — icon grid with names and quantities

In the account area (after purchase) — a table of delivered items with status.

---

Example: Rust starter kit

Item	Type	Qty
AK-47	item	1
5.56 Ammo	item	128
Wood	item	5000
Stone	item	5000
VIP status (command)	command	1

Price: 500 ₽. The player receives everything in a single purchase.

---

Limits

• Minimum 1 item, maximum 50 items per kit
• cooldownSeconds and perPlayerLimit apply to the ENTIRE kit, not to individual items

---

Next steps

• Lootboxes — random delivery
• Presets — ready-made product templates