资源图标

原创 工具 世界管理 经济 云枢 YunShu —— 一个插件解决服务器 90% 的基础功能(登录 · 领地 · 商店 · 称号 · 团队 · 网页管理端) 1.8.2

请登录后获取
云枢 · 更新日志

版本号与 pom.xml 同步。日期为构建日期。
标记说明:新增 新功能 · 优化 行为改进 · 修复 修掉的问题 · 变更 不兼容调整。




1.8.2 · 2026-11-20

领地提示跨维度失效:修好


在下界、末地、多世界模块建出来的世界里圈的地,进去之后看不到 BOSS 栏、也没有边界粒子。
原因是两件事叠在一起:

  • 领地查询靠一张「世界 + 区块 → 领地」的索引表,老数据或异常退出可能留下有领地没索引的行,
    这种领地在任何维度都查不到;
  • 领地氛围的定时任务只要有一个玩家那里抛异常,整条任务就被服务端停掉,之后谁都不再提示。

现在:

  • 启动时自动补写缺失的索引(/ysm 领地 重建索引 可以手动重建全部);
  • 索引里查不到的区块会兜底按世界扫一遍,命中后顺手把索引补上(3 秒缓存,不会每 tick 全表扫);
  • 每个玩家单独 try/catch,一个人出错不影响别人,也不会把定时任务带停;
  • BOSS 栏标题带上世界:正在领地中:<领地>(主人 <玩家>) · 下界(world_nether)。

领地边界粒子加强

  • 沿领地这一层的四条边继续描点,新增四条竖棱(上下各 4 格),3D 领地能看出高度范围;
  • 刚踏进一块新领地时沿边界撒一圈并提示一句「进入 xxx(主人 xxx,世界 xxx)」;
  • 玩家站在领地高度范围之外时,粒子画在他脚下那一层,不会凭空消失。

更新日志

只保留 1.8.0 及之后的记录,更早的版本不再堆在文件里。




1.8.1 · 2026-11-20

指令分成两套:/ys 给玩家,/ysm 给管理员


以前管理员指令和玩家指令混在一个 /ys 列表里,普通玩家翻帮助会看到一堆自己不能用的东西。这一版按权限拆开:

  • /ys 只有玩家能用的指令(传送、领地、商店、经济、任务…),敲管理员指令会提示"请用 /ysm";
  • /ysm 只有管理员指令(系统、服务器、反作弊、管理、公告、世界创建/删除/加载/卸载…),需要 yunshu.admin;
  • 两边的帮助列表、Tab 补全都各管各的;
  • 菜单里的每个格子也换成了对应入口,管理员格子在菜单里带权限,普通玩家看不见。

命令提示写清楚了

以前帮助长这样:/ys 世界 创建 创建世界 <名字> [类型] [环境]——重复一遍还写"名字"。
现在统一成参数形式:/ys 世界 创建 <世界名称> [类型: normal|flat|amplified] [环境: normal|nether|the_end]。
没有参数的指令不再重复描述。

口语化的名字改成正经说法

  • 传送 拉人 → 传送 请求对方过来(旧名字还能用,自动转成新指令)
  • 传送 全体拉人 → 传送 全体请求对方过来
  • 假人 传过来 → 假人 传送到我身边

修掉的问题

  • 领地传送失灵:/ys 领地 全部 之前只有管理员能开,玩家点菜单里的「领地传送」直接提示没权限。现在所有人可用,列表左键传送、右键看详情。
  • 玩家传送列表打不开:跨世界点开玩家列表时计算距离会抛异常,整个界面打不开。现在跨世界显示"另一个世界"。
  • 管理菜单点了只弹提示:管理菜单里的按钮以前指向已经收拢的老命令,点下去只打印帮助。现在全部换成 /ysm 路由,点进去就是真操作,或者进子页面。

菜单补齐

  • 传送页补上世界传送(世界列表、指定世界传送、世界面板);
  • 管理页补上世界管理(创建、删除、加载、卸载);
  • 经济页补上末影箱、随身背包、我的拍卖、求购、签到、排行、投票、抽奖、礼包;
  • 生存页补上随身工作台、末影箱、垃圾桶、自助恢复、头顶信息、挂机;
  • 玩法页补上改昵称、骑乘、随身背包、偏好设置;
  • 领地页补上子领地黑名单、子领地高度、领地传送、排行、出售;
  • 删掉没人引用的旧菜单 menu-social.yml、menu-speed.yml。


