- 版权类型
- 二次开发
- 插件中文名称
- 一体化服务器管理插件
- 插件英文名称
- AllInOneCore
- 支持的核心(服务端)
- Paper
- 语言支持
- 多语言
- 前置组件
- JDK 21(必须,Paper 1.21 API 需要 Java 21 字节码)
Maven 3.9+
Vault 软依赖;未安装 Vault 时自动使用内置经济
- 适配版本(Java)
- 最新版本
[MD]
# AllInOneCore 一体化服务器管理插件
适用于 **Paper 1.21.x / Java 21** 的一体化服务器管理插件,单个 jar 开箱即用。经济、菜单、传送、公告、维护、清理、国家/领地、WebUI 后台等功能全部内置,每个功能都可在 `config.yml` 中单独开关。
- 插件名:`AllInOneCore`
- 版本:`1.0.1`
- 目标端:Paper 1.21.1+(1.21.x 均可)
- Java:21
- 数据存储:SQLite(内置驱动,零依赖);预留 MySQL 配置
- 经济后端:Vault 软依赖;未安装 Vault 时自动使用内置经济
---
## 一、安装
1. 确认服务端为 **Paper 1.21.x**,且使用 **Java 21** 启动。
2. 将 `AllInOneCore-1.0.0.jar` 放入服务端 `plugins/` 目录。
3. 启动服务器,插件会自动生成:
```
plugins/AllInOneCore/
├── config.yml # 主配置(模块开关 + 各功能参数)
├── messages.yml # 默认中文文案
├── lang/
│ ├── zh_CN.yml # 中文覆盖(默认留空)
│ └── en_US.yml # 英文文案
├── menus/
│ └── main.yml # 主菜单(PMenu 兼容格式)
├── data.db # SQLite 数据库(玩家/经济/家/领地/公告/红包…)
└── update/ # 自动更新下载目录(启用后生成)
```
4. 使用 `/sethub` 设置回城点,`/cd` 打开主菜单。
5. 可选依赖(软依赖,不安装也能用):
| 插件 | 作用 |
| --- | --- |
| Vault | 让本插件接入其它经济插件,或作为经济提供者被其它插件调用 |
| ProtocolLib | `/crash` 的实验性协议模式预留(未安装时自动使用安全断开) |
| PlaceholderAPI | 预留变量扩展位(当前版本菜单内置 `{player}`、`{online}`、`{balance}` 等变量) |
> 安装 Vault 但没有其它经济插件时,本插件会自动注册为 Vault 经济提供者,其它插件可直接使用本插件经济。
---
## 二、功能清单
| 功能 | 模块 id | 说明 |
| --- | --- | --- |
| 经济核心 | `economy` | 余额、转账、排行榜、GUI、`/moneys` 管理;Vault 优先,内置兜底 |
| 菜单 GUI | `menu` | 完全兼容 PMenu 的菜单 YAML,可一键迁移;菜单钟 |
| 一键回城 | `hub` | `/hub` 回城,`/sethub` 设置 |
| 随机传送 | `rtp` | 跨维度、安全落点、读条动画、冷却重置 |
| TPA 传送 | `tpa` | `/tpa`、`/tpahere`、同意/拒绝/全局模式 |
| 家系统 | `home` | 多 homes、GUI、上限控制 |
| 公共传送点 | `warp` | GUI、分页、图标自定义 |
| 灵魂出窍 | `fcam` | 旁观者模式,自动回到身体 |
| 返回死亡点 | `back` | 死亡/传送记录,`/back` |
| 死亡记录 | `deathlog` | `/deathlog [玩家]` 最近 10 条 |
| 动态 MOTD | `motd` | 多行轮播,支持 `{online}`/`{max}`/`{version}` |
| 维护模式 | `maintenance` | `/wh`,白名单、维护 MOTD、踢出提示 |
| 自动清理 | `clean` | 定时 + 掉落物阈值触发,物品/实体白名单,`/clean` 管理 |
| 玩家自杀 | `suicide` | `/suicide` |
| 关服提示 | `stopmsg` | 拦截 `/stop`,延迟倒计时后关服 |
| 多语言 | — | `messages.yml` + `lang/*.yml`,内置中/英 |
| 自定义公告 | `notice` | 颜色/换行、游戏内编辑、GUI、定时轮播、全体/国家/领地分级 |
| 经验球防卡 | `fixexp` | 按区块合并过量经验球 |
| 崩溃客户端 | `crash` | `/crash` 选择玩家;默认安全断开模式 |
| 红包 | `redpacket` | `/redpacket`、`/rp`、拼手气、历史、GUI 说明 |
| 跨服传送 | `serverstp` | BungeeCord/Velocity 插件消息 |
| PVP 开关 | `pvp` | 个人开关、拦截投掷物/箭矢、自定义爆炸实体、领地规则联动 |
| 死亡不掉落 | `keepinventory` | 开服自动对所有世界开启 |
| 每日签到 | `sign` | 连续签到递增奖励,`/signset` 设置 |
| 自动更新 | `autoupdate` | GitHub Release 检查/下载(默认关闭) |
| 统计信息 | `stats` | 在线人数/TPS/模块状态,可关闭、可自建上报端点 |
| WebUI | `webui` | 本地网页修改配置、查看玩家/国家/经济/公告,可监听 0.0.0.0 |
| 国家/领地 | `nation` | 建国、成员权限分级、区块圈定、规则、税收、外交、边界可视化 |
| 高级后台 | `admin` | `/core` 游戏内 GUI 面板 + 管理指令,配合 WebUI |
---
## 三、指令与权限
### 玩家指令
| 指令 | 说明 | 权限 |
| --- | --- | --- |
| `/cd` | 打开主菜单 | `allinone.menu` |
| `/menu [open|list|reload|migrate|set]` | 菜单管理 / 打开指定菜单 | `allinone.menu`(管理需 `allinone.menu.admin`) |
| `/getclock` | 获取菜单钟 | `allinone.menu` |
| `/home [名称]` | 家系统菜单 / 传送 | `allinone.home` |
| `/sethome [名称]`、`/delhome [名称]` | 设置/删除家 | `allinone.home` |
| `/tpa <玩家>`、`/tpa here <玩家>` | 发送传送请求 | `allinone.tpa` |
| `/tpayes [玩家]`、`/tpano [玩家]` | 同意/拒绝 | `allinone.tpa` |
| `/tpasettings <accept|deny|ask>` | 全局自动同意/拒绝 | `allinone.tpa` |
| `/rtp [世界]` | 跨维度安全随机传送 | `allinone.rtp` |
| `/rtpreset <玩家|all>` | 重置随机传送冷却 | `allinone.rtpreset` |
| `/pvp [on|off]` | 开关个人 PVP | `allinone.pvp` |
| `/warp [名称]` | 公共传送点菜单/传送 | `allinone.warp` |
| `/setwarp <名称> [图标]`、`/delwarp <名称>` | 管理传送点 | `allinone.warp.admin` |
| `/hub` | 回城 | `allinone.hub` |
| `/sethub` | 设置回城点 | `allinone.hub.admin` |
| `/servers` | 跨服传送菜单 | `allinone.servers` |
| `/back` | 回到死亡/上次传送点 | `allinone.back` |
| `/deathlog [玩家]` | 死亡记录 | `allinone.deathlog` |
| `/money [玩家]` | 查询余额 | `allinone.money` |
| `/moneygui` | 经济 GUI | `allinone.moneygui` |
| `/moneys <add|del|set|get> <玩家> [金额]` | 管理员经济操作 | `allinone.money.admin` |
| `/notice` | 查看公告 | `allinone.notice` |
| `/noticeset ...` | 公告编辑 | `allinone.notice.admin` |
| `/clean [air|status|cancel|tps|help|toast]` | 清理管理 | `allinone.clean` |
| `/wh [on|off|status|add|remove|list]` | 维护模式 | `allinone.maintenance` |
| `/suicide` | 自杀 | `allinone.suicide` |
| `/fcam` | 灵魂出窍 | `allinone.fcam` |
| `/crash [玩家]` | 崩溃客户端菜单 | `allinone.crash` |
| `/redpacket <send|list|open|history|help>` | 红包 | `allinone.redpacket` |
| `/rp <金额> <个数> [备注]` | 红包短指令 | `allinone.redpacket` |
| `/redpackethelp` | 红包功能 GUI 说明 | `allinone.redpacket` |
| `/sign` | 每日签到 | `allinone.sign` |
| `/signset <reward|streak|reset|status>` | 签到设置 | `allinone.sign.admin` |
| `/nation ...` | 国家系统 | `allinone.nation` |
| `/claim ...` | 领地系统 | `allinone.claim` |
| `/core [gui|reload|modules|status|webui|maintenance|economy|nation|notices]` | 管理后台 | `allinone.admin` |
权限节点统一前缀 `allinone.`,`allinone.admin` 默认包含全部子权限并默认仅 OP 拥有。
### 国家指令
```
/nation create <名称> <简称> [open] 建国(默认花费 5000)
/nation info [国家] / list 查看国家/列表
/nation invite <玩家> 邀请(首领/官员)
/nation accept <国家> / join <国家> 接受邀请 / 开放加入
/nation leave 退出国家
/nation deposit|withdraw <金额> 国库存取
/nation tax <百分比> 设置税率(0-50)
/nation open <true|false> 是否开放加入
/nation rank <玩家> <OFFICER|MEMBER> 设置职位
/nation home [set] 国家传送点
/nation rule <规则> <true|false> 领地规则
/nation ally|enemy|neutral <国家> 外交关系
/nation gui 国家管理 GUI
/nation admin disband <国家> 强制解散(管理员)
```
### 领地指令
```
/claim radius <区块半径> 以脚下区块为中心圈定(消耗国库)
/claim unclaim 取消当前区块
/claim info 查看当前区块归属与规则
/claim list 列出国家全部领地
/claim rule <规则> <值> 修改规则
/claim map 附近领地字符地图
/claim gui 打开国家/领地面板
```
可用规则:`PVP`、`BUILD`、`CONTAINER`、`INTERACT`、`EXPLOSION`、`MOB_GRIEF`、`ENTRY`。
- `true` 表示允许外人操作/生效,`false` 表示禁止。
- 领地主、官员与拥有 `allinone.bypass` 的玩家不受建筑限制。
---
## 四、配置要点
- `modules.*`:所有模块开关,改完需重启或 `/core reload`(模块启停需重启完全生效)。
- `economy.*`:起始余额、货币名、转账税、Vault 接管开关。
- `teleport.*`:读条、冷却、RTP 半径与动画、TPA 过期时间。
- `menu.folder`:菜单目录;`menus/main.yml` 为默认主菜单。
- `notice.interval-seconds`:公告轮播间隔;也可用 `/noticeset interval` 在线修改。
- `clean.*`:定时清理、阈值、白名单(物品材质名、实体类型名)。
- `maintenance.*`:维护提示、踢出文案、白名单。
- `nation.*`:建国/领地费用、上限、税率、规则默认值、边界粒子。
- `webui.*`:WebUI 监听地址、端口、令牌、是否允许在线改配置。
### WebUI
```yaml
webui:
enabled: true
host: 0.0.0.0 # 暴露公网时改为 0.0.0.0,并务必修改 token + 配置防火墙
port: 8123
token: "change-me" # 必须修改
```
启动后访问 `http://127.0.0.1:8123/`,输入 token 后可:
- 查看运行状态、模块开关状态、在线玩家、国家数据、经济排行;
- 一键切换维护模式、重载配置;
- 在线编辑 `config.yml`(保存后自动校验 YAML 并重载)。
> 安全提示:WebUI 使用简单令牌鉴权,请勿在公网使用默认 token;对外暴露时建议再套一层反向代理(Nginx)与 HTTPS/白名单。
### PMenu 菜单迁移
1. 将 PMenu 的菜单文件放入 `plugins/AllInOneCore/menus/`;
2. 或执行 `/menu migrate`,插件会自动从 `plugins/PMenu/menus`、`plugins/PMenu/gui` 复制菜单文件;
3. 执行 `/menu reload`。
支持字段:`menu_title`/`title`、`size`/`rows`、`open_command`、`items`(映射或列表)、`material`、`slot`、`display_name`/`name`、`lore`、`left_click_commands`、`right_click_commands`。
指令前缀支持:`[player]`、`[console]`、`[close]`、`[openguimenu]`、`[message]`、`[sound]`、`[actionbar]`。
---
## 五、数据存储
- 默认 SQLite:`plugins/AllInOneCore/data.db`。
- `storage.type: mysql` 可切换 MySQL;本插件不内置 MySQL 驱动,需在服务端 `libraries/` 或插件类路径中提供 `com.mysql.cj.jdbc.Driver`,否则会自动回退 SQLite 并在控制台提示。
- 数据表:`players`、`homes`、`warps`、`deaths`、`notices`、`nations`、`nation_members`、`nation_claims`、`nation_rules`、`nation_relations`、`nation_invites`、`redpackets`、`redpacket_claims`、`meta`、`webui_sessions`。
---
## 六、已知限制 / 说明
1. **`/crash`**:出于安全考虑,默认只执行“强制断开连接”(安全模式)。`crash.mode: protocol` 为预留项,需 ProtocolLib 支持,当前版本仍回退为安全断开,不会发送恶意数据包。
2. **自动更新**:从 GitHub Release 下载 jar 到 `plugins/AllInOneCore/update/`。Windows 下已加载的 jar 无法被覆盖,更新后需重启服务器;`reload-after-update` 默认关闭(Paper 不建议热重载)。
3. **MySQL**:仅预留配置与连接逻辑,需自行提供驱动。
4. **多语言**:`messages.yml` 为默认中文;`lang/en_US.yml` 提供英文覆盖。切换前请确保对应文件存在。
5. **WebUI 暴露公网**:默认 `token: change-me`,请务必修改;插件仅提供令牌级鉴权,建议配合反向代理。
6. 本插件全部代码为独立实现,仅参考了 EssentialsX、Vault、PMenu、TeleportMaster、BentoBox 等插件的公开设计思路,未拷贝其受版权保护的代码。
---
## 七、构建
见 [BUILD.md](BUILD.md)。插件`AllInOneCore-1.0.0.jar`。
[/MD]