EconomyShop999

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