- ◆ 支持核心
- Spigot,PaperSpigot,Arclight
- ◆ 插件前置
- KongCore
- ◆ 游戏版本
- 1.21.1 1.21.11 26.2
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、通信或自定义槽位 |
安装
- 将 KongCorePlus 放入服务器的 plugins 目录。
- 确保 Redis 服务可访问。
- 修改 plugins/KongCorePlus/config.yml 中的 server-id 和 Redis 配置。
- 重启服务器,或在修改 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 连接池 |
YAML:
kongcoreplus.admin