Packages
Packages are the items players can purchase on your store — ranks, kits, currency, subscriptions, and more.
Package Types
Delivery Commands
When a player completes a purchase, ForgeStore runs a server command on your behalf. This is how ranks, kits, and currency are delivered automatically — no manual work.
Available variables
| Variable | Replaced with | Example |
|---|---|---|
{player} | The player's exact username (as entered at checkout) | Notch |
{player_uuid} | Minecraft UUID (if available) | 069a79f4-... |
{price} | Amount paid in your store currency | 9.99 |
{package} | Package name | VIP Rank |
{quantity} | Quantity purchased (for variable packages) | 3 |
{order_id} | Unique order ID | 1042 |
Common command examples
lp user {player} parent set vip
give {player} diamond_sword{Enchantments:[{id:sharpness,lvl:5}]} 1
eco give {player} 10000
broadcast &6&l{player} &ejust bought &6VIP&e! Get yours at &bstore.yourserver.com
oxide.usergroup add {player} vip
es:setjob {player} mechanic 2
Stock & Limits
Stock limiting
Set a maximum number of units for a package. Once all units are sold, the package is automatically hidden from the store. Useful for limited-edition ranks or seasonal items.
In Package Settings → Advanced → Stock Limit, enter the maximum number of times this package can be purchased.
Purchase limits per player
Prevent players from buying the same package multiple times. Go to Package Settings → Advanced → Max Per Player and set a limit (e.g. 1 for a rank they can only buy once).
Required packages
Make a package only available to players who already own another package. For example, VIP+ can require VIP. Set this in Package Settings → Advanced → Requires Package.
Subscriptions
Subscription packages charge players on a recurring monthly basis. The rank is granted on purchase and automatically removed if the player cancels or fails to pay.
How it works
- Player purchases the subscription — they're charged immediately for month 1
- Each month, ForgeStore automatically creates a new payment request
- If the player pays → their rank continues, renewal command runs
- If the player doesn't pay within 3 days → cancellation command runs
Commands
Subscription packages support four command slots:
| Slot | When it runs |
|---|---|
| Purchase Command | First purchase only |
| Renewal Command | Every successful monthly payment |
| Expiry Command | When the subscription is cancelled or payment fails |
| Chargeback Command | If a chargeback is filed on a card payment |
# Purchase command (first time)
lp user {player} parent set vip
broadcast &6{player} &ejust subscribed to &6Monthly VIP&e!
# Renewal command
lp user {player} parent set vip
# Expiry command
lp user {player} parent remove vip
tell {player} &cYour VIP subscription has expired. Renew at store.yourserver.com
Package Variants
Variants let players choose from multiple options within a single package. For example, a "Starter Kit" with Bronze, Silver, and Gold tiers — each with a different price and command.
In Package Settings → Variants, click Add Variant and set a name, price, and commands for each option. Players see a dropdown at checkout.
Categories
Organize your packages into categories to make your store easier to navigate. Go to Dashboard → Categories → New Category and assign packages to it.
Categories appear as tabs or sections on your store page depending on your theme.