Brief Overview:

The Chest Shop plugin offers an intuitive and user-friendly way for players to create, manage, and interact with item shops within Minecraft. Utilizing chests as shop interfaces, this plugin enables players to buy and sell items seamlessly, enhancing the gameplay experience by providing a robust economic system.
This plugin allows players to create shops where they can sell and buy items using a Graphical User Interface (GUI). Players can set prices for their items, create shops, and manage transactions through an easy-to-use system.



Here’s a breakdown of the key features and mechanics of the plugin:

Key Features:

1. Create Shops:
   • Players can set up their shops by placing a sign and linking it to a chest.
   • Buying and Selling: Each shop can handle both buying and selling items, depending on how the shop is set up.
   • A sign is created with specific text, showing the shop's creation and interaction options.
   Code (YAML):

   
   sign-creation-message : "[shop]"
   sign-creation-success : "&1[shop]"
   sign-creation-error : "&c[shop]"
    
   • Success Message when a shop is successfully created and error messages when something goes wrong (e.g., no chest nearby or invalid setup).
2. Owner Control:
   • Shop owners have control over pricing and can update their shop items through a custom GUI.
   • Owners can manage their shop through a 3-row GUI displaying all the items they are selling, prices, and stock.
   Code (YAML):

   
   chest-shop-owner:
     size : 3
     title : "Your Chest Shop"
     items:
      transaction:
        slots : 0-26
        name : "%item%"
        lore:
          - "&7Price : &b%price%"
          - "&7&oStock : &b%stock%"
          - "&7You are &b%type%ing &7this item"
    
   • Shop owners can set the price of each item in their inventory using a simple GUI menu, and they can update or remove items anytime.
   • Owners can confirm item removal through the Remove Item Confirmation GUI.
3. Player Transactions:
   • Players can visit any shop, view the available items for sale, and make purchases using the Chest Shop Player GUI.
   • They can see the item name, price, stock, and whether it is being bought or sold.
   Code (YAML):

   
   chest-shop-player:
     size : 3
     title : "%player%'s Chest Shop"
     items:
      transaction:
        slots : 0-26
        name : "%item%"
        lore :
         - "%player% is %mode% this item"
          - "&7Price : &b%price%"
    
   • Players can also confirm purchases through the Purchase Item Confirmation GUI, where they can add or remove quantities before finalizing their purchase.
4. Buy and Sell Pricing:
   • The plugin allows for the dynamic setting of buying and selling prices, configurable per shop and per item.
   • Pricing prompts guide players when they need to set a price for an item, ensuring easy setup.
   Code (YAML):

   
   price-prompt : "Please type the price for the selected item."
   item-added-for-sale : "Item added for sale with a price of %price%!"
    
5. Stock Management:
   • The system tracks item stock in the shop and prevents transactions when there isn’t enough stock or space in the chest.
   • Players are notified when there’s insufficient stock or funds for the transaction.
   Code (YAML):

   
   shop-no-stock : "&cThere is not enough item on stock to buy! Max items to buy is %max%!"
   shop-not-enough-space : "&cThere is no more space to sell items! Max items to sell is %max%!"
    
6. Confirmation of Transactions:
   • Both buyers and sellers receive messages confirming when a transaction is successful, such as selling an item or purchasing from a shop.
   Code (YAML):

   
   item-purchased : "Item purchased successfully for %price%$!"
   item-sold : "Your %item% item has been sold for %price%!"
    
7. Sign GUI Integration:
   • Signs act as interaction points for the shop, and the plugin integrates with the Sign GUI to edit prices, change buying/selling options, and confirm transactions using text-based inputs.
   Code (YAML):

   
   sign-gui:
     edit-type:
      line-2 : "§f^ §bBuy/Sell §f^"
     edit-price:
      line-3 : "§f^ §b%type%ing for §f^"
    

Commands and Permissions:

• Max Number of Shops:
  The permission system uses chestshop.allow-shop.<number>, where the <number> represents the number of shops a player can create. The code loops through permissions to determine the highest shop limit the player has.
  
  For example:
  • If a player has the permission chestshop.allow-shop.5, they can create up to 5 shops.
  
  
  
  Code (YAML):

  
  max-shops-reached : "&cYou can only have %amount% shops created at once."
   
  By setting permissions like chestshop.allow-shop.<number>, you can control how many shops each player can create.