云枢 · 更新日志1.3→1.8

版本号与 pom.xml 同步。日期为构建日期。
标记说明:新增 新功能 · 优化 行为改进 · 修复 修掉的问题 · 变更 不兼容调整。




1.8.0 · 2026-11-19

假人:不再是盔甲架,是真正的服务端玩家


上一版的假人本质是盔甲架(MCC 那种),只能站着看,不加载区块、不参与刷怪、也打不了。
这一版换成真的 ServerPlayer:配一个没有网络的连接,交给服务端正常的登录流程上线。

  • 会加载周围区块,所以能在假人旁边刷怪;
  • 有生命值,能被攻击(/ys 假人 攻击开关 <名字> 开|关),也会被打死;
  • 有背包:给 发物品、装备 把你这一身穿给它、使用 让它用主手(吃东西、喝药水都真的生效);
  • 能 攻击 八格内最近的怪、看向 你、传过来、移动;
  • 服务器重启后自动按数据库里的位置重新上线,错峰上线不卡服;
  • 整段用反射调用,插件不依赖服务端内部结构,26.3 照样能编译;版本对不上时会明确提示"假人功能不可用",不会把服务器带崩。

商店:展示页改成箱子界面,物品名全中文

对话框界面里物品名是靠客户端翻译的,换个客户端语言就变英文。展示页改成箱子界面(服务端渲染),
所以必须自己把名字写成中文——这一版带了一张 2400 多条的中文名对照表(item-zh.properties),
/ys 商店 里看到的全是中文名加价格,点进去的批量购买页仍然是对话框(TUi)。

领地:扩大能填负数、子领地是真 3D、子领地能单独拉黑人

  • /ys 领地 扩大 <领地> <格数>:正数往外扩,负数往里收;收缩会退回一半费用,且不允许把子领地挤出去;
  • /ys 领地 高度 <领地> <下> <上>:子领地只占指定的这几层,上面下面还能再圈;
  • /ys 领地 排除 <领地> <玩家>:在子领地里封掉某个主领地信任的人,黑名单只对这块子领地生效;
  • 子领地没单独设身份时自动继承主领地,设了黑名单就一票否决。

菜单:8 个一级分类,点了就直接做事

以前很多格子点下去只是把命令帮助打出来,因为还指着一堆早就收拢进 /ys 的旧命令。这一版:

  • 一级菜单固定 8 类:传送、经济、任务、领地、团队、生存、玩法、玩家信息(管理员额外看到「管理」);
  • 每个分类页都有「返回主菜单」,所有动作都改写成 /ys 路由,点一下就是真的执行;
  • 菜单里的 cmd: 动作如果指向 /ys,直接走命令分发,不再落到注册表里找不到;
  • 只写模块名(例如 /ys 商店)时默认执行该模块的主动作,不再打印帮助。




1.7.0 · 2026-11-18

变更:模块按「一个功能就是一个模块」重新拆分


上一版把商店、仓库、锻造、邮箱、拍卖、称号全塞在「经济」下面,实际用起来很别扭——
经济模块应该只管钱。这一版把它们全部拆成独立模块,领地管理也并回了领地:

  • 经济 只剩钱:/ys 经济 余额|转账|排行|签到|抽奖|礼包|任务|投票
  • 商店 独立:买、卖、回收站、商店管理
  • 仓库 独立:个人仓库(含末影箱、随身背包)
  • 锻造 独立:/ys 锻造 开锻造台
  • 邮箱 独立:/ys 邮箱
  • 拍卖 独立:拍卖行、求购、玩家交易
  • 称号 独立:我的称号、称号商店、称号管理
  • 领地管理并入领地:/ys 领地 管理 建|发布|下架|删除|转交|界面
  • 现在一共 22 个模块,/ys 帮助页直接从路由表生成,以后不会写错。

