Back to Features
Shop

Surprise Box

Give your players the thrill of opening a mystery box β€” with fully customizable items and prices.

The Surprise Box system lets you create loot boxes with different packages. When a player buys one, the bot randomly selects one of the configured items and delivers it directly in-game. It's a fun and engaging way to add excitement to your economy and keep players coming back for more.

Key Highlights

  • Random Item Selection β€” Each Surprise Box contains multiple possible packages. On purchase, the bot draws one and delivers it to the player in-game β€” they never know what they'll get
  • Customizable Price β€” Set the price in BotCoins for each box independently, giving you full control over your economy
  • One-Click Purchase β€” Players buy directly from the Discord shop with a single click β€” no commands needed
  • In-Game Delivery β€” Items are delivered instantly via WebSocket to the player's character in SCUM
  • Repurchase Cooldown β€” Set a waiting time (in minutes) to control how often a player can buy the same box. Set zero for unlimited purchases
  • Raid Hour Lock β€” Optionally block Surprise Box purchases during raid hours to keep focus on PvP
  • Custom Images & Descriptions β€” Each box has its own image, name, and description displayed in the Discord shop embed
  • Channel Assignment β€” Assign each Surprise Box to a specific Discord shop channel for organized presentation