SyShop

Plugin Introduction

SyShop is a system shop plugin for Minecraft Purpur 1.21.1, supporting Paper and Purpur servers, compiled with JDK 17, and integrated with the Vault economy system.

Features

• Convenient Command: Players enter /shop to open the shop GUI
• Beautiful Interface: Customizable GUI title and size
• Detailed Information: Hover to show item name and price
• Smart Display: Randomly displays items when the number of items exceeds the page capacity
• Secure Transactions: Prevents players from taking items via Shift+click or drag
• Flexible Configuration: Customize items in config.yml

Installation

1. Ensure the server has the following plugins installed:

   • Vault
   • Any Vault-compatible economy plugin (e.g., EssentialsX Economy)

2. Download the compiled plugin JAR file

3. Place the JAR file in the server's plugins folder

4. Restart the server

5. The plugin will automatically generate configuration files

Configuration

After the plugin starts, it will generate a config.yml file in the plugins/SyShop directory, which can be modified as needed:

# GUI settings
gui:
  title: "System Shop"  # GUI title
  size: 54  # GUI size, must be a multiple of 9

# Item list
# If the number of items exceeds the GUI capacity, items will be randomly displayed
items:
  diamond:
    material: DIAMOND  # Item material
    name: "&bDiamond"  # Item name (supports color codes)
    price: 100.0  # Price
    slot: 10  # Display position
  # More items...

Commands and Permissions

Commands

• /shop - Open the system shop GUI

Permissions

• syshop.use - Allows using the shop command (default for all players)

Dependencies

• Minecraft Purpur/Paper 1.21.1
• Vault 1.7+
• Java 17+
• Vault-compatible economy plugin

Compilation

1. Clone the project locally
2. Execute mvn clean package command
3. The compiled JAR file is located in the target directory

Developer Information

• Author: Shiyuan
• Version: 1.0.0
• Supported Version: Minecraft 1.21.1

Notes

• Ensure Vault plugin is correctly installed on the server
• Item materials in the configuration file must use material names supported by Minecraft 1.21.1
• GUI size must be set to a multiple of 9
• When the number of items exceeds the GUI capacity, items will be randomly displayed each time the shop is opened