## 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 <item>` 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 <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`

* **Description:** Base command for all administrative shop functions.

* **Aliases:** `/sa`

* `/auctionhouse sell <price> <amount>`

* **Description:** 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`

* **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.<category_name>`

* **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).