SyShop

# 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: ```yaml # 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