JiuWu's PlayerListGUI [Major Code Refactoring Update]

架构设计优化 |Architectural Design Optimization · 面向对象重构 | Object-Oriented Refactoring · 拆分多个职责单一的管理类 Split multiple management classes with single responsibilities · 替代原始版本零散的函数+全局变量模式，代码可维护性大幅提升 Replaced the scattered function + global variable pattern of the original version, significantly improving code maintainability · 配置系统重构 | Configuration System Refactoring · 所有硬编码文本/配置项迁移至Config.yml配置文件 Migrated all hardcoded text/configuration items to the Config.yml configuration file · 支持配置项默认值自动设置+注释添加，首次加载自动生成完整配置文件 Supports automatic default value setting and comment addition for configuration items, automatically generating a complete configuration file on first load · 配置项分类管理: 权限、GUI按钮、消息文本独立配置节点 Categorized configuration management: independent configuration nodes for permissions, GUI buttons, and message text 文本渲染升级 | Text Rendering Upgrade · 替换颜色码系统 | Replaced Color Code System · 移除原始版本的ChatColor(&符号颜色码)，全面使用Kyori Adventure的MiniMessage Removed the original version's ChatColor (& symbol color codes), fully using Kyori Adventure's MiniMessage · 支持渐变文本、悬停样式、更丰富的格式化语法(如<gradient:#FF80FF:#00FFFF>) Supports gradient text, hover styles, and richer formatting syntax (e.g., <gradient:#FF80FF:#00FFFF>) · 文本处理统一封装，支持异常捕获和降级处理 Unified text processing encapsulation, supports exception catching and fallback handling · PlaceholderAPI集成增强 | PlaceholderAPI Integration Enhancement · 独立工具类处理PAPI占位符，支持玩家头颅DisplayName/Lore的占位符替换 Independent utility class for handling PAPI placeholders, supports placeholder replacement for player head DisplayName/Lore · 自动检测PlaceholderAPI是否启用，无插件时优雅降级 Automatically detects if PlaceholderAPI is enabled, gracefully degrades when the plugin is absent · 原始版本仅基础支持，重构后全流程占位符兼容 Original version had basic support only; after refactoring, full-process placeholder compatibility 功能配置灵活性提升 | Function Configuration Flexibility Improvement · GUI槽位配置自由化 | GUI Slot Configuration Liberalization · 原始版本槽位硬编码，重构后支持: Original version had hardcoded slots; after refactoring, supports: · 整数(单个槽位)、列表(多个离散槽位)、范围字符串(如"10-16, 19-25") Integers (single slot), lists (multiple discrete slots), range strings (e.g., "10-16, 19-25") · 翻页按钮、装饰板、玩家头颅槽位均可通过配置文件自定义 Page turn buttons, decoration panels, and player head slots can all be customized via configuration file · 装饰板材质、显示名、CustomModelData支持配置 Decoration panel material, display name, and CustomModelData support configuration · 权限系统精细化 | Permission System Refinement · 原始版本仅基础权限(use/kick/ban)，重构后: Original version had basic permissions (use/kick/ban); after refactoring: · 拆分独立权限节点: jiuwuplayerlistgui.use/kick/ban/tell/reload Split into independent permission nodes: jiuwuplayerlistgui.use/kick/ban/tell/reload · 每个操作均做精准权限检查，无权限时返回统一提示 Each operation performs precise permission checks, returns a unified prompt when lacking permissions · 消息文本全配置化 | Message Text Full Configuration · 所有系统提示、操作反馈、确认文本均可自定义 All system prompts, operation feedback, and confirmation text can be customized · 支持占位符替换(如{Prefix}/{PlayerName}/{CurrentPage}) Supports placeholder replacement (e.g., {Prefix}/{PlayerName}/{CurrentPage}) · 消息前缀统一配置，支持渐变样式 Message prefix unified configuration, supports gradient styles 功能增强 | Feature Enhancement · 新增核心功能 | New Core Features · 插件重载命令: /jp reload(需jiuwuplayerlistgui.reload权限)，支持配置热重载 Plugin reload command: /jp reload (requires jiuwuplayerlistgui.reload permission), supports hot reload of configuration · 完善的插件启动日志，输出版本信息、PAPI检测状态 Comprehensive plugin startup logs, output version information and PAPI detection status · 操作确认流程文本可配置(确认/取消关键词自定义) Operation confirmation process text configurable (confirm/cancel keywords customizable) · 交互体验优化 | Interaction Experience Optimization · 翻页按钮逻辑重构，边界条件处理更严谨(如首页/末页按钮自动隐藏) Page turn button logic refactored, boundary condition handling more rigorous (e.g., first/last page buttons automatically hidden) · 装饰板自动填充，槽位配置错误时自动过滤无效值 Decoration panels automatically filled, invalid values automatically filtered when slot configuration is erroneous · 玩家头颅Lore文本支持国际化/自定义操作提示 Player head Lore text supports internationalization/custom operation prompts 代码规范与鲁棒性 | Code Standards and Robustness · 错误处理增强 | Error Handling Enhancement · MiniMessage解析异常捕获、类型校验、空值判断全覆盖 MiniMessage parsing exception catching, type validation, null value judgment fully covered · 原始版本无异常处理，重构后避免因配置错误导致插件崩溃 Original version had no exception handling; after refactoring, avoids plugin crashes due to configuration errors · 命名与注释规范 | Naming and Comment Standards · 类/方法/变量命名符合Python规范，添加详细中文注释 Class/method/variable naming conforms to Python standards, added detailed Chinese comments · 事件处理逻辑拆分清晰(GUI点击/聊天确认/插件启动独立处理) Event handling logic clearly split (GUI clicks/chat confirmation/plugin startup handled independently) · 服务端兼容优化 | Server Compatibility Optimization · 基于PaperMC API规范开发，适配Paper及衍生服务端(Purpur、Pufferfish等) Developed based on PaperMC API specifications, compatible with Paper and derivative servers (Purpur, Pufferfish, etc.) · 因依赖Kyori Adventure MiniMessage(Paper专属特性)，不兼容纯Spigot服务端 Due to dependency on Kyori Adventure MiniMessage (Paper-exclusive feature), not compatible with pure Spigot servers · 全局变量替换为Java HashMap，线程安全更优，适配多线程环境下的插件运行 Global variables replaced with Java HashMap, better thread safety, adapted for plugin operation in multi-threaded environments 命令与事件管理 | Command and Event Management · 命令系统优化 | Command System Optimization · 命令别名扩展: jp/jplg(原始仅plg) Command alias expansion: jp/jplg (original only plg) · 命令补全逻辑完善，根据权限动态显示可用子命令 Command completion logic improved, dynamically displays available subcommands based on permissions · 新增参数校验，缺失参数时返回清晰提示 Added parameter validation, returns clear prompts when parameters are missing · 事件监听规范 | Event Listening Standards · 事件取消逻辑更精准，仅拦截本插件GUI的点击事件 Event cancellation logic more precise, only intercepts click events for this plugin's GUI · 聊天确认流程优化，操作取消后自动重新打开GUI Chat confirmation process optimized, automatically reopens GUI after operation cancellation · 封禁/踢出/私信操作逻辑解耦，易于扩展 Ban/kick/tell operation logic decoupled, easy to extend