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

  1. Click Create Chest, give it a clear name, and save it.
  2. Expand the new chest. Its Matching Key is shown at the top.
  3. Click Add Kit, Add Rust Item, or Add Coins and choose what a player can receive.
  4. Give the reward a friendly name, set the quantity or coin amount when needed, choose a Drop weight, and save.
  5. Add the remaining rewards and check the displayed Chance before sharing keys with players.

Standard Chest with its matching key and three weighted rewards

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.

Add Reward form with Coins selected, the name Coin Jackpot, a coin amount of 500, and weight 3 - Rare

Adding a 500-coin reward to the Standard Chest on Helios Bot Testing.

FieldWhat to enter
Reward nameThe name players see, such as Coin Jackpot.
Coin amountA whole number from 1 to 2,147,483,647. It is added directly to the winner's wallet.
WeightFrom 1 - Rarest to 9 - Very common. Higher means a better chance inside this chest.
Reward image URLOptional. 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.

Standard Chest listing a Tommy Kit, a Coin Jackpot of 500 coins to wallet, 50 Rockets, and 2500 Wood with their chances and weights

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.

Real chest-opening result from Helios Bot Testing showing 50 Rockets awarded

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.

Add Treasure panel with Kit, Item, Coins, and Back buttons

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.

Add Coins Treasure form with the reward name Bonus Coins, a coin amount of 250, and a weight of 5

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.

Easy Treasure panel for the Standard Chest showing the status Added coins treasure Bonus Coins (250 coins) and five rewards with their chances

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.