🛡️ ShopShields

Turn any chest or barrel into a player shop — powered by Vault.

ShopShields lets every player on your server open their own item shop in seconds. Simply place a ShopShield on a chest or barrel, configure the item, quantity and price through an intuitive GUI, and your shop is live — complete with an auto-placed sign showing the item and stock status.

✨ Features

Easy shop creation — Place a ShopShield item on any chest or barrel to instantly create a shop
GUI-based setup — Clean 3-row inventory interface for selecting items, adjusting quantities and setting prices
Auto sign — A sign is automatically placed next to the chest displaying the item name, price and seller; strikethrough when out of stock
Vault economy — Fully integrated with any Vault-compatible economy plugin (EssentialsX, CMI, etc.)
Purchase confirmation — Optional confirmation dialog for purchases above a configurable threshold (default: 100,000 $)
Stock detection — Buy button is automatically disabled when the chest is empty
Owner notifications — Shop owners receive a message in real time when someone buys from their shop
Persistent data — All shops are saved to shops.yml and survive server restarts
Bilingual — Full English and German language support, switchable in config.yml
Folia compatible — Automatically detects Folia and uses the correct scheduler

🖥️ How It Works

1. Get a ShopShield

/sps give ShopShield

2. Place it on a chest or barrel Right-click any chest or barrel while holding the ShopShield item.

3. Configure via GUI Select the item you want to sell, set the quantity and enter a price via chat.

4. Stock the chest Put the items you want to sell into the chest — that's it!

5. Players buy from your shop Other players right-click the chest or the sign to open the buy GUI.

🗂️ Commands

Command	Description	Permission
`/sps give ShopShield`	Give yourself a ShopShield item	`shopshields.give`
`/shopshields give ShopShield`	Alias for the above	`shopshields.give`

🔐 Permissions

Permission	Description	Default
`shopshields.give`	Allows using `/sps give ShopShield`	OP
`shopshields.admin`	Can manage and break any shop	OP
`shopshields.buy`	Can purchase from shops	Everyone

⚙️ Configuration (`config.yml`)

# Language: en (English) or de (Deutsch)
language: en

shop:
  # Purchase confirmation threshold (0 = disabled)
  confirm-threshold: 100000.0

  # Maximum allowed shop price (0 = no limit)
  max-price: 0.0

  # Only the shop owner can break the chest?
  owner-only-break: true

🔌 Compatibility

Software	Supported
Paper 1.21+	✅
Spigot 1.21+	✅
Folia	✅
Vault	✅ Required
EssentialsX Economy	✅
CMI Economy	✅
Towny / GriefPrevention	⚠️ No native integration (protection plugins handle their own block access)

📦 Requirements

Java 21
Paper or Spigot 1.21+
Vault + a compatible economy plugin

📁 Data & Files

File	Purpose
`plugins/ShopShields/config.yml`	Language and shop settings
`plugins/ShopShields/shops.yml`	Persistent shop data (auto-generated)

👤 Author

Made with ❤️ by Maximilian Hirtzbruch

💬 Support & Updates:

Join our Discord