EconomyShop999

Features

* Auction House: All player interactions with the shop are done through easy-to-use graphical interfaces. * Auction House: Integrates with your server's existing economy plugin via Vault for all transactions. * Auction House: Organize your items into custom categories for easy browsing. * Auction House: Supports large shops and categories with intuitive page navigation. * Auction House: Players can select quantities to buy with +/- buttons and confirm or decline purchases. * Auction House: Allows players to sell items from their inventory that are configured in the shop. * Auction House: Players can search for specific items across all shop categories. * Auction House: Players can quickly check the buy and sell prices of any item. * Auction House: Easily add items with custom names, lore, and NBT data to your shop. * Auction House: A suite of commands for administrators to manage shop categories, items, and prices directly. * Auction House: Prevents players from taking items directly from shop GUIs. * Auction House: Add items to your personal wishlist with `/shop wishlist <item>` to track them. * Auction House: Sell all sellable items at once with `/shop sellall`. * Auction House: Prices fluctuate based on demand with dynamic pricing system. * Auction House: Restrict access to certain categories based on player permissions. * Auction House: Apply percentage discounts to purchases based on player permissions. * Auction House: Full auction house system accessible via `/auctionhouse` or `/ah`.

Player Commands

* `/shop` * Aliases: 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 <item>` * Description: Shows the buy and sell price information for a specified item.

* `/shop browse <category>` * Description: Opens the shop GUI directly to a specific category.

* `/shop search <item>` * 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 <item>` * 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` * Aliases: Base command for all administrative shop functions. * Aliases: `/sa`

* `/auctionhouse sell <price> <amount>` * Aliases: Sell the item in your hand at the specified price and amount in the auction house. * Aliases: `/ah sell <price> <amount>`

* `/shopadmin reload` * Description: Reloads all shop configuration files (`shop.yml` and `custom_items.yml`).

* `/shopadmin add <category> <item_identifier> <buy_price> <sell_price>` * 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 <category> <item_identifier>` * Description: Removes an item from a specified shop category.

* `/shopadmin setprice <category> <item_identifier> <new_buy_price> <new_sell_price>` * Description: Changes the buy and sell prices for an existing item within a category.

* `/shopadmin createcategory <name> <icon_material> <slot_number>` * Description: Creates a new shop category with a given name, icon, and its position in the main shop GUI.

* `/shopadmin deletecategory <name>` * Description: Deletes an entire shop category and all items within it.

Custom Item Commands

* `/customitem add <id>` * 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` * Default: Grants access to all `/shopadmin` and `/customitem` commands. * Default: Operators (op)

* `economyshop999.reload` * Default: Allows use of the `/shop reload` command. * Default: Operators (op)

* `economyshop999.category.<category_name>` * Default: Grants access to a specific shop category when category permissions are enabled. * Default: None (all players can access all categories by default)

* `economyshop999.category.*` * Default: Grants access to all shop categories when category permissions are enabled. * Default: None

* `economyshop999.discount.vip` * Default: Grants VIP discount percentage on purchases when discount system is enabled. * Default: None

* `economyshop999.discount.member` * Default: 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).