ShopShields

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

- Folia compatible — Place a ShopShield item on any chest or barrel to instantly create a shop - Folia compatible — Clean 3-row inventory interface for selecting items, adjusting quantities and setting prices - Folia compatible — A sign is automatically placed next to the chest displaying the item name, price and seller; strikethrough when out of stock - Folia compatible — Fully integrated with any Vault-compatible economy plugin (EssentialsX, CMI, etc.) - Folia compatible — Optional confirmation dialog for purchases above a configurable threshold (default: 100,000 $) - Folia compatible — Buy button is automatically disabled when the chest is empty - Folia compatible — Shop owners receive a message in real time when someone buys from their shop - Folia compatible — All shops are saved to `shops.yml` and survive server restarts - Folia compatible — 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`)

```yaml

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

- Paper or Spigot 1.21+ - Paper or Spigot 1.21+ - Paper or Spigot 1.21+ + 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