JiuWu's PlayerListGUI

JiuWu's PlayerListGUI is a Minecraft plugin developed for PaperMC servers. It displays all online players through a visual GUI interface, supporting one-click kicking, banning players, or sending private messages. All interface text, button styles, and permission nodes can be customized, compatible with MiniMessage format and PlaceholderAPI placeholders, balancing functionality and personalization.

---

In-game Screenshot Preview

---

Core Features

1. Visual Player List GUI - Displays all online players in the form of player heads, with a clear GUI layout supporting pagination (Previous Page/Next Page buttons). - Custom decorative panels to fill non-functional areas, supporting custom materials, display names, and CustomModelData.

2. Convenient Player Management Operations - Left-click on a player head: Kick the corresponding player (requires corresponding permission). - Right-click on a player head: Ban the corresponding player (requires corresponding permission). - Middle-click on a player head: Send a private message to the corresponding player (requires corresponding permission). - All operations include a confirmation process to avoid misuse, with real-time feedback messages for operation results.

3. Fully Customizable Configuration - Button customization: Supports modifying the material, display name, Lore, CustomModelData, and slot of page-turning buttons, player heads, and decorative panels. - Flexible slot configuration: Supports integer, list, and range string (e.g., "10-16, 19-25") formats for configuring functional button slots. - Message customization: All prompt messages (prefix, no permission, operation results, GUI title, etc.) support MiniMessage format, allowing custom text and styles. - Hot-reload configuration: Supports reloading configuration files via commands, making modifications effective without restarting the plugin.

4. Compatibility and Extensibility - Compatible with PlaceholderAPI: All text supports PAPI placeholder parsing, allowing embedding of player/server-related dynamic information. - Multiple command aliases: Main command `/jiuwuplayerlistgui`, with aliases `/jp`, `/jplg`, simplifying operations.

Permission Nodes

| Permission Node | Function Description | |---------------------------|-----------------------------------| | jiuwuplayerlistgui.use | Use the plugin (open player list GUI) | | jiuwuplayerlistgui.kick | Permission to kick players | | jiuwuplayerlistgui.ban | Permission to ban players | | jiuwuplayerlistgui.tell | Permission to send private messages to players | | jiuwuplayerlistgui.reload | Permission to reload plugin configuration files |

Command Description

| Command | Permission Required | Function Description | |----------------|----------------------------|------------------------------| | /jp open | jiuwuplayerlistgui.use | Open the player list GUI interface | | /jp reload | jiuwuplayerlistgui.reload | Reload all plugin configuration files |

Highlights

- Beautiful Interface: Based on MiniMessage, supports gradients, colors, style customization, including italics, gradient text, and other effects. - Safe Operations: All high-risk operations (kicking/banning) require confirmation to avoid misuse. - Low Performance Consumption: Lightweight design, loads data only when the GUI is opened/operated, suitable for small to medium-sized servers.

---

Installation Guide

1. Download the JiuWu's PlayerListGUI plugin file. 2. Ensure your server has PySpigot installed. 3. Place the plugin file into the server's `plugins/PySpigot/scripts/` folder. 4. Restart the server or execute `/ps reloadall` in the console to complete the installation.

> Paper: For optimal performance and compatibility, we strongly recommend using a Paper or its fork (like Purpur) server software. After first installation or update, remember to delete old config files to generate new ones!