原创 前置/API KongCorePlus 空之图形官方附属前置 — kong官方附属的前置，包括Redis/Mysql等复用内容 [1.21.1 - 26.2] 1.0.1

[MD] # KongCorePlus KongCorePlus 是面向 Bukkit、Spigot、Paper 服务端的附属核心插件。它为多个业务插件提供统一的 Redis、MySQL、跨服在线玩家、KongCore 客户端通信、槽位操作，以及一致的命令与后台加载提示样式。 KongCorePlus 自身不承载具体玩法。它的职责是让附属插件不用重复处理连接池、跨服状态和客户端通信等基础能力。 ## 核心能力 - 默认 Redis 连接池和跨服在线玩家同步。 - 可由附属插件按连接 ID 创建、获取和关闭 MySQL 连接池。 - 可由附属插件按连接 ID 创建、获取和关闭独立 Redis 连接池。 - 跨服在线玩家查询，提供同步和异步 API。 - KongCore 客户端通信封装：GUI、Segment、JavaScript、占位符和自定义数据。 - KongCore 自定义槽位读写、缓存读取、序列化与回调操作。 - 统一命令提示 API：帮助菜单、状态列表、成功/错误消息和 Tab 补全。 - 统一后台加载面板 API，附属插件可复用 KongCorePlus 的加载日志样式。 ## 运行环境 | 项目 | 要求 | | --- | --- | | Java | 17 或更高版本 | | 服务端 | Bukkit / Spigot / Paper，API 版本 1.21 | | Redis | 必需，用于默认跨服在线同步 | | KongCore | 必需；提供 GUI、通信或自定义槽位 | ## 安装 1. 将 `KongCorePlus` 放入服务器的 `plugins` 目录。 2. 确保 Redis 服务可访问。 3. 修改 `plugins/KongCorePlus/config.yml` 中的 `server-id` 和 Redis 配置。 4. 重启服务器，或在修改 Redis 后执行 `/kcp reload redis`。 ## 配置 ```yaml # 子服务器唯一标识。多台服务器共用 Redis 时不能重复。 server-id: "lobby" redis: host: "127.0.0.1" port: 6379 password: "" timeout-millis: 2000 max-total: 20 ``` `server-id` 是跨服玩家分组的依据。多个子服务器连接同一 Redis 时必须配置不同的值。 ## 管理命令 | 命令 | 说明 | | --- | --- | | `/kcp` | 显示管理帮助 | | `/kcp help` | 显示管理帮助 | | `/kcp status` | 查看 KongCorePlus、Redis 和 KongCore 状态 | | `/kcp reload` | 重载 KongCorePlus 配置 | | `/kcp reload config` | 重载 KongCorePlus 配置 | | `/kcp reload redis` | 重载配置并重建默认 Redis 连接池 | 权限节点： ```text kongcoreplus.admin ``` [/MD]