Helios Rust Console Bot Documentation

/product Commands

Step-by-step guide for creating, editing, testing, and managing Helios shop products.

Overview

The /product commands are how server owners and admins build the Helios shop catalog.

Products are what players buy from /shop. A product can be a normal item, a command reward, a teleport-style product, or a product with role restrictions and cooldowns.

Use this page when you want to:

Add products to a shop category
Sell Rust Console items
Sell command-group rewards
Add products that use teleport destinations
Edit product prices, names, roles, cooldowns, and details
Remove old products
Look up product information and product IDs
Reset product cooldowns when needed

Recommended Setup Order

Build the shop in this order so you do not have to redo work later.

Configure your economy and currency
Create shop categories with /category add
Add most products with /product add
Use /product add-cmd only when the product should sell a saved command group
Use /product add-tp only when the product is tied to a teleport flow
Use /product info to verify product details
Test purchases with one controlled player
Edit pricing, cooldowns, roles, or delivery behavior if needed
Open /shop publicly after testing

Commands Covered

Command	What It Does
`/product add`	Creates most shop products and sets the main product details
`/product add-item`	Adds an item-based product when you specifically need the item-product flow
`/product add-kit`	Sells a saved Helios kit as a product
`/product add-xp`	Sells a timed personal XP multiplier (like 2x for 7 days)
`/product add-cmd`	Sells a saved command group so one product purchase can run multiple commands
`/product add-tp`	Adds a teleport-style product or destination when available
`/product edit`	Edits the main product settings
`/product edit-item`	Edits an item product (item, price, quantity, cooldowns)
`/product edit-xp`	Edits an XP boost product (multiplier, length, price)
`/product edit-cmd`	Changes the command group attached to a command-group product
`/product edit-tp`	Edits teleport product settings when available
`/product remove`	Deletes a product from the shop
`/product remove-tp`	Removes teleport product data when available
`/product info`	Shows product details and IDs
`/product cooldown-reset`	Resets cooldowns for products or product purchases

Product Types

Choose the product command based on what the player should receive.

Product Type	Use This	Best For
Normal shop product	`/product add`	Most products: items, resources, weapons, ammo, meds, components, priced shop listings, role-gated products, cooldown products
Item-specific product	`/product add-item`	Item-product flow when you specifically need it or are following an older item-only setup
Kit product	`/product add-kit`	Selling a saved Helios kit directly as a shop product
XP boost product	`/product add-xp`	Selling a timed personal XP multiplier for battle pass progression
Command group product	`/product add-cmd`	Selling a saved command group so the purchase can run multiple commands
Teleport product	`/product add-tp`	Products that send a player to a configured destination when that feature is available

If you are not sure which one to use, start with this rule:

Use /product add for most products.
Use /product add-cmd only when you want to sell a command group.
Use /product add-tp when the reward is tied to a teleport destination.
Use /product edit when the product already exists and you only need to change its shop details.

Step 1: Create A Category First

Products should be organized into categories so players can browse the shop easily.

Create categories with:

/category add

Good category examples:

Weapons
Ammo
Resources
Kits
Vehicles
Event Rewards
VIP

After the category exists, you can add products to it.

Step 2: Plan The Product

Before creating the product, decide:

Product name
Category
Price
Product type
Cooldown, if it should not be bought repeatedly
Required role, if only certain players should see or buy it
Grant role, if buying the product should give the player a Discord role
Server, if the command asks you to choose one
Delivery method: normal product, command group, or teleport

Example plan:

Category: Resources
Product name: 10k Wood
Type: normal product
Price: 250
Cooldown: 10 minutes

Another example:

Category: Kits
Product name: PvP Kit
Type: command group product
Price: 1500
Command: kit givetoplayer "pvp" "{PlayerName}"
Cooldown: 24 hours

Step 3: Add A Normal Product With `/product add`

Use /product add for most shop products.

/product add

Use this for products like:

kits
items
chests
keys
discord roles

Example:

