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