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