/product add 
category:"Resources" 
name:"10k Wood" 
command:inventory.giveto "{PlayerName}" wood 1000
price:250

After creating it, open /shop and confirm the product appears in the right category.

product add

Step 4: When To Use `/product add-item`

Most public shop products should start with /product add.

Use /product add-item when you want to sell an item instead of a kit, like Wood

/product add-item

If both /product add and /product add-item can create the product you want, use /product add-item since its easier to use.

product add item

Optional Parameters:

quantity = amount to give
server = only sell on 1 server
server-colldown = server wide cooldown per use
cooldown = cooldown between uses
role - Required roel to purchase
can specify quantity = Yes / No if the player can specify the quantity
bypass bag = skip /bag and use immedatly after purchase

Sell A Kit With `/product add-kit`

Use /product add-kit to sell a saved Helios kit directly, without building a command group first.

/product add-kit category:"Kits" name:"PvP Kit" kit:"pvp" price:1500 cooldown:720

Optional parameters work the same as /product add-item (server, cooldowns, required role, bypass bag, trader value).

Sell A Timed XP Boost With `/product add-xp`

Use /product add-xp to sell a timed personal XP multiplier. While the boost is active, the buyer earns multiplied battle pass XP.

/product add-xp category:"Boosts" name:"2x XP - 7 Days" multiplier:2x expires_after:7d price:5000

Required parameters:

multiplier = XP multiplier, like 2x, 2.5x, or 3x (must be greater than 1x)
expires_after = boost length, like 12h, 1d, 7d, or 30d

Optional parameters work the same as other product commands (server, cooldown, required role, trader value). Set bypass_bag:True to activate the boost immediately on purchase instead of adding it to /bag.

The boost timer starts when the player uses the product, not when they buy it.
Boosts expire automatically when the time runs out.
Edit an existing boost with /product edit-xp — change the multiplier, length, price, category, or any other setting.

Step 5: Sell A Command Group With `/product add-cmd`

Use /product add-cmd only when the product should run a saved command group.

A command group can contain multiple commands. That is the reason to use /product add-cmd: one product purchase can trigger a full command group instead of one normal product action.

/product add-cmd

Command group products are useful for:

Kits
VIP rewards
Event rewards
Custom item bundles
Multiple commands in one purchase
Rewards that need several server actions
Anything that should reuse a command group you already built

Before using /product add-cmd, build the command group first:

/cmd group add
/cmd add

Example command group:

Group name: pvp_kit
Command 1: kit givetoplayer "pvp" "{PlayerName}"
Command 2: inventory.giveto "{PlayerName}" "syringe.medical" 3

Then use /product add-cmd to sell that command group as a product.

When the player buys the product, Helios runs the command group attached to that product.

Step 6: Add A Teleport Product

Use /product add-tp when the product is tied to a teleport destination or teleport-style shop flow.

/product add-tp

Use this when your product should send the player to a specific location instead of giving an item or kit.

After creating a teleport product, test it with one controlled player before announcing it public.

Choose Custom Position to add your in game position
Choose Monument for quick monument coordinates

product add tp

Step 7: Use Roles Carefully

Some product options can control who can buy the product or what role a player receives after purchase.

Common role uses:

Required role: only players with that Discord role can access or buy the product
Grant role: buying the product grants a Discord role to the player

Examples:

A VIP Kit product that only VIP players can buy
A Raid Pass product that grants an event role after purchase
A staff-only test product hidden from normal players

Use role-gated products carefully. Always test with a linked player account that has the expected role.

Step 8: Add Cooldowns

Cooldowns stop players from buying the same product too often.

Use cooldowns for:

Kits
High-value resources
Explosives
Teleports
Event rewards
Anything that can be abused if bought repeatedly

Examples:

Starter kit: 24 hours
PvP kit: 12 hours
10k wood: 10 minutes
Teleport product: 5 minutes

After setting a cooldown, buy the product once on a test account and confirm the cooldown behaves the way you expect.