修复:用户验收报告里点名的 12 个问题

  1. 系统 · 权限:没装 LuckPerms 时不再含糊说「未开放」,而是明确提示「没有安装权限插件」,
    并给一条 /ys 系统 权限 安装,点了会自动下载 LuckPerms 到 plugins/ 目录,重启即生效。
  2. 服务器 · 端口转接:名字本来就是错的——它其实是个 HTTP 反向代理,改名为
    网页面板设置,说明文字也改成「反向代理」,不再让人以为是端口转发。
  3. 传送 · 设置家:以前只存坐标不存维度,在下界设的家回主世界会传送到同一个坐标。
    现在家会连维度一起存,设置成功时还会回报「已保存:主世界 123, 64, -45」。
  4. 团队:收敛成一条 /ys 团队 面板。创建、邀请、踢人、捐赠、升级、聊天、日志、转让队长、
    退出、解散全在界面里点,不用记子命令。
  5. 经济 · 商店:商品名后面直接带 - 价格;点进去不是立刻买,而是进批量购买页——
    1/8/16/32/64/128 一键数量,也能自定义(上限 2304),页面上显示单价、总价和余额。
  6. 经济 · 仓库:1 级就有 45 格,每升一级 +45 格,最高 20 级(900 格)。没解锁的格子点了会
    提示先升级,不会再出现「升到满级也只有几格」的问题。
  7. 经济 · 背包:和仓库重复的部分保留,但 /ys 仓库 背包 现在给的是一个随身背包物品,
    右键打开,换设备也在,不再只能靠命令打开。
  8. 经济 · 投票:以前直接发钱,等于白送 300 金币。现在必须真的有投票回调(Votifier/NAV)
    才会收到票据,/ys 经济 投票 只显示待领取数量,领取 才结算;管理员可以用 发放 手动补。
  9. 经济 · 拍卖:列表改成对话框(DUI),一页 36 件,显示价格和剩余时间;
    只有上架用箱子界面(因为必须把物品放进去),放好物品、设好价格再确认,关掉界面物品会还给你。
  10. 世界 · 面板:不再只有「传送世界」一件事,拆成四个入口——
    传送世界 / 管理世界 / 创建世界 / 删除世界,删除还要二次确认。
  11. 假人:以前生成的是盔甲架,跟真玩家完全不一样。现在 /ys 假人 创建 <名字> 会拉起一个
    MCC 客户端真的连进服务器,服务器看到的就是一个 player 类型的实体;没有客户端 jar 会明确提示。
    盔甲架版本改名为 /ys 假人 装饰,两者不再混为一谈。
  12. 怪物:以前只能改名字、血量、伤害,确实跟命名牌没区别。现在怪物定义全部写在
    plugins/YunShu/mobs.yml 里,可以配:生命、伤害、移速、跟随距离、护甲、击退抗性、
    幼体/发光/隐身/静音、六格装备、常驻药水效果、死亡掉落、Boss 血条、一次生成数量。
    指令只保留一条:/ys 怪物 生成 <名字> [数量],改 yml 保存立刻生效。

优化

  • 配置文件自动补齐:升级后旧 config.yml 里缺的新选项会自动合并进去,旧文件备份成 .bak。
  • 怪物定义、家、领地等数据结构升级时自动补列,不需要手动删库。
  • 帮助页、测试清单、菜单提示全部跟着新模块名重写。




1.6.0 · 2026-11-18

变更:全部命令统一成 /ys 模块 子命令


  • 顶层命令从 105 条收拢到 9 条,其余全部走统一入口:
    /ys <模块> <子命令> [参数],例如 /ys 领地 删除 我的地、/ys 经济 商店、/ys 传送 家。
  • 保留独立顶层命令的只有登录相关的 9 条:/l、/reg、/login、/register、/changepassword、/logout、/2fa、/bind、/ys——因为它们要在没登录时就能用,不能走 /ys。
  • 子命令全部中文。原来那些不好解释的短命令全部并进模块:
    • /landd <领地> → /ys 领地 删除 <领地>
    • /tpyes /tpno → /ys 传送 同意 / /ys 传送 拒绝
    • /unbanp → /ys 玩家 解封
    • /landp → /ys 领地管理
    • /pt /titleshop /titleadmin → /ys 经济 称号 / 称号商店 / 称号管理
    • /shopall /shopp /sellt /sellc /shopadmin → /ys 经济 商店 / 购买 / 出售 / 回收站 / 商店管理
    • /fb1 → /ys 反作弊,/webmp /webswitch → /ys 服务器 网页开关 / 端口转接
  • 一共 16 个模块、188 条路由:测试、主菜单、系统、服务器、反作弊、玩家、领地、领地管理、传送、团队、经济、玩法、世界、假人、怪物、公告、管理。
  • /ys 不带参数就列出全部模块;/ys 帮助 <模块> 看这个模块每一条的用法。
  • 模块名支持英文别名:/ys test、/ys land、/ys shop、/ys tp、/ys admin 都认。
  • Tab 补全能补到第三层(模块 → 子命令 → 参数),参数补全直接复用原来每条命令自己的补全。
  • 帮助页、菜单提示、所有「用法:」提示全部改成 /ys 写法,不会再教你敲已经不存在的命令。
  • 菜单里的按钮改成走内部命令路由,不再依赖顶层命令是否存在。

