Skip to main content

Cases

Cases are randomized loot boxes members can buy with credits. When a member opens a case, they receive one of the roles you've added to it — chosen randomly based on the weights you set. Unlike the shop, the outcome is unknown until opening.

Cases add a layer of excitement on top of the regular shop — members who've already bought what they want still have a reason to keep accumulating credits.

Cases Example Case Opening

Limits​

  • Free servers: up to 3 cases, up to 3 items per case
  • Premium servers: up to 10 cases, up to 10 items per case

Creating a Case​

/cases manage   — open the interactive cases manager (mod/admin only)

In the manager, click Create and fill in:

  • Name — max 25 characters (free) / 50 characters (premium)
  • Price — 1–1,000,000 credits
  • Stock — a positive integer or the word infinite
  • Description (optional) — max 50 characters (free) / 100 characters (premium)

After creating the case, add roles to it (see below). A case must have at least 2 items before it appears in the shop.

Adding Items to a Case​

/cases item add <case_name> <role> <weight>
/cases item edit <case_name> <role> <new_weight>
/cases item remove <case_name> <role>

Weight is a positive integer. Higher weight = more common. The chance of receiving an item is item_weight ÷ total_weight_of_all_items.

Example:

/cases item add "Starter Box" @Bronze 50
/cases item add "Starter Box" @Silver 30
/cases item add "Starter Box" @Gold 20

→ Bronze: 50%, Silver: 30%, Gold: 20%

Role Hierarchy

Same as the shop: the bot needs Manage Roles permission and its role must be above the roles in the case. Fix in Server Settings → Roles.

Where Members Purchase​

Once a case has at least 2 items, it appears automatically in /shop view alongside regular shop items. Members buy and open cases from the same interface.

Validation Rules​

  • Price: integer between 1 and 1,000,000
  • Stock: positive integer up to 1,000,000, or infinite
  • Weight: any positive integer

Troubleshooting​

Bot can't assign the role: Bot needs Manage Roles, and its role must be above the role being awarded.

Case doesn't appear in shop: Cases need at least 2 items added before they're listed.

Case shows as disabled: Free servers are limited to 3 cases. Cases beyond that are disabled until you upgrade or remove others.