Step 9: Review Product Info

Use /product info to inspect a product after you create or edit it.

/product info

Use this to confirm:

Product name
Product category
Price
Product ID
Cooldown
Required role
Grant role
Delivery type
Command or teleport settings, when applicable

Product IDs are especially useful when resetting cooldowns or troubleshooting a specific product.

Step 10: Edit Products Later

Use /product edit when the main shop listing needs to change.

/product edit

Common edits:

Name
Price
Category
Description
Cooldown
Required role
Grant role

Use /product edit-item when an item product needs a different item, price, quantity, or cooldown.

/product edit-item

Use /product edit-xp when an XP boost product needs a different multiplier, length, or price.

/product edit-xp

Use /product edit-cmd when a command-group product needs to point at a different command group.

/product edit-cmd

Use /product edit-tp when teleport product settings need to change.

/product edit-tp

After any edit, use /product info and then test the product in /shop.

Step 11: Remove Products

Use /product remove when a product should no longer be sold.

/product remove

Use /product remove-tp when removing teleport product data or teleport-specific product setup.

/product remove-tp

Before removing a product, check whether players still expect it to exist, especially if it is part of an event, VIP perk, or wipe setup.

Step 12: Reset Product Cooldowns

Use /product cooldown-reset when a product cooldown needs to be cleared.

/product cooldown-reset

Common reasons to reset cooldowns:

You tested a product and need to clear the test cooldown
You changed a product's cooldown policy
A player purchase failed and staff needs to retry it
A wipe or event reset should clear old cooldowns

Use /product info first if you need the product ID for a specific product.

Complete Walkthrough: Add A Wood Product

This example creates a normal product players can buy from /shop.

Create or confirm the category:

/category add

Category name:

Resources

Add the product with /product add:

/product add category:"Resources" name:"10k Wood" item:"wood" price:250 server:"US Main"

Review it:

/product info

Test it:

/shop

Buy the product with one controlled player and confirm the reward is delivered correctly.

Complete Walkthrough: Add A Kit Product

This example creates a command-group product that gives a kit and extra meds to the player who buys it.

Create or confirm the category:

/category add

Category name:

Kits

Create a command group:

/cmd group add

Group name:

pvp_kit

Add commands to the group:

/cmd add

Example commands:

kit givetoplayer "pvp" "{PlayerName}"
inventory.giveto "{PlayerName}" "syringe.medical" 3

Add the command group product:

/product add-cmd

Choose the pvp_kit command group when the command asks which group the product should sell.

Review it:

/product info

Test it from the player shop:

/shop

Buy the product with one controlled linked player and confirm the command group runs for the correct player.

Suggested Product Examples

Category	Product	Type	Notes
Resources	`10k Wood`	Item	Good early economy product
Ammo	`128 Rifle Ammo`	Item	Use cooldowns if ammo is valuable
Kits	`Starter Kit`	Command group	Use `/product add-cmd` only if the kit is built as a command group
Kits	`PvP Kit`	Command group	Add a longer cooldown
Vehicles	`Rowboat`	Command or teleport-style flow	Test placement before public use
VIP	`VIP Kit`	Command	Use required role if only VIP players should buy it

Requirements

Before using /product commands, make sure:

Helios is connected to at least one server in this Discord
You have permission to run admin commands
The economy and currency are configured
Shop is enabled in /settings server
At least one category exists
You selected the correct server when using the server: option
The item shortname or command you enter is valid
Any role-gated products are tested with linked player accounts

Notes

Most admin commands require Manage Server permission
Free tier can still have category or product limits
Use /product info after creating or editing products
Test expensive products before opening the shop publicly
Use cooldowns for kits, explosives, teleports, and high-value items
Use /product add for most products
Use /product add-cmd only when selling a saved command group
Create the command group before using /product add-cmd
Use /product add-tp for teleport-style products when available
Be careful with role-gated products; test with the same kind of player who will use them
Remove old products when they are no longer part of the current wipe or shop economy