Pack Management
Create and manage item packs for the shop, rewards, and claim codes
The Settings > Packs page lets you create and manage item packs that players can buy in the Discord shop, receive as rewards, or redeem with claim codes.
The page has three tabs: Packs, Categories, and History.
Packs Tab
This is the main list of all your packs. From here you can:
- Create a new pack — click the "New Pack" button
- Edit any existing pack
- Delete packs you no longer need
- Search by pack name
- Filter by category
- Import packs from a JSON file
Creating a Pack
Click New Pack to open the pack editor. Fill in:
| Field | Description |
|---|---|
| Name | Internal name used in commands (e.g., AK47). Must be unique. |
| Display Name | Friendly name shown in the shop embed (e.g., "AK-47 Kit"). |
| Description | Optional description shown in the shop embed. |
| Category | Group packs into categories for organization. |
| Price | Cost in coins. Set to 0 for free packs (used in rewards/codes). |
| Contents | The actions that make up this pack (see Action Types below). |
| Image | Optional image (PNG) shown in the shop embed. |
| Enabled | Whether the pack is active. Disabled packs cannot be used anywhere. |
| Shop Enabled | Whether the pack appears in the Discord shop. Disable this to hide a pack from the shop while still using it for rewards, daily packs, or claim codes. |
Action Types
The pack editor supports four action types for the Contents field:
| Type | Description | Example |
|---|---|---|
| Item | Spawn an in-game item for the player | Weapon_AK15 qty 1 |
| Vehicle | Spawn a vehicle near the player | BPC_CityBike qty 1 |
| Coins | Add coins to the player's balance | 5000 |
| Command | Execute any admin command | #TeleportToMe |
Each action can be added using the visual editor. Item and Vehicle support name, quantity, and extra arguments (e.g., AmmoCount 30). Multiple actions can be combined in a single pack.
Command type requires exact syntax
When using the Command type, the command must be written exactly as the game expects — including the correct letter case and parameter order. For example, #TeleportToMe will work but #teleporttome may not. Refer to the game's admin command list for the correct syntax.
Buy Limits
Optionally restrict how often players can buy a pack:
- Buy Limit Count — maximum purchases allowed per player in the time window
- Buy Limit Minutes — the time window in minutes (e.g., 3 purchases per 60 minutes)
Role Restrictions
- Required Role — only players with this Discord role can buy the pack
- Discount Roles — give percentage discounts to players with specific roles
Categories Tab
Organize your packs into categories. Each category has:
- Name — display name for the category
- Color — embed border color
- Sort Order — controls the display order
Use !listcat <category> in Discord to publish all packs in a category.
History Tab
View all pack purchases with filters for:
- Date range
- Player (Steam ID or name)
- Pack name
- Status (completed, failed, refunded)
- Source (shop, daily, claim, admin)
Useful for tracking sales, investigating issues, and verifying deliveries.