SimpleShop

# SimpleShop # **The simple, clean GUI shop solution for Minecraft servers** **Version: v1.0.0 | API: 1.21+ | Dependencies: Vault | Optional: PlaceholderAPI, EssentialsX** ### Quick Start ### 1. Drop SimpleShop.jar into /plugins/ 2. Install Vault + an economy plugin (EssentialsX, CMI, etc.) 3. Restart server 4. Use /shop to open the shop 5. Edit shop.yml to configure categories and items or use /shop admin to enable editing and use Shift + Right Click on the category or item you want to edit. ### Commands ### /shop - Open the main shop GUI - simpleshop.use /shop help - View player help - simpleshop.help /shop sell - Open the sell GUI - simpleshop.sell /shop reload - Reload configuration - simpleshop.admin.reload /sellgui - Direct sell GUI access - simpleshop.sell Aliases: /store, /buy, /sell, /sellmenu ### Permissions ### **Player Permissions** (Default: true) simpleshop.use - Access the shop simpleshop.sell - Sell items simpleshop.help - View help **Admin Permissions (Default: op)** simpleshop.admin.reload - Reload configuration **Category Permissions (Default: false)** simpleshop.category.<name> - Access specific category **Wildcards** simpleshop.admin.* - All admin permissions # Features: # ### Category-Based Organization ### Create unlimited shop categories. Custom category names with color code support. Custom icons for each category. Permission-locked categories for VIP shops. Clean grid layout for easy browsing. ### Buy & Sell System ### Configure separate buy and sell prices per item. Disable buying or selling individually per item. Support for all vanilla Minecraft items. Price display in item lore. Balance checking before transactions. ### GUI System ### Main menu displaying all categories. Category pages with pagination support. Quantity selector with quick buttons (-64, -16, -1, +1, +16, +64). Purchase confirmation dialog for large transactions. Dedicated sell GUI for quick item selling. Clean, lag-free inventory interface. ### Sell GUI ### Drag items into the sell interface. See total value before confirming. Sell multiple item types at once. One-click sell all functionality. ### Economy Integration ### Full Vault support. Compatible with all major economy plugins including EssentialsX Economy, CMI Economy, PlayerPoints, and many more. ## File Structure ## plugins/SimpleShop/ config.yml - Main configuration messages.yml - All plugin messages shop.yml - Categories & items ### Config Highlights ### config.yml: GUI titles and appearance. Filler/border materials. Sound effects (open, click, purchase, error). Confirmation thresholds. Sell GUI toggle. Cooldown settings. messages.yml: Fully customizable messages. Color code support. Placeholder support. shop.yml: Category definitions. Category icons and names. Item prices (buy/sell). Custom item names and lore. Category permissions. ### Support ### Requires Vault + economy plugin. Tested on Paper/Spigot 1.21+. - Report issues with this link: (https://forms.gle/Fxe9wQ6GzMTNqHtB8) - Suggest new features or get support with this link: (https://forms.gle/Fxe9wQ6GzMTNqHtB8) ## Premium ## !(https://cdn.modrinth.com/data/cached_images/5741f8a6e95ef5a41ee41d10620dad0b1f388223.png) Upgrade to (https://buymeacoffee.com/waffleboiiiiii/extras) for advanced features including: Rotating/Daily Shops with stock limits, Command Items (sell ranks, kits, crates), Buy/Sell Limits with reset timers, In-Game Admin Editor (no config editing!), Custom Item Support (ItemsAdder, Oraxen, MMOItems), Search System across all categories, Subcategories for better organization, Transaction Logging for auditing, And many more! _If everything looks a little odd, due to markdown formatting_ Thanks for the support! **_Developed by waffleboiiiiii_**