新增:手动验收测试流程 /ys 测试

  • /ys 测试 开始 开始一轮测试。插件会一条条告诉你该测什么:
    模块、要执行的命令、以及应该看到什么(例如「按面积排行,右键能传送」)。
  • 每测完一条输入 /ys 测试 继续 成功;有问题输入 /ys 测试 继续 失败 <理由>,
    理由会原样记下来。然后自动进下一条,一共 56 项,覆盖全部主要功能。
  • /ys 测试 状态 看进度和当前这一条;/ys 测试 结束 提前收尾。
  • 全部走完自动写 plugins/YunShu/test.txt:包含版本、服务端、测试人、起止时间、
    失败项清单(带理由),以及全部 56 项逐条的「通过 / 失败 / 未测」。
  • 这个文件直接发给开发者就能定位问题,不用一句句描述。

修复

  • 修掉菜单自检把「命令不在 plugin.yml 顶层」误报成死链的问题,现在按命令注册表核对,显示「菜单指向全部正常」。
  • 补齐 7 个权限节点:yunshu.test、yunshu.sessions、yunshu.ai、yunshu.ai.admin、yunshu.tpaall、yunshu.tpahereall、yunshu.db。




1.5.0 · 2026-11-16

新增:菜单全面改成「点开就有表单」


  • 管理员菜单里凡是需要填参数的功能,全部做成子菜单:反作弊、飞行、公告、黑名单、禁言与警告、权限、运维、商店管理、称号管理、自定义怪物、假人管理、多世界、领地管理,一共 13 个子菜单。
  • 子菜单里的操作用表单框:一屏把几个空都填好,底下就「确认」「取消」两个按钮,点确认才生效,点取消什么都不改。比如反作弊 → 设置等级 → 填 1/2/3 → 确认。
  • 玩家菜单里的「移动速度」拆成行走/飞行/恢复默认,「举报玩家」改成填「举报谁 + 原因」的表单,不再是一句提示。
  • 菜单文件带版本号:插件升级后会自动把旧菜单备份成 .bak 再换成新版,不会出现「按钮指向已经不存在的命令」。
  • /yunshu 自检 增加「菜单检查」:把所有菜单里每个按钮指向的命令和子菜单文件都核一遍,有死链直接列出来。

新增:商店补齐全部原版物品

  • 商店现在自动收录 1490 种可交易的原版物品:方块、矿物、武器、护甲、工具、食物、红石、药水、刷怪蛋、附魔书、杂货,全部按类别分好。
  • 价格是按类别和档次自动估算的(钻石 10、下界合金锭 60、鞘翅 500、龙蛋 2000……),管理员随时用 /shopadmin 修改 改。
  • 已存在的商品不会被覆盖,服务器升级后不会把改好的价格冲掉。
  • 配置 shop.full-catalog: true 可关掉自动收录。

新增:领地改成 2D

  • 领地只圈平面范围,竖直方向从世界最底到最顶全包。这样领地边界粒子、保护判定都只作用在平面上,不会出现「天上地下都算我地盘」的怪现象。
  • 选区、确认界面、领地信息、排行全部改成显示「面积(格)」,价格也按面积算。
  • 老存档自动升级:启动时把已有领地一次性拉伸到整根柱子,只做一次。

优化:锻造

  • 剑:每次锻造 50% 概率 锋利 +1(原来只有耐久和 10% 的附加附魔)。
  • 长矛可以锻造了:之前只认 TRIDENT,现在木/石/铜/铁/金/钻/下界合金长矛都能进锻造台,规则跟剑一致(耐久 +1、50% 锋利 +1、10% 附加附魔)。
  • 三叉戟的中文名从「矛」改成「三叉戟」,跟长矛区分开。

新增:假人(MCC)自己连回来

  • /mcc 添加 <名字> 把名字加进假人名单,这个号进服会自动注册、自动登录,不用在聊天框敲 /reg /l。
  • /mcc 启动 <名字> 插件自己把 MCC 拉起来连回本服(写配置、开进程、日志落在 plugins/YunShu/mcc/<名字>/mcc.log),不再让你去服务器终端敲命令。
  • /mcc 停止 / 列表 / 删除 管理这些假人;/mcc 面板也能点着用。
  • 已经注册过的账号不会被覆盖密码,避免把真人账号顶掉。

