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.

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.

Admin Commands

• /shopadmin

  • Description: Base command for all administrative shop functions.
  • Aliases: /sa

• /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)

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.

Installation

1. Ensure you have the Vault plugin installed on your Spigot server.
2. Download the EconomyShop999-1.0.0.jar file from the target directory after building the plugin.
3. Place the EconomyShop999-1.0.0.jar file into your server's plugins folder.
4. Start or restart your Spigot server.
5. Configure your shop.yml and register any custom items as needed.