WardenCoredocs
Discord Bot

Pack Shop

Set up a coin-based item shop in Discord

The Pack Shop lets players spend coins to buy item packs through Discord. When a player makes a purchase, the items are delivered directly to them in-game. The shop works through both interactive buttons and text commands.

Overview

The shop flow works like this:

  1. Admins create packs in the panel (each pack contains items and has a coin price)
  2. Pack embeds are published to a Discord channel (with buy buttons)
  3. Players browse the embeds and click Buy Now or use the !buy command
  4. Coins are deducted and items are delivered in-game

Players must have a linked account and be online in-game to make purchases.

Setting Up the Shop

Create packs in the panel

Go to the pack management section in the WardenCore panel. Create your packs by defining:

  • Name -- a short identifier used in commands (e.g., AK47, Medkit)
  • Display Name -- the name shown in the shop embed
  • Description -- what the pack contains
  • Price -- how many coins the pack costs
  • Items -- the actual game items included in the pack
  • Image -- an image for the shop embed (optional)
  • Category -- group packs into categories for easier management

Configure shop settings

In Settings > Discord > Bot-Shop, configure the global shop settings:

  • Shop Cooldown -- minimum time (in seconds) between purchases for each player. Default is 15 seconds. This prevents rapid-fire buying.
  • Max Packs Per Order -- the maximum number of packs a player can buy in a single !buy or !cart command. Default is 5.

Publish packs to Discord

Use admin commands to publish pack embeds to a Discord channel:

  • !listpack AK47 -- publishes a single pack embed
  • !listcat Weapons -- publishes all enabled packs in a category

Each embed includes a Buy Now button and displays the pack name, price, and image.

How Players Buy Packs

Using the Buy Button

  1. The player finds the pack embed in the shop channel
  2. They click the Buy Now button
  3. The bot checks their balance, deducts the coins, and delivers the items in-game
  4. A confirmation message appears

Using Text Commands

Players can also buy packs with commands:

!buy AK47

To buy multiple of the same pack:

!buy AK47 3

To buy multiple different packs in one order:

!cart AK47 Medkit Ammo

The !cart command checks the total cost upfront, deducts all coins at once, and delivers each pack. If any pack fails to deliver, its coins are refunded.

Advanced Pack Features

Packs support several advanced features configurable through the panel:

Buy Limits

Limit how many times a player can buy a specific pack within a time window. For example, 3 purchases per 60 minutes.

Required Roles

Restrict a pack to players who have a specific Discord role. Players without the role cannot buy it.

Role Discounts

Give percentage discounts to players with specific Discord roles. For example, VIP members get 20% off.

Shop Visibility

Each pack has a Shop Enabled toggle. When disabled, the pack is hidden from the shop and cannot be purchased — but it can still be used for rewards, daily packs, and claim codes.

Daily Pack

The Daily Pack is a free reward players can claim once every 24 hours. Configure it in the panel under Settings > Discord > Bot-Shop > Daily Pack.

Enable the Daily Pack

Toggle the Daily Pack to Enabled.

Set the coin reward

Enter the number of coins players receive when they claim. Set to 0 to give no coins.

Select a pack (optional)

Choose a pack to deliver along with the coins. Leave empty to give coins only.

Save

Click Save. Players can now type !daily to claim their reward.

Players must be online in-game when they type !daily. The 24-hour cooldown starts from the moment they claim.

Admin Daily Management

Admins can reset daily cooldowns:

  • !cleardaily 76561198012345678 -- reset cooldown for one player
  • !cleardaily all -- reset cooldown for all players

Claim Codes

Admins can create redeemable codes that give players specific packs. This is useful for giveaways, rewards, and promotions.

Create a code:

!createcode AK47 true 5 7

This creates a code for the AK47 pack, sends it via DM (true), allows 5 uses, and expires in 7 days.

Players redeem codes with:

!claim ak47-ABCDEF123456

The code embed includes a Claim button for easy redemption.

Common Issues

Not enough coins

The player needs more coins to make the purchase. Admins can give coins with !addcoins 500 76561198012345678. Players earn coins through the daily pack, welcome pack, and other server activities.

Cooldown active

Players must wait between purchases. The default cooldown is 15 seconds. You can change this in Settings > Discord > Bot-Shop. For buy limit cooldowns, admins can reset them with !clearbuylimit.

Account not linked

The player must link their Discord and Steam accounts before buying. Direct them to the welcome embed or have an admin use !link. See Account Linking.

Items not appearing in-game

The player must be online in-game when purchasing. If items still do not appear, the player can try relogging. Check the WardenCore logs for pack execution errors.

Must be online to purchase

Both !buy and !daily require the player to be connected to the game server. The bot checks online status before processing any purchase.

On this page