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

- Flexible Configuration: Players enter `/shop` to open the shop GUI - Flexible Configuration: Customizable GUI title and size - Flexible Configuration: Hover to show item name and price - Flexible Configuration: Randomly displays items when the number of items exceeds the page capacity - Flexible Configuration: 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