Chest Shops

A player turns a single chest into a shop via shift+left-click with an item in hand, the sign is created automatically. All trading happens through the sign; the chest stays locked for everyone except owner/team manager/admin. Every shop is SELLING (sells from the chest) or BUYING (buys from players) and belongs to a player or a team (money then flows through the team treasury).

Commands #

Additional permissions #

How a trade works #

1. Left-click the sign, an anvil GUI asks for the quantity (for selling limited by player stock, chest space and owner balance).
2. Clickable [✔ Confirm]/[✘ Cancel] buttons appear in chat (valid 30 seconds, general.confirmation-timeout).
3. On confirmation everything is re-checked and booked atomically: if any step fails, money and items are returned automatically. If not everything fits into the inventory, the remaining items drop at your feet (no loss).

When selling to a buying shop (BUYING) only the 36 storage slots are counted and taken; worn armour and the offhand item are never sold. If a buyer dies between confirmation and hand-over, the purchased items drop at the death position instead of vanishing with the death inventory.

Right-clicking your own sign opens the edit menu: change price, toggle type and remove the shop (the latter two are cooldown protected, cooldown.commands.shopedit). Switching a team shop to BUYING additionally needs the team right WITHDRAW, because buying shops spend team money.

Team shops (/team shop): needs team membership with the team right EDIT_TEAM_SHOPS (or shop.admin). They do not count against the personal limit but against max-shops-per-team. Team shops can only be created inside a claim that belongs to the team (like team containers).

Sign #

The sign is waxed automatically and redrawn on every change:

Protections #

Shops and claims #

A chest shop can only be created inside a claim where you may build: your own claim, another player's claim with build trust, or your team claim (require-claim). Not only the chest but also the block for the shop sign must lie on that land. The sign is placed automatically on a free side that satisfies this rule; if there is none, creation is rejected with "no free side". Players with shop.admin may create shops anywhere. When the claim disappears (abandon, admin deletion, automatic expiration, team disband), every shop on its footprint turns into a plain chest: sign gone, contents stay. Before abandoning, the server tells you the number, the web panel asks for confirmation. Shop owners who are not the one abandoning get a notice, offline on their next login. A claim cannot be shrunk so that shops end up outside: /shop remove first, then drag the corner. The claim owner may remove other players' shops from their land with /shop remove, on team land members with the team right EDIT_TEAM_SHOPS; the shop owner is notified. Transferring a claim keeps its shops. Shops created outside claims before this rule keep working.

Item matching #

A shop trades exactly the item it was created with. Two tolerances are configurable: matching.ignore-cosmetics treats an item wearing a cosmetic skin as the item underneath (a shop created with a skinned pickaxe trades plain ones too), matching.ignore-name-and-lore (default false) treats renamed or re-lored items as the base item; by default a renamed item is its own item, and the hover in the shop info shows its name. Never ignored: enchantments, durability, potion effects, container contents and custom items from resource packs (Nexo, Carpentary), so a shop never accepts something cheaper that merely looks alike.

Offline notifications #

Trades at your shops while you were offline are collected and shown on your next login (offline-notifications.enabled). max-messages-on-join caps the individual lines, the rest is summarised as a count; entries older than keep-days are dropped unseen. The money itself is always credited immediately.

Configuration (modules/shop.yml) #

# Enables or disables the chest shop module.
enabled: true

shop:
  # Default limit per player. Override per rank via permission:
  # shop.limit.25 allows 25 shops, shop.limit.unlimited removes the limit.
  max-shops-per-player: 10
  # Maximum shops per team (-1 = unlimited). Team shops do not count
  # against the personal limit.
  max-shops-per-team: 15
  # Shops only inside claims where the creator may build. When the claim
  # disappears, the shops inside turn into plain chests.
  require-claim: true
  # Prevents hoppers from draining or filling shop chests.
  hopper-protection: true
  # Allowed price range per item. max-price is hard capped at 999000000
  # (higher values are clamped on load).
  min-price: 0.01
  max-price: 999000000.0
  # Percentage tax on every completed transaction. The amount is credited
  # to nobody (money sink). 0 = no tax.
  # Values outside 0 to 100 are clamped on load.
  tax-percentage: 0
  # Plays transaction sounds for nearby players too.
  sound-broadcast: false
  integrations:
    coreprotect:
      # Logs transactions to CoreProtect (#shop-buy-<player>).
      transaction-logging: true
    nexo:
      # Resolves Nexo item names on signs/displays.
      enabled: true
    carpentary:
      # Resolves Carpentary item names.
      enabled: true

cooldown:
  commands:
    # Seconds between /shopedit actions (against spam toggling).
    shopedit: 3

Complete example config #

enabled: true

shop:
  max-shops-per-player: 5
  max-shops-per-team: 20
  require-claim: true
  hopper-protection: true
  min-price: 1.0
  max-price: 1000000.0
  tax-percentage: 5
  sound-broadcast: true
  integrations:
    coreprotect:
      transaction-logging: true
    nexo:
      enabled: false
    carpentary:
      enabled: false

cooldown:
  commands:
    shopedit: 5