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 - **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`) ```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 - **Java 21** - **Paper or Spigot 1.21+** - **(https://modrinth.com/plugin/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: (https://discord.com/invite/n6A3nc3EW7)