Skip to content

Configuring in game

Everything is behind /shop admin. You need embershop.admin.

Editing the shop in game — no config file open at any point.

Categories

New category names it and creates it. Inside a category you can:

Rename changes the display name
Set icon click uses the item in your hand; shift-click accepts a reference like hdb:1234
Set permission gate it behind a node; shift-click clears
Section ON/OFF hide it from everyone, staff included
Delete shift-click to confirm

Hiding beats permissions while you build

A disabled section is invisible to everyone, including admins. A permission node still leaks the section to staff and to anyone who inherits their group, which is rarely what you want mid-edit.

Adding items

Three ways, for three different moments:

  • Add held item — what you reach for while building a shop by hand.
  • Drag and drop — opens a window; drop items in and they become listings. Your items are handed back. Fastest way to stock a category from a shulker box.
  • /shop add <category> [buy] [sell] — the held item, from a command.
  • /shop additem <category> <reference> [buy] [sell] — anything typed. The only way to list an item you cannot easily obtain.

Items added in bulk have no price on purpose. Guessing a price for a custom item is wrong more often than right, and an unpriced listing is visibly unfinished in the editor rather than quietly mispriced in the shop.

Editing an item

Click any listing in the editor:

  • Buy price / Sell price — shift-click either to make the item unbuyable or stop buying it back
  • Permission — per-item gating
  • Stock limit and Restock rate — see Pricing
  • Remove — shift-click to confirm

Every change saves immediately. An admin who loses twenty minutes of pricing to a crash never trusts the editor again.

Commands that run on purchase

Any listing can carry commands, run from console when it is bought:

commands:
  - "lp user %player% parent add vip"
  - "give %player% diamond 1"

%player%, %uuid% and %amount% are substituted, and the list runs once per unit bought. Console rather than the player, because the whole point of selling a rank is that the buyer cannot grant it themselves.

This is what turns the shop into a way to sell ranks, kits, warps and permissions rather than only items.