🛡️ 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