新增:内网端口转接

  • /webswitch 转发 <本地端口> <目标主机:端口> 起一个只监听 127.0.0.1 的 TCP 转发;/webswitch 转发列表 看当前转接;/webswitch 关闭转发 <端口> 关掉。
  • 转接记录写审计日志。

修复

  • 修掉 9 张数据表根本没建的问题:daily、votes、twofactor、binds、login_history、land_rents、auctions、orders、quest_progress。之前签到、投票、二次验证、名字绑定、登录记录、领地出租、拍卖、求购、任务这些功能一用就报「no such table」。
  • 修掉审计日志一直写不进去:写库用的列名和表结构对不上,导致网页端和控制台的审计日志永远是空的。现在正常记录。
  • 建表之后会主动核对一遍,缺表直接报错在启动日志里,不会再拖到用的时候才炸。
  • 菜单里两个死按钮修正:我的称号 指向不存在的 title 命令、参观领地 错误地执行了 land top。
  • 端口转接的连接生命周期错误修正(之前建连就被自己关掉,根本连不通)。

新增:账号安全

  • /bind <正版名> 名字绑定。绑定后别人用这个名字进服会被直接拦下(提示「该名字已被别的账号绑定」),/bind 查看 看自己绑了谁。
  • /2fa 开启 二次验证。标准 TOTP(30 秒一步,HMAC-SHA1),开启时给你一个 base32 密钥和 otpauth 链接,存进验证器后输入 /2fa 验证码 <6位> 才算真正生效;关闭也必须先过验证码。
  • 开启后登录变成两步:/l <密码> 通过后要求 /2fa 验证码 <6位>,5 分钟内不验证就退回未登录状态,不会放行。
  • 未登录状态下 /2fa 和 /bind 是允许使用的(其余命令照旧全部拦下)。
  • /sessions [玩家] 登录记录:最近 10 次登录时间 + IP,管理员可以查任意玩家。
  • 登录失败次数过多自动临时锁定(原有逻辑,本次接入登录记录一起审计)。

新增:团队等级表

  • /team 等级 一张完整表:1 到 10 级的人数上限、升级费用、金库上限,全部按配置实时算,改配置表就跟着变。

新增:领地出租

  • /land 出租 <领地> <每天价格> 主人挂牌;/land 租 <领地> <天数> 付租金租下,钱直接进主人口袋,租客自动获得成员权限;/land 退租 提前退。
  • 租约到期后每 5 分钟自动清理一次,权限同步收回。

优化

  • 模块数保持 50(以上功能都并进现有模块,不额外增加模块)。
  • 所有新表随插件启动自动建立,老存档直接升级,不用手动迁移。




1.4.0 · 2026-11-15

新增:玩家交易 /trade


  • /trade <玩家> 发起,对方 /trade 同意 <玩家> 接受,60 秒内有效。
  • 交易界面 54 格:左边 9 格是你的,右边 9 格是对方的,谁也不能动对方那一侧(点了会提示)。
  • 双方都点各自的「确认」才真正交换;任一方关掉界面或下线,交易立刻取消,物品原路退回,不会吞东西。
  • 交换完成后物品直接进背包,背包满的掉在脚下。

新增:每日任务 /quest

  • 三种任务类型:挖矿(挖到矿石计数)、击杀生物、钓鱼,按天重置。
  • 界面里显示进度、类型、奖励;做完变绿可点领取,领过变灰显示「明天再来」。
  • 任务内容在 config.yml 的 quests 里配,默认三条:挖 16 个矿 / 杀 10 只怪 / 钓 5 条鱼。
  • 进度存数据库(quest_progress 表),跨重启不丢,第二天自动从 0 开始。

优化

  • 模块数 48 → 50(新增 玩家交易、每日任务)。
  • 经济菜单再补两个入口:玩家交易、每日任务。




已知限制

  • 26.3 版本只编译不启动:dist/YunShu-26.3.jar 用 JDK 25 编译通过,但按你的要求从不在 26.3 上跑测试。
  • 需要真机验证的项:对话框视觉效果、输入框打字、BOSS 栏与边界粒子、头顶信息排版、网页面板样式——控制台只能验证逻辑与不报错。
  • MCC 假人需要你先放好客户端:把 MinecraftClient.jar 放到 plugins/YunShu/MCC/,之后 /mcc 启动 <名字> 由插件自己拉起,不用去终端敲命令。
后退
顶部 底部