Helios Rust Console Bot Documentation

/product role and grant_role

Use product role options to limit who can buy a product or to grant a Discord role after purchase.

Last updated
Maintained by
Helios RCE

Role-based product settings are configured while creating or editing shop products.

Use them when you want to:

  • limit a product to players with a certain Discord role
  • grant a Discord role automatically after a purchase
  • build VIP, donor, event-pass, or staff-only shop flows

Required Role vs Grant Role

  • required_role: only players with that Discord role can see or buy the product
  • grant_role: buying the product gives that Discord role to the player

These do different jobs. One is an access check. The other is a purchase reward.

Where You Configure It

You will usually set these options while using:

  • /product add-item
  • /product add-kit
  • /product add-cmd
  • /product edit-item
  • /product edit-cmd

product add item

Common Uses

  • VIP-only products gated by required_role
  • Event-pass products that grant a temporary Discord role
  • Staff test products hidden from normal players
  • Donor products that unlock a role after purchase

Example

/product add-item category:"VIP" name:"VIP Starter" item:"wood" quantity:5000 price:1 required_role:@VIP
/product add-cmd category:"Passes" name:"Raid Pass" price:2500 grant_role:@RaidPass

Validation Checklist

  • Test with a linked player who has the required role
  • Test with a linked player who does not have the role
  • Confirm Helios can assign the grant role if one is used
  • Make sure the Helios bot role is above any role it needs to grant

Related Pages