/category add, edit, remove

Overview

Categories are the sections players see in /shop, such as Resources, Kits, and Ammo. Make the category first, then add products to it.

What are Categories?

• Categories keep /shop easy to browse.
• Good names describe what a player is buying, not how you built it.

Examples: Ammo, Kits, Resources, Vehicles, and VIP.

After creating a category, add its products with /product add-item or the product command that fits the reward.

Setup Flow

1. Run /category add.
2. Give the category a short, clear name.
3. Set its position if you want it to appear in a specific order in /shop.
4. Add a required Discord role only when the whole category should be private.
5. Add products and test the category with a linked player.

Position is the order players see in /shop.

Required role controls who can open the category. A product inside a restricted category can still have its own separate required role.

If both are set, the buyer must have both roles. For example, a VIP category with a Supporter product requires VIP and Supporter, not either one. These are access rules, not roles the purchase awards. See Shop Role Requirements and Role Rewards.

To remove a category's role restriction, use /category edit and select @everyone for required_role. Leaving the option out keeps the existing role rule; it does not clear it. Removing the category restriction does not remove restrictions on its products.

Edit a category

Use /category edit when you need to change the name, position, required role, or its availability delay. A delay temporarily pauses the category until the time you choose. Use it for an event shop or a wipe-day category you are not ready to open yet.

If the command offers Bypass Bag, only turn it on when the products in that category are safe to deliver immediately. Otherwise, leave it off so players can claim their reward from /bag when they have room.

Before changing access or delivery, use /category info to review the products. Make sure your new rule fits every reward in that section, including any Role products. Bypass Bag changes delivery timing; it does not bypass role access checks.

Commands Covered

• /category add
• /category edit
• /category remove
• /category info — list product details for a category

Example

/category add

After the category is created, run /category info to check its products and use /shop on a test player to confirm the order and access rule look right.