EconomyShop999

Get Support, request a new feature, or want to report a bug? Then feel free to head on over to my discord! https://discord.gg/V3htVPGUGd ## Features * **Fully GUI-Based:** All player interactions with the shop are done through easy-to-use graphical interfaces. * **Vault Economy Support:** Integrates with your server's existing economy plugin via Vault for all transactions. * **Categorized Shops:** Organize your items into custom categories for easy browsing. * **Pagination:** Supports large shops and categories with intuitive page navigation. * **Interactive Buying GUI:** Players can select quantities to buy with +/- buttons and confirm or decline purchases. * **Selling Interface:** Allows players to sell items from their inventory that are configured in the shop. * **Item Search:** Players can search for specific items across all shop categories. * **Price Information:** Players can quickly check the buy and sell prices of any item. * **Custom Item Support:** Easily add items with custom names, lore, and NBT data to your shop. * **Admin Management Commands:** A suite of commands for administrators to manage shop categories, items, and prices directly. * **GUI Protection:** Prevents players from taking items directly from shop GUIs. * **Wishlist System:** Add items to your personal wishlist with `/shop wishlist ` to track them. * **Sell All Items:** Sell all sellable items at once with `/shop sellall`. * **Dynamic Pricing:** Prices fluctuate based on demand with dynamic pricing system. * **Category Permissions:** Restrict access to certain categories based on player permissions. * **Discount System:** Apply percentage discounts to purchases based on player permissions. * **Auction House:** Full auction house system accessible via `/auctionhouse` or `/ah`. ## Player Commands * `/shop` * **Description:** Opens the main shop GUI, displaying all available categories. * **Aliases:** `/s` * `/shop balance` * **Description:** Displays your current balance in the server's economy. * `/shop reload` * **Description:** Reloads the plugin's configuration files and shop data. (Requires permission) * `/shop price ` * **Description:** Shows the buy and sell price information for a specified item. * `/shop browse ` * **Description:** Opens the shop GUI directly to a specific category. * `/shop search ` * **Description:** Opens a GUI displaying all items matching your search term across all categories. * `/shop sell` * **Description:** Opens an interface where you can sell items from your inventory that are configured in the shop. * `/shop wishlist ` * **Description:** Adds an item to your personal wishlist that notifies you when the price drops. * `/shop sellall` * **Description:** Sells all sellable items in your inventory at once with a confirmation prompt. * `/auctionhouse` or `/ah` * **Description:** Opens the auction house GUI where you can browse, buy, and sell items at auction. ## Admin Commands * `/shopadmin` * **Description:** Base command for all administrative shop functions. * **Aliases:** `/sa` * `/auctionhouse sell ` * **Description:** Sell the item in your hand at the specified price and amount in the auction house. * **Aliases:** `/ah sell ` * `/shopadmin reload` * **Description:** Reloads all shop configuration files (`shop.yml` and `custom_items.yml`). * `/shopadmin add ` * **Description:** Adds a new item to a specified shop category. The `item_identifier` can be a standard Minecraft material name or the ID of a custom item you've registered. * `/shopadmin remove ` * **Description:** Removes an item from a specified shop category. * `/shopadmin setprice ` * **Description:** Changes the buy and sell prices for an existing item within a category. * `/shopadmin createcategory ` * **Description:** Creates a new shop category with a given name, icon, and its position in the main shop GUI. * `/shopadmin deletecategory ` * **Description:** Deletes an entire shop category and all items within it. ## Custom Item Commands * `/customitem add ` * **Description:** Registers the item you are currently holding in your main hand as a custom item with a unique identifier (`id`). This allows you to add items with custom names, lore, and NBT data to your shop. ## Permissions * `economyshop999.admin` * **Description:** Grants access to all `/shopadmin` and `/customitem` commands. * **Default:** Operators (op) * `economyshop999.reload` * **Description:** Allows use of the `/shop reload` command. * **Default:** Operators (op) * `economyshop999.category.` * **Description:** Grants access to a specific shop category when category permissions are enabled. * **Default:** None (all players can access all categories by default) * `economyshop999.category.*` * **Description:** Grants access to all shop categories when category permissions are enabled. * **Default:** None * `economyshop999.discount.vip` * **Description:** Grants VIP discount percentage on purchases when discount system is enabled. * **Default:** None * `economyshop999.discount.member` * **Description:** Grants member discount percentage on purchases when discount system is enabled. * **Default:** None ## Configuration Upon first run, a folder named `EconomyShop999` will be created in your server's `plugins` directory. Inside, you will find: * `shop.yml`: * This file is where you define your shop's categories and the items within them. It uses a clear YAML structure. * Each category has a `name`, `icon` (Minecraft material name), `slot` (position in the main GUI), and a list of `items`. * Items are defined using the format: `ITEM_IDENTIFIER BUY_PRICE SELL_PRICE`. * `ITEM_IDENTIFIER` can be a standard Minecraft material name (e.g., `STONE`, `DIAMOND_SWORD`) or the `id` of a custom item registered via `/customitem add`. * `BUY_PRICE` is the price players pay to buy the item. Set to `-1` to make an item unpurchasable. * `SELL_PRICE` is the price players receive for selling the item. Set to `-1` to make an item unsellable. * `custom_items.yml`: * This file stores the serialized data of any custom items you register using the `/customitem add` command. You typically won't need to edit this file manually. * `auction.yml`: * This file stores all active auction data. It's automatically generated and managed by the plugin. * `wishlist.yml`: * This file stores player wishlist data. It's automatically generated and managed by the plugin. ### Advanced Configuration Options Additional configuration options are available within the `shop.yml` file: * `dynamic-pricing.enabled`: Enables dynamic pricing that fluctuates based on item demand. * `dynamic-pricing.multiplier`: Maximum percentage adjustment for dynamic pricing (default: 0.05 for 5%). * `dynamic-pricing.base-demand`: Base demand threshold for 0% price change (default: 100). * `category-permissions.enabled`: Enables permission-based category access restrictions. * `discounts.enabled`: Enables discount system for specific player groups. * `discounts.vip`: Discount percentage for VIP players (default: 0.10 for 10%). * `discounts.member`: Discount percentage for member players (default: 0.05 for 5%). * `bank-interest.enabled`: Enables or disables the bank interest system. * `bank-interest.percentage`: Percentage interest rate applied to bank accounts (default: 0.01 for 1%). * `bank-interest.interval-hours`: Time interval between interest applications (default: 24 hours).