How players use it
Buying at a stand#
A player looks at a stand and left or right clicks it (both work, using a hitbox around the stand). While they look at a stand, their own balance and how much more they need is shown above the hotbar. The click needs mcshardshop.use, which everyone has by default.
By default a confirm screen opens where the player picks a quantity and sees the total price and their balance after the purchase. Turn it off with purchase.require-confirmation: false to buy one item per click. The most a player can buy at once is limited by purchase.max-quantity, the remaining stock, their limits and what they can afford.
Why a purchase can be refused#
- Not enough shards.
- The item is sold out, or the shop rotated while the screen was open.
- The player reached the item's per-rotation limit or lifetime limit (bypass:
mcshardshop.bypass.limit). - The item has a
permissionthe player lacks. - The purchase cooldown has not passed (bypass:
mcshardshop.bypass.cooldown). - The inventory is full and
purchase.full-inventoryisblock.
Full inventory#
purchase.full-inventory controls what happens when items do not fit:
claim(default): the leftover items wait in the claim box. Players open it with/shardshop claim.drop: the leftovers drop at the player's feet.block: the purchase is refused.
Catalog and wishlist#
/shardshop catalog shows everything the shop can sell, with a filter by rarity. Clicking an item adds or removes it from the player's wishlist. When a wished item appears in a rotation, the player is told, also when they join after being offline. Needs mcshardshop.catalog.
History and leaderboard#
/shardshop history lists the player's purchases. /shards top opens a leaderboard menu with player heads, including offline players (built-in currency only).
Announcements#
Items of a rarity with announce: true (Legendary by default) are announced to the server when bought, if purchase.announce-rare is on. When the last unit of an item is bought, the server is told if purchase.announce-sold-out is on. Rotations are announced with a chat message, title and sound when rotation.announce is on, and players get a one-line notice on join when messages.join-notice is on.