Products: creation, pricing, types
A product is the core unit of the catalog. A player purchases a product with real money (via any connected payment method) or with store balance, and receives items, privileges, or commands in-game.
Creating a product
- Admin panel → your store → Catalog → "Create product"
- Fill in:
- Name — how the product appears on the storefront
- Slug — URL path for the product page (auto-generated)
- Category — product grouping
- Price — retail price
- Original price (optional) — shown with a strikethrough; the storefront calculates the discount percentage
- Choose a product type — this determines the payload form below
Product types (6 kinds)
Tirify supports 6 product types. The type determines WHAT the player receives after purchase.
Item (item)
A standard product — the player purchases it and receives the specified items or privileges on the server.
When to use: weapons, resources, privileges — any single-item products.
Kit (kit)
A group of items delivered in a single purchase. The player receives EVERYTHING at once.
- Any number of items (up to 50)
- Each item has its own quantity (qty) and image
- Displayed on the storefront as a grid of icons
When to use: starter packs, VIP packages, bundles.
Lootbox (lootbox)
Random delivery of ONE item from a pool. The player can see drop chances.
- Each item has a weight (higher weight = more frequent drop)
- Chance = item weight / sum of all weights × 100%
- Minimum 2 items, maximum 50
- Rarity: common / uncommon / rare / epic / legendary
- Odds can be hidden (
showOdds: false) — the player does not see exact chances
Animation: a spin roulette launches on the storefront. The result drops after a few seconds.
When to use: cases, lootboxes, gacha mechanics.
Recipe (recipe)
Delivers a blueprint — the player gains the ability to learn and craft an item.
- Used for Rust items that the player must research
- Requires the player to be online
When to use: blueprints, recipes, learnable items.
Variant picker (variant_picker)
A product with variants. The player selects one variant before purchasing.
- Each variant has its own name and an optional image
- Delta price: a variant can cost more or less than the base price
- Displayed on the storefront as a dropdown list or variant grid
When to use: choosing ammo count (100/500/1000), choosing resource type.
Command (command)
A service command on the server — for example, a nickname change or teleport.
When to use: simple service actions.
Product image
- Main image — shown on the storefront (tile + quick-view)
- Placeholder — if no image is uploaded, the standard Tirify logo is shown
- Rust items: if an
itemIdfrom Rust Item List is specified, the storefront pulls the icon from our CDN (cdn.tirify.shop/rust-items/{id}.png)
Stock
Each product can have a limited supply:
| Status | Meaning |
|---|---|
in_stock | Unlimited supply |
limited | Limited quantity (e.g. 50 units). Shown on the storefront |
out_stock | Sold out — the buy button is disabled |
Badges
A product can have badges that make it stand out on the storefront:
| Badge | Icon | Color |
|---|---|---|
hot | 🔥 Flame | Red |
flash | ⚡ Zap | Orange |
new | ⭐ Star | Blue |
Priority: if there is a discount (price is lower than the original price) — the discount percentage is shown. Otherwise — the badge. Otherwise — the remaining stock.
Cooldown and limits
- cooldownSeconds — minimum interval between purchases for a single player (in seconds). 0 = no cooldown. Especially important for lootboxes.
- perPlayerLimit — how many times a single player can purchase the product in total.
null= no limit. - targetServerId — if set, the product is shown only on the specified server.
null= all servers.
Next steps
- Categories — product grouping
- Kits — how to build a kit
- Lootboxes — how to configure a roulette