- 版权类型
- 原创
- 插件中文名称
- 云枢
- 插件英文名称
- yunshu
- 原帖地址
- #
- 支持的核心（服务端）
- Spigot
- Paper
- Purpur
- 语言支持
- 中文（简体）
- 前置组件
- 无必需组件
- 适配版本（Java）
- 1.21
开服的朋友大概都经历过这种局面：
装登录插件、装领地插件、装商店插件、装称号插件、装团队插件、装邮箱插件、装反作弊、装网页地图……
十几份配置、十几套权限、十几个作者，冲突起来谁都不认账，服务器卡了也找不到是谁的锅。
一、统一性
云枢把这些常见需求收进一个插件里：统一的中文箱子界面、统一的权限前缀 `yunshu.*`、统一的 SQLite 数据、一个 `/ys help` 就能看到全部指令。
---
二、功能一览
登录注册（不装 AuthMe 也能用）
- `/reg` 注册、`/l` 登录、`/logout` 退出、`/changepassword` 改密
- 未登录玩家被放进 空的隔离维度：看不到主世界，也不能移动、交互、破坏
- 同一 IP 两分钟内重连免登录
- 密码 AES-256-GCM 加密落库，密钥单独存放（`secret.key`，权限 600），不写明文审计
领地（木铲圈地，子领地继承）
- 手持木铲：左键方块 = A 点，右键方块 = B 点，不用记坐标
- `/land 创建`、`/land 列表`、`/land 删除`、`/land 购买`（买管理员发布的领地）
- **支持子领地**，判定按最小体积优先生效，权限可逐项放开
- 12 项保护开关：建造、破坏、容器、使用、门、按钮、PVP、动物、活塞、爆炸、火焰、进入
- 最大体积 1 亿格，按体积计价，领地**永不到期**
- 管理员 `/landp` 建/删/发布/查，`/landp 列表` 一眼看清全服领地和主人
商店（防止"钱扣了东西没拿到"）
- `/shopall` 分类浏览，左键买 1、右键买 16、Shift+左键买 64
- **购买前逐格核算背包剩余空间**，装不下直接拒绝、绝不扣钱
- `/sellc` 回收站：单格点卖或一键全卖，`/sellt` 快捷出售，`/shopp` 快捷购买
- 经济走 Vault；没装 Vault 就用插件内置金币，不会因为换经济插件把数据搞丢
🏷 称号（带粒子特效）
- `/title` 佩戴/切换、`/titleshop` 花金币购买
- 七种特效：火焰、爱心、音符、星火、附魔、云雾、无
- 佩戴后头顶粒子 + 聊天前缀同时生效
- `/titleadmin` 新建/上下架/给/收回/列表，支持中文称号名
团队（10 级成长）
- `/team` 团队中心界面，创建、邀请、接受、退出、踢人、转让、改名、解散
- **捐钱进团队金库**，金库升级团队（最高 10 级），人数上限随等级增长
- 团队频道 `/team 聊天`、操作日志 `/team 日志`、金库排行 `/team 排行`
邮件 & 🎟 卡密
- `/mail` 邮箱界面，可发信、可带附件（金币/物品）
- 附件领取同样检查背包空间，装不下就保留在邮箱里
- `/cdk <卡密>` 兑换，管理员 `/cdk 新建 <码> [次数] [有效期] [奖励...]`
- 奖励串只要一行：`money:1000;item:DIAMOND:3;title:vip;cmd:say {player} 兑换成功`
定时消息提示
- `/announce 添加 进服|每日|每周|每月 <文本>`
- 进服提示按顺序轮播，每日/每周/每月按设定时刻自动全服广播
自定义怪物
- `/cmob 创建 <名字> <实体> [血量] [伤害] [速度] [主手装备]`
- **中文名字也支持**，例如 `/cmob 创建 强化僵尸 zombie 40 6 0.3 DIAMOND_SWORD`
- `/cmob 生成 <名字> [数量]` 立刻刷出来
🛡 反透视 & 反作弊
- `/fb1` 直接读写 Paper 的反透视引擎开关与模式（1/2/3 级），改完重启生效
- `/ac` 检测瞬破方块、超距攻击（>4.5 格），可疑行为记入审计表并提醒在线管理
节能模式（1 核小机器救星）
- `/savee 开启` 一键下调视距与模拟距离、关闭天气循环、降低随机刻
- `/savee 清理` 清掉地上所有掉落物与经验球，怪物超量时顺带清理
- 适合低配 VPS：实测 1 核 1G 的机器跑起来压力明显下降
网页管理端（不用装面板）
- `/webmp 开启` 立刻起一个轻量网页面板，`/web` 给你带令牌的访问地址
- 面板每 3 秒刷新：TPS、在线人数、内存、世界数、领地数、团队数、玩家列表
- `/webswitch <状态|玩家|性能|领地|团队|公告> <开启|关闭>` 想公开什么自己定
- `/webmp 重置令牌` 随时换令牌
其它小工具
| 命令 | 用途 |
|---|---|
| `/menu` `/opmenu` | 主菜单 / 管理菜单，全部配置化（`menu.yml`、`opmenu.yml`） |
| `/permiss` | 不敲命令管 LuckPerms：加组、加权限、设父组、改前缀 |
| `/home` `/sethome` `/delhome` | 家园 |
| `/main warp` `/setspawn` `/spawn` | 传送点与出生点 |
| `/back` `/backd` `/ssme` | 返回上一地点 / 死亡点 / 个人重生点 |
| `/tpa` `/tpahere` `/tpyes` `/tpno` `/tpgui` | 传送请求（有延迟、冷却、过期） |
| `/sit` `/lie` `/stand` `/pose` | 坐下、躺下、站起、姿势 |
| `/fly` `/chain` `/speed` | 飞行、连锁采集、移动速度 |
| `/fp 创建 <名字> [跟随|站桩]` | 假人（盔甲架+玩家头颅，重启后还在） |
| `/mcc` | 内嵌客户端面板：地址、在线数、键位映射 |
| `/banp` `/mute` `/warn` `/warnings` | 封禁、禁言、警告 |
| `/applyop` | OP 申请，管理后台审批 |
| `/perfor` | 服务器性能报告 |
---
三、安装（三步）
1. 把 `YunShu-1.21.11.jar丢进 `plugins/`
2. 启动服务器，生成 `plugins/YunShu/` 配置目录
3. 进游戏 `/ys help` 看全部命令，需要改的项在 `config.yml` 里
> 想用 LuckPerms 权限界面就装 LuckPerms；想用 Vault 经济就装 Vault。都不是必须的。
---
四、几个设计上的取舍（说给懂的人听）
- 数据只用 SQLite（WAL），不依赖 MySQL。开一个文件就能备份、迁移；量大再谈外置。
- 界面全部是箱子 GUI，不用记命令参数，鼠标点就行；所有文案中文。
- 所有列表类功能都有 `列表` 子参数**，方便脚本和面板调用。
- 权限统一 `yunshu.<模块>.<动作>`，例如 `yunshu.land.admin`、`yunshu.shop.use`、`yunshu.title.admin`。
- 领地判定按"最小体积优先"，子领地天然覆盖父领地规则，不需要额外优先级配置。
---
五、命令总览
```
/ys help # 全部命令帮助（分页）
/menu /opmenu /permiss /perfor
/reg /l /logout /changepassword
/home /sethome /delhome /main warp /setspawn /spawn /back /backd /ssme
/tpa /tpahere /tpyes /tpno /tpgui
/land /landd /landp
/shopall /shopp /sellt /sellc /shopadmin
/title /titleshop /titleadmin
/team
/mail /cdk /announce
/cmob /sit /lie /stand /pose /fly /chain /speed
/fp /mcc /savee /fb1 /ac
/web /webmp /webswitch
/banp /unbanp /mute /unmute /warn /warnings /applyop
/yunshu reload /yunshu version
```
---
六、常见问题
Q：会不会覆盖原版命令？
不会。唯一的例外已经处理掉：原版 `/reload`（重载数据包）保持不动，插件重载用 `/yunshu reload` 或 `/ys reload`。
Q：数据存哪？
`plugins/YunShu/yunshu.db`，SQLite 单文件，直接备份这一个文件即可。
Q：服里已经有 AuthMe / Residence / 商店插件了怎么办？
云枢各模块互相独立，用不到的功能不给权限即可，命令不会抢占别人的入口（除 `/reload`，已归还原版）。
Q：低配机器能跑吗？
作者自己的测试机是 1 核 1G 的 KVM，开了节能模式后稳定运行。跑起来建议 `/savee 开启`。
Q：更新会不会丢数据？
建表语句全部 `CREATE TABLE IF NOT EXISTS`，升级版本直接替换 jar 重启即可，不会动已有数据。
---
## 七、后续计划
- [ ] 商店支持玩家间上架（玩家市场）
- [ ] 领地可视化边界（粒子边框）
- [ ] 网页端加入在线管理（踢人、发公告）
- [ ] 26.3 正式上线后补齐运行时测试
---
八、反馈
遇到 bug 或者想要新功能，直接回帖告诉我版本、报错日志和复现步骤，能修的都会修。
如果这个插件帮你省下了装十几个插件的时间，回帖说一声就是最大的动力。
许可证：作者自用为主，允许转载与二次修改，请保留原作者信息。
装登录插件、装领地插件、装商店插件、装称号插件、装团队插件、装邮箱插件、装反作弊、装网页地图……
十几份配置、十几套权限、十几个作者，冲突起来谁都不认账，服务器卡了也找不到是谁的锅。
一、统一性
云枢把这些常见需求收进一个插件里：统一的中文箱子界面、统一的权限前缀 `yunshu.*`、统一的 SQLite 数据、一个 `/ys help` 就能看到全部指令。
---
二、功能一览
登录注册（不装 AuthMe 也能用）- `/reg` 注册、`/l` 登录、`/logout` 退出、`/changepassword` 改密
- 未登录玩家被放进 空的隔离维度：看不到主世界，也不能移动、交互、破坏
- 同一 IP 两分钟内重连免登录
- 密码 AES-256-GCM 加密落库，密钥单独存放（`secret.key`，权限 600），不写明文审计
领地（木铲圈地，子领地继承）- 手持木铲：左键方块 = A 点，右键方块 = B 点，不用记坐标
- `/land 创建`、`/land 列表`、`/land 删除`、`/land 购买`（买管理员发布的领地）
- **支持子领地**，判定按最小体积优先生效，权限可逐项放开
- 12 项保护开关：建造、破坏、容器、使用、门、按钮、PVP、动物、活塞、爆炸、火焰、进入
- 最大体积 1 亿格，按体积计价，领地**永不到期**
- 管理员 `/landp` 建/删/发布/查，`/landp 列表` 一眼看清全服领地和主人
商店（防止"钱扣了东西没拿到"）- `/shopall` 分类浏览，左键买 1、右键买 16、Shift+左键买 64
- **购买前逐格核算背包剩余空间**，装不下直接拒绝、绝不扣钱
- `/sellc` 回收站：单格点卖或一键全卖，`/sellt` 快捷出售，`/shopp` 快捷购买
- 经济走 Vault；没装 Vault 就用插件内置金币，不会因为换经济插件把数据搞丢
🏷 称号（带粒子特效）
- `/title` 佩戴/切换、`/titleshop` 花金币购买
- 七种特效：火焰、爱心、音符、星火、附魔、云雾、无
- 佩戴后头顶粒子 + 聊天前缀同时生效
- `/titleadmin` 新建/上下架/给/收回/列表，支持中文称号名
团队（10 级成长）- `/team` 团队中心界面，创建、邀请、接受、退出、踢人、转让、改名、解散
- **捐钱进团队金库**，金库升级团队（最高 10 级），人数上限随等级增长
- 团队频道 `/team 聊天`、操作日志 `/team 日志`、金库排行 `/team 排行`
邮件 & 🎟 卡密- `/mail` 邮箱界面，可发信、可带附件（金币/物品）
- 附件领取同样检查背包空间，装不下就保留在邮箱里
- `/cdk <卡密>` 兑换，管理员 `/cdk 新建 <码> [次数] [有效期] [奖励...]`
- 奖励串只要一行：`money:1000;item:DIAMOND:3;title:vip;cmd:say {player} 兑换成功`
定时消息提示- `/announce 添加 进服|每日|每周|每月 <文本>`
- 进服提示按顺序轮播，每日/每周/每月按设定时刻自动全服广播
自定义怪物- `/cmob 创建 <名字> <实体> [血量] [伤害] [速度] [主手装备]`
- **中文名字也支持**，例如 `/cmob 创建 强化僵尸 zombie 40 6 0.3 DIAMOND_SWORD`
- `/cmob 生成 <名字> [数量]` 立刻刷出来
🛡 反透视 & 反作弊
- `/fb1` 直接读写 Paper 的反透视引擎开关与模式（1/2/3 级），改完重启生效
- `/ac` 检测瞬破方块、超距攻击（>4.5 格），可疑行为记入审计表并提醒在线管理
节能模式（1 核小机器救星）- `/savee 开启` 一键下调视距与模拟距离、关闭天气循环、降低随机刻
- `/savee 清理` 清掉地上所有掉落物与经验球，怪物超量时顺带清理
- 适合低配 VPS：实测 1 核 1G 的机器跑起来压力明显下降
网页管理端（不用装面板）- `/webmp 开启` 立刻起一个轻量网页面板，`/web` 给你带令牌的访问地址
- 面板每 3 秒刷新：TPS、在线人数、内存、世界数、领地数、团队数、玩家列表
- `/webswitch <状态|玩家|性能|领地|团队|公告> <开启|关闭>` 想公开什么自己定
- `/webmp 重置令牌` 随时换令牌
其它小工具| 命令 | 用途 |
|---|---|
| `/menu` `/opmenu` | 主菜单 / 管理菜单，全部配置化（`menu.yml`、`opmenu.yml`） |
| `/permiss` | 不敲命令管 LuckPerms：加组、加权限、设父组、改前缀 |
| `/home` `/sethome` `/delhome` | 家园 |
| `/main warp` `/setspawn` `/spawn` | 传送点与出生点 |
| `/back` `/backd` `/ssme` | 返回上一地点 / 死亡点 / 个人重生点 |
| `/tpa` `/tpahere` `/tpyes` `/tpno` `/tpgui` | 传送请求（有延迟、冷却、过期） |
| `/sit` `/lie` `/stand` `/pose` | 坐下、躺下、站起、姿势 |
| `/fly` `/chain` `/speed` | 飞行、连锁采集、移动速度 |
| `/fp 创建 <名字> [跟随|站桩]` | 假人（盔甲架+玩家头颅，重启后还在） |
| `/mcc` | 内嵌客户端面板：地址、在线数、键位映射 |
| `/banp` `/mute` `/warn` `/warnings` | 封禁、禁言、警告 |
| `/applyop` | OP 申请，管理后台审批 |
| `/perfor` | 服务器性能报告 |
---
三、安装（三步）
1. 把 `YunShu-1.21.11.jar丢进 `plugins/`
2. 启动服务器，生成 `plugins/YunShu/` 配置目录
3. 进游戏 `/ys help` 看全部命令，需要改的项在 `config.yml` 里
> 想用 LuckPerms 权限界面就装 LuckPerms；想用 Vault 经济就装 Vault。都不是必须的。
---
四、几个设计上的取舍（说给懂的人听）
- 数据只用 SQLite（WAL），不依赖 MySQL。开一个文件就能备份、迁移；量大再谈外置。
- 界面全部是箱子 GUI，不用记命令参数，鼠标点就行；所有文案中文。
- 所有列表类功能都有 `列表` 子参数**，方便脚本和面板调用。
- 权限统一 `yunshu.<模块>.<动作>`，例如 `yunshu.land.admin`、`yunshu.shop.use`、`yunshu.title.admin`。
- 领地判定按"最小体积优先"，子领地天然覆盖父领地规则，不需要额外优先级配置。
---
五、命令总览
```
/ys help # 全部命令帮助（分页）
/menu /opmenu /permiss /perfor
/reg /l /logout /changepassword
/home /sethome /delhome /main warp /setspawn /spawn /back /backd /ssme
/tpa /tpahere /tpyes /tpno /tpgui
/land /landd /landp
/shopall /shopp /sellt /sellc /shopadmin
/title /titleshop /titleadmin
/team
/mail /cdk /announce
/cmob /sit /lie /stand /pose /fly /chain /speed
/fp /mcc /savee /fb1 /ac
/web /webmp /webswitch
/banp /unbanp /mute /unmute /warn /warnings /applyop
/yunshu reload /yunshu version
```
---
六、常见问题
Q：会不会覆盖原版命令？
不会。唯一的例外已经处理掉：原版 `/reload`（重载数据包）保持不动，插件重载用 `/yunshu reload` 或 `/ys reload`。
Q：数据存哪？
`plugins/YunShu/yunshu.db`，SQLite 单文件，直接备份这一个文件即可。
Q：服里已经有 AuthMe / Residence / 商店插件了怎么办？
云枢各模块互相独立，用不到的功能不给权限即可，命令不会抢占别人的入口（除 `/reload`，已归还原版）。
Q：低配机器能跑吗？
作者自己的测试机是 1 核 1G 的 KVM，开了节能模式后稳定运行。跑起来建议 `/savee 开启`。
Q：更新会不会丢数据？
建表语句全部 `CREATE TABLE IF NOT EXISTS`，升级版本直接替换 jar 重启即可，不会动已有数据。
---
## 七、后续计划
- [ ] 商店支持玩家间上架（玩家市场）
- [ ] 领地可视化边界（粒子边框）
- [ ] 网页端加入在线管理（踢人、发公告）
- [ ] 26.3 正式上线后补齐运行时测试
---
八、反馈
遇到 bug 或者想要新功能，直接回帖告诉我版本、报错日志和复现步骤，能修的都会修。
如果这个插件帮你省下了装十几个插件的时间，回帖说一声就是最大的动力。
许可证：作者自用为主，允许转载与二次修改，请保留原作者信息。
