- 版权类型
- 原创
- 插件中文名称
- 云枢
- 插件英文名称
- yunshu
- 原帖地址
- #
- 支持的核心(服务端)
- Spigot
- Paper
- Purpur
- 语言支持
- 中文(简体)
- 前置组件
- 无必需组件
- 适配版本(Java)
- 1.21
论坛中的更新可能不及时可以点此处下载
---
一、为什么要写这个插件
开服的朋友大概都经历过这种局面:
装登录插件、装领地插件、装商店插件、装称号插件、装团队插件、装邮箱插件、装反作弊、装网页地图……
十几份配置、十几套权限、十几个作者,冲突起来谁都不认账,服务器卡了也找不到是谁的锅。
云枢把这些常见需求收进一个插件里:统一的中文箱子界面、统一的权限前缀 `yunshu.*`、统一的 SQLite 数据、一个 `/ys help` 就能看到全部指令。
---
二、功能一览
- `/reg` 注册、`/l` 登录、`/logout` 退出、`/changepassword` 改密
- 未登录玩家被放进空的隔离维度:看不到主世界,也不能移动、交互、破坏
- 同一 IP 两分钟内重连免登录
- 密码 AES-256-GCM 加密落库,密钥单独存放(`secret.key`,权限 600),不写明文审计
- 手持木铲:左键方块 = A 点,右键方块 = B 点,不用记坐标
- `/ys 领地 面板 创建`、`/ys 领地 列表`、`/ys 领地 删除`、`/ys 领地 购买`(买管理员发布的领地)
- 支持子领地,判定按最小体积优先生效,权限可逐项放开
- 12 项保护开关:建造、破坏、容器、使用、门、按钮、PVP、动物、活塞、爆炸、火焰、进入
- 最大体积 1 亿格,按体积计价,领地永不到期
- 管理员 `/ys 管理 领地` 建/删/发布/查,`/ys 领地管理 列表` 一眼看清全服领地和主人
- `/ys 商店` 分类浏览,左键买 1、右键买 16、Shift+左键买 64
- 购买前逐格核算背包剩余空间,装不下直接拒绝、绝不扣钱
- `/ys 经济 回收站` 回收站:单格点卖或一键全卖,`/ys 经济 出售` 快捷出售,`/ys 经济 购买` 快捷购买
- 经济走 Vault;没装 Vault 就用插件内置金币,不会因为换经济插件把数据搞丢
🏷 称号(带粒子特效)
- `/ys 称号` 佩戴/切换、`/ys 称号 商店` 花金币购买
- 七种特效:火焰、爱心、音符、星火、附魔、云雾、无
- 佩戴后头顶粒子 + 聊天前缀同时生效
- `/ys 称号 管理` 新建/上下架/给/收回/列表,支持中文称号名
- `/ys 团队 面板` 团队中心界面,创建、邀请、接受、退出、踢人、转让、改名、解散
- 捐钱进团队金库,金库升级团队(最高 10 级),人数上限随等级增长
- 团队频道 `/ys 团队 面板 聊天`、操作日志 `/ys 团队 面板 日志`、金库排行 `/ys 团队 面板 排行`
- `/ys 邮箱` 邮箱界面,可发信、可带附件(金币/物品)
- 附件领取同样检查背包空间,装不下就保留在邮箱里
- `/ys 经济 卡密 <卡密>` 兑换,管理员 `/ys 经济 卡密 新建 <码> [次数] [有效期] [奖励...]`
- 奖励串只要一行:`money:1000;item:DIAMOND:3;title:vip;cmd:say {player} 兑换成功`
- `/ys 公告 添加 进服|每日|每周|每月 <文本>`
- 进服提示按顺序轮播,每日/每周/每月按设定时刻自动全服广播
- `/ys 怪物 创建 <名字> <实体> [血量] [伤害] [速度] [主手装备]`
- 中文名字也支持,例如 `/ys 怪物 创建 强化僵尸 zombie 40 6 0.3 DIAMOND_SWORD`
- `/ys 怪物 生成 <名字> [数量]` 立刻刷出来
🛡 反透视 & 反作弊
- `/ys 系统 反透视` 直接读写 Paper 的反透视引擎开关与模式(1/2/3 级),改完重启生效
- `/ys 反作弊 总览` 检测瞬破方块、超距攻击(>4.5 格),可疑行为记入审计表并提醒在线管理
- `/ys 系统 节能 开启` 一键下调视距与模拟距离、关闭天气循环、降低随机刻
- `/ys 系统 节能 清理` 清掉地上所有掉落物与经验球,怪物超量时顺带清理
- 适合低配 VPS:实测 1 核 1G 的机器跑起来压力明显下降
- `/ys 服务器 网页开关 开启` 立刻起一个轻量网页面板,`/ys 服务器 网页` 给你带令牌的访问地址
- 面板每 3 秒刷新:TPS、在线人数、内存、世界数、领地数、团队数、玩家列表
- `/ys 服务器 端口转接 <状态|玩家|性能|领地|团队|公告> <开启|关闭>` 想公开什么自己定
- `/ys 服务器 网页开关 重置令牌` 随时换令牌
一个命令管所有世界:`/ys 世界 创建` 普通/超平坦/虚空,`/ys 世界 删除|加载|卸载|传送`,面板里点一下就换世界。更有意思的是 World Portal:点燃一座下界传送门,站进去输 `/ys 世界 传送门 资源区`,这座门从此通往资源区——每个门单独记目的地,`/ys 世界 传送门 清除` 立刻恢复原版。
默认 9 格起步,多页仓库(满级 216 格 / 4 页),另有末影箱锻造(1 格起步,每次 +13 格)。升级做成锻造玩法:成功升一级、火候不够原地不动、炸裂掉一级,前 12 级绝不会炸,越往上炸裂率越高(最高 30%)——想升满得掂量一下。仓库界面是插件里唯一保留箱子界面(CUI)的地方,因为要能直接放取东西。
首次进服发一个「菜单」钟表(带专属 NBT,右键即开),主菜单里还有一格只有管理员能看见的管理员菜单;如果服务器已经装了别的菜单插件,云枢菜单自动改走 `/ys menu`,不跟对面抢 `/menu`。
🏞 领地氛围
进领地 BOSS 栏直接提示「正在领地中」,边界末地烛光点自动描边,站在领地里聊天框敲 `land` 就能拉起这块领地的管理面板——改名、挂牌出售都是弹输入框,不用背指令。
⚒ 装备锻造(/ys 锻造)
把武器、工具、护甲丢进锻造台,插件自动认类型并按规则提升附魔:护甲先堆保护再堆其它保护(都满 10 级转耐久 +2),剑/斧有 10% 概率滚出火焰附加·击退·抢夺,重锤在密度与破甲之间摇摆,镐锹带 50% 时运,锄直接时运 +2,三叉戟锋利+耐久。每次都可能是成功 / 保持 / 失败,失败只扣金币与耐久,不毁装备;多付金币能把「失败 + 保持」的概率搬进成功。
右键玩家直接骑到他头上,被骑的人还能再骑别人,想叠多高叠多高。再右键或 `/ys 玩法 骑乘` 下车。
在游戏里直接问 AI,回复进聊天栏。走 OpenAI 兼容接口,`base-url`、密钥、模型、系统提示词都放 `AI.yml`,密钥不进 jar、不进仓库;带每分钟限流,改配置 `/ai 重新加载` 即可生效。
菜单不再只是箱子:新版服务端上直接用原生的 Dialog API 渲染(标题 + 说明 + 按钮,支持 ESC 关闭),条目太多或版本太老时自动退回箱子界面。配置 `ui.dialogs: true` 控制。
| 命令 | 用途 |
|---|---|
| `/ys 主菜单 打开` `/ys 主菜单 管理员` | 主菜单 / 管理菜单,全部配置化(`menu.yml`、`opmenu.yml`) |
| `/ys 系统 权限` | 不敲命令管 LuckPerms:加组、加权限、设父组、改前缀 |
| `/ys 传送 家` `/ys 传送 设置家` `/ys 传送 删除家` | 家园 |
| `/ys 传送 回城` `/ys 传送 设置出生点` `/ys 传送 出生点` | 传送点与出生点 |
| `/ys 传送 返回` `/ys 传送 死亡点` `/ys 传送 重生点` | 返回上一地点 / 死亡点 / 个人重生点 |
| `/ys 传送 请求` `/ys 传送 拉人` `/ys 传送 同意` `/ys 传送 拒绝` `/ys 传送 请求界面` | 传送请求(有延迟、冷却、过期) |
| `/ys 玩法 坐下` `/ys 玩法 趴下` `/ys 玩法 起身` `/ys 玩法 姿势` | 坐下、躺下、站起、姿势 |
| `/ys 玩法 飞行` `/ys 玩法 连锁采集` `/ys 玩法 速度` | 飞行、连锁采集、移动速度 |
| `/ys 假人 创建 <名字> [跟随|站桩]` | 假人(盔甲架+玩家头颅,重启后还在) |
| `/ys 服务器 假人客户端` | 内嵌客户端面板:地址、在线数、键位映射 |
| `/ys 管理 玩家` `/ys 玩家 禁言` `/ys 玩家 警告` `/ys 玩家 警告记录` | 封禁、禁言、警告 |
| `/ys 系统 权限申请` | OP 申请,管理后台审批 |
| `/ys 系统 性能` | 服务器性能报告 |
---
三、安装(三步)
- 把 `YunShu-1.21.11.jar`(或 `YunShu-26.3.jar`)丢进 `plugins/`
- 启动服务器,生成 `plugins/YunShu/` 配置目录
- 进游戏 `/ys` 看全部模块,`/ys 帮助 <模块>` 看细则,需要改的项在 `config.yml` 里
---
四、几个设计上的取舍(说给懂的人听)
- 数据只用 SQLite(WAL),不依赖 MySQL。开一个文件就能备份、迁移;量大再谈外置。
- 界面全部是箱子 GUI,不用记命令参数,鼠标点就行;所有文案中文。
- 所有列表类功能都有 `列表` 子参数,方便脚本和面板调用。
- 权限统一 `yunshu.<模块>.<动作>`,例如 `yunshu.land.admin`、`yunshu.shop.use`、`yunshu.title.admin`。
- 领地判定按"最小体积优先",子领地天然覆盖父领地规则,不需要额外优先级配置。
- 双版本编译:`paper-1.21.11` 与 `paper-26.3` 两个 Maven profile,用 toolchain 指定 JDK 21 / JDK 25,`./build.sh all` 一次出两个包。
- 26.x 只做编译适配:作者自己的服还在 1.21.11,26.3 的包只保证能编译、能加载,等正式用了再补运行时测试。
---
五、命令总览
所有功能统一走 `/ys <模块> <子命令>`(1.6.0 起),不带参数就列出全部模块:
代码:
/ys # 列出 22 个模块
/ys 帮助 领地 # 看「领地」模块每一条的用法
22 个模块:主菜单、测试、系统、服务器、反作弊、玩家、领地、传送、团队、经济、商店、仓库、锻造、邮箱、拍卖、称号、玩法、世界、假人、怪物、公告、管理。
一共 199 条路由,Tab 键三层补全(模块 → 子命令 → 参数)。
常用例子:
代码:
/ys 主菜单 打开 /ys 主菜单 管理员 /ys 系统 权限 /ys 系统 性能
/ys 传送 家 /ys 传送 回城 /ys 传送 请求 <玩家> /ys 传送 请求界面
/ys 领地 面板 /ys 领地 新建 /ys 领地 确认 /ys 领地 删除 <领地>
/ys 商店 /ys 仓库 /ys 锻造 /ys 称号 /ys 拍卖
/ys 团队 面板 /ys 邮箱 /ys 经济 卡密 /ys 公告 列表
/ys 玩法 坐下 /ys 玩法 飞行 /ys 玩法 速度 行走 0.3
/ys 假人 列表 /ys 服务器 假人客户端 列表 /ys 服务器 网页 /ys 服务器 端口转接 转发列表
/ys 玩家 封禁 <玩家> /ys 玩家 禁言 <玩家> /ys 玩家 举报队列
/ys 系统 重载 /ys 系统 版本 /ys 系统 状态
/ys 测试 开始 /ys 测试 继续 成功 /ys 测试 继续 失败 <理由>
只有登录相关的 9 条命令保留独立形式(要在没登录时就能用):
`/l`、`/reg`、`/login`、`/register`、`/changepassword`、`/logout`、`/2fa`、`/bind`、`/ys`。
模块名也认英文别名:`/ys test`、`/ys land`、`/ys shop`、`/ys tp`、`/ys admin` 与中文写法等价。
---
六、常见问题
Q:会不会覆盖原版命令?
不会。顶层只占了 `/ys`(别名 `/yunshu`)和登录相关的 8 条,其余全部收进 `/ys` 里;原版 `/reload`(重载数据包)保持不动,插件重载用 `/ys 系统 重载`。
Q:数据存哪?
`plugins/YunShu/yunshu.db`,SQLite 单文件,直接备份这一个文件即可。
Q:服里已经有 AuthMe / Residence / 商店插件了怎么办?
云枢各模块互相独立,用不到的功能不给权限即可,命令不会抢占别人的入口(除 `/reload`,已归还原版)。
Q:低配机器能跑吗?
作者自己的测试机是 1 核 1G 的 KVM,开了节能模式后稳定运行。跑起来建议 `/ys 系统 节能 开启`。
Q:更新会不会丢数据?
建表语句全部 `CREATE TABLE IF NOT EXISTS`,升级版本直接替换 jar 重启即可,不会动已有数据。
---
七、后续计划
- [ ] 商店支持玩家间上架(玩家市场)
- [ ] 领地可视化边界(粒子边框)
- [ ] 网页端加入在线管理(踢人、发公告)
- [ ] 26.3 正式上线后补齐运行时测试
---
八、反馈
遇到 bug 或者想要新功能,直接回帖告诉我版本、报错日志和复现步骤,能修的都会修。
如果这个插件帮你省下了装十几个插件的时间,回帖说一声就是最大的动力。
---
[align=center]—— 云枢 YunShu · 一个插件解决服务器 90% 的基础功能 ——[/align]