SyPagePro

A customizable GUI panel plugin for Minecraft Paper/Purpur servers

---

📋 Overview

SyPagePro is a powerful and user-friendly GUI panel plugin for Minecraft 1.21.x Paper/Purpur servers. It allows players to create their own customizable panels with bound commands, and provides admins with a shared public panel that all players can view.

Info	Details
Plugin Name	SyPagePro
Author	Shiyuan
Version	1.0.0
Target	Minecraft 1.21.x Paper / Purpur
Java	JDK 21

---

✨ Features

• Personal GUI Panel (/ss) — A customizable panel with multiple pages for each player
• Public GUI Panel (/sp) — A shared panel editable by admins, viewable by all players
• Edit Command — Bind display text and commands to buttons (supports color codes)
• Edit Button — Place, remove, and rearrange items in the GUI
• Multi-page support with intuitive navigation
• Bilingual support (Chinese / English), default Chinese
• YAML data storage using Minecraft 1.21.11 naming convention (e.g., minecraft:stone)
• Beautiful and intuitive UI design

---

📦 Installation

1. Download the SyPagePro-1.0.0.jar file
2. Place it in your server's plugins/ folder
3. Restart or reload your server
4. The plugin will auto-generate config.yml and language files

---

⌨️ Commands

Command	Description	Permission
/ss	Open personal GUI panel	sypagepro.use
/sp	Open public GUI panel	sypagepro.use
/sypagepro reload	Reload configuration	sypagepro.reload

---

🔐 Permissions

Permission	Description	Default
sypagepro.use	Access to /ss and /sp commands	Everyone
sypagepro.admin	Edit the public GUI panel	OP
sypagepro.reload	Reload the plugin configuration	OP

---

⚙️ Configuration (config.yml)

# Language setting: zh_cn (Chinese) or en_us (English)
language: zh_cn

# Public GUI Panel settings
public-gui:
  # Enable or disable the public GUI
  enabled: true

---

🖥️ GUI Layout

The GUI uses a 54-slot (large chest) view.

Bottom Row (Slots 45–53) — Control Buttons

Slot	Button
45	⬅️ Previous page button
46	⬛ Dark glass panel (decorative)
47	⬛ Dark glass panel (decorative)
48	✏️ Edit Command button
49	📄 Page number indicator
50	🧩 Edit Button button
51	⬛ Dark glass panel (decorative)
52	⬛ Dark glass panel (decorative)
53	➡️ Next page button

Content Area

• Slots 0–44 — 45 slots per page for buttons/items

---

💾 Data Storage

• Player data: plugins/SyPagePro/data/<uuid>.yml
• Public GUI data: plugins/SyPagePro/PublicGUI.yml
• Items use Minecraft 1.21.11 naming format (e.g., minecraft:diamond_sword)
• Display text supports & color codes

---

📄 Data Format Example

player:
  name: "Shiyuan"
buttons:
  1:
    0:
      material: "minecraft:diamond_sword"
      name: "&aTeleport Home"
      command: "spawn"
    1:
      material: "minecraft:paper"
      name: "&bView Help"
      command: "help"

---

📖 Usage Guide

1. Personal Panel

Type /ss to open your personal panel. Click "Edit Command" to bind commands to buttons, or "Edit Button" to customize the layout.

2. Public Panel

Type /sp to view the public panel. Only admins (sypagepro.admin) can edit it.

3. Edit Command

1. Click "Edit Command"
2. Click any content button
3. Enter the display text (supports color codes)
4. Enter the command (without /)

4. Edit Button

Click "Edit Button" to enter edit mode. You can:

• Place items from your inventory into the panel
• Remove items from the panel
• Rearrange items within the content area

⚠️ Note: The bottom row (slots 45–53) is always locked and cannot be modified.

---

👤 Author

Shiyuan

• GitHub: Shiyuan-318

---