Helios Rust Console Bot Documentation
Treasure & Keys
Create a chest, add weighted rewards, and give players its matching key.
- Last reviewed
- Maintained by
- Helios RCE
Open Dashboard → Treasure & Keys. This is a Premium feature and requires Manage Server permission. Chest types, matching keys, and rewards are shared across every Helios-connected game server in the same Discord community.
Build a chest
- Click Create Chest, give it a clear name, and save it.
- Expand the new chest. Its Matching Key is shown at the top.
- Click Add Kit, Add Rust Item, or Add Coins and choose what a player can receive.
- Give the reward a friendly name, set the quantity or coin amount when needed, choose a Drop weight, and save.
- Add the remaining rewards and check the displayed Chance before sharing keys with players.
This testing-server chest has weights 7, 2, and 1, giving chances of 70%, 20%, and 10%. Weights are relative: a weight of 7 does not mean 7%. Adding, removing, or changing a reward changes all of the displayed chances.
Add a coin reward
Choose Add Coins when a chest should pay currency instead of an item. A coin reward needs no kit or Rust item.
Adding a 500-coin reward to the Standard Chest on Helios Bot Testing.
| Field | What to enter |
|---|---|
| Reward name | The name players see, such as Coin Jackpot. |
| Coin amount | A whole number from 1 to 2,147,483,647. It is added directly to the winner's wallet. |
| Weight | From 1 - Rarest to 9 - Very common. Higher means a better chance inside this chest. |
| Reward image URL | Optional. The reveal keeps the image. |
After you save, the reward appears in the chest list as Coins, showing its amount ("500 coins to wallet"), Chance, and Weight. Helios uses the new treasure setup within about a minute.
Coins are weighed together with kits and items, so adding one changes every chance in the chest.
When a player opens the chest and wins coins, the amount goes straight to their wallet and appears in their balance history as a Treasure Reward. Nothing is placed in /bag. The reveal uses your community's currency name. Case Battles can also award coins together with the other reward that round.
Coins are paid in the community's wallet currency, not the Safe Pocket. Existing kit, item, and collectible rewards keep working as before, and an older collectible's worth is not turned into a coin payout.
Read the chest status
- Ready means the chest has at least one reward and can be given to players.
- Needs rewards means the chest exists but is empty. Add a kit, Rust item, or coin reward before giving out its key.
- Use Edit Chest to change its details. Use Remove Chest only when you no longer need that chest type.
Give players the matching key
Use the chest's displayed Matching Key when creating a key reward in Shop, Battle Pass, or another supported reward tool. The key type must match the chest exactly; the friendly name alone is not enough.
Players use their chest and matching key through /bag. Choose Open Chest, then select the chest and key if the bag asks. A chest that is not tied to one game server may also ask which connected server to use. Opening uses one chest and one matching key and chooses a reward from the saved pool. Kits and items are placed in the player's bag; a coin reward is paid straight into their wallet.
An actual test-server opening awarded 50 Rockets. The reward is random, so another opening may receive a different saved item.
Make sure the chest contains rewards and that any kit exists on the server where it will be claimed. The result message names the reward; open /bag again to use or manage it.
Example: Create an Event Chest with two common item rewards and one rare kit. Offer its matching key as an event prize. Check the displayed odds before announcing the chest.
If a chest will not open
Check that the player has both the chest and its matching key in /bag, the chest is marked Ready, Premium is active, and an eligible connected game server is available if Helios asks them to choose one. A chest marked Needs rewards is not ready to distribute.
Set up from Discord
Run /easy treasure for a panel with Create, Edit, List, and Remove. Choose Edit, pick a chest, and the panel lists its rewards with their type and chance.
Choose Add Treasure to pick the reward type: Kit, Item, or Coins.
Coins opens an Add Coins Treasure form with the same fields as the dashboard: Reward Name, Coin Amount (added to wallet), Weight (1 rare to 9 common), and an optional Image URL (leave it empty or type off for no image). The name can be up to 100 characters, and an image must be a full http or https link of at most 500 characters.
After you submit, Helios confirms with a private message, Added coins treasure "Bonus Coins" (250 coins)., and the chest panel lists the new reward as Coins with its updated chance.
The chest panel on Helios Bot Testing after adding a 250-coin reward. Adding it lowered every other reward's chance.
The older /treasure add command has no coin option. Use the dashboard or /easy treasure to add coins.
For command-based setup, see Chest commands and Treasure commands.