This Chest Shop plugin provides a full-fledged marketplace for players to easily set up shops, manage pricing and stock, and engage in buying and selling within the game. With its powerful GUI support and smooth sign integration, it offers a user-friendly experience for both shop owners and customers on your server.



Some More of the Key Features:

• Shop Creation: Players can easily create shops by placing a sign on a chest. Upon successful creation, they receive a confirmation message, indicating the shop's active status.
  
  
• Dynamic GUI: The plugin features a fully customizable graphical user interface (GUI) for both shop owners and customers. This interface simplifies item transactions and price management.
  
  
• Transaction Management: Players can set prices for their items, view stock levels, and manage sales directly from the GUI. Owners are prompted to enter prices for their items, ensuring clarity in transactions.
  
  
• Price Setting and Confirmation: The plugin supports multiple price-setting mechanisms, allowing owners to quickly adjust prices and confirm item sales. Confirmation dialogs help prevent accidental deletions or purchases.
  
  
• Robust Economy Integration: With built-in economy support, the plugin allows for smooth transactions, including buying and selling items based on player balance. Notifications are sent to players regarding their purchase and sale activities.
  
  
• Stock Management: Owners can easily monitor their inventory and stock levels. The plugin provides messages to inform players when they have insufficient items for sale or purchase.
  
  
• User-Friendly Messages: Clear and customizable messages enhance user experience. The plugin includes predefined messages for various actions, which can be modified or disabled based on server preferences.
  
  
• Multi-User Support: The plugin allows multiple shops to be created, with a limit configurable by the server administrator. Players can manage their shops without interference from others.

GUI Components

• Chest Shop Player GUI: Displays the items available for sale, along with prices and stock information.
  
  
• Chest Shop Owner GUI: A dedicated space for shop owners to manage their items, set prices, and view stock.
  
  
• Confirmation Dialogs: Clear interfaces for confirming item removal and purchase, reducing the risk of accidental actions.

Configuration Options
The plugin comes with a comprehensive configuration file that allows server owners to customize various aspects of the plugin. Below are key configuration sections:

General Messages

• sign-creation-message: The message shown when a shop is successfully created.
  
  
  Code (YAML):

  sign-creation-message : "[shop]"
• sign-creation-success: Success message after a shop is created.
  
  
  Code (Text):

  sign-creation-success: "&1[shop]"
• sign-creation-error: Error message for shop creation issues.
  
  
  Code (Text):

  sign-creation-error: "&c[shop]"

GUI Configuration

• Chest Shop Player GUI:
  • title: The title displayed for the player’s shop.
  • size: The number of slots in the GUI.
  Code (YAML):

  chest-shop-player:
    size : 3
    title : "%player%'s Chest Shop"
• Chest Shop Owner GUI:
  • title: The title displayed for the owner's shop.
  Code (YAML):

  chest-shop-owner:
    size : 3
    title : "Your Chest Shop"
• Confirmation Dialogs: Configurable confirmation messages and items for actions like confirming item removal.
  
  
  Code (YAML):

  remove-item-confirmation:
    size : 3
    title : "Confirm Item Removal"

Messages

• prefix: Prefix used in all plugin messages.
  
  
  Code (YAML):

  prefix : "&7[ChestShop] "
• sign-created: Message indicating that a shop sign was created successfully.
  
  
  Code (YAML):

  sign-created : "Shop sign created successfully!"
• no-chest-nearby: Error message when no chest is found.
  
  
  Code (YAML):

  no-chest-nearby : "No chest nearby to link the shop."

Example Messages

• Item Purchased: "Item purchased successfully for %price%$!"
• Not Enough Money: "You don't have enough money to purchase this item!"

Conclusion
The Chest Shop plugin enhances the Minecraft experience by providing a robust and flexible shop system. With its easy-to-use interface, strong economy integration, and detailed configuration options, server owners can create a vibrant marketplace for players to buy and sell items seamlessly. Whether you're running a survival server or an economy-focused environment, this plugin is a must-have for your Minecraft server.