Skip to content

TangranTech 2.1.0

Choose a tag to compare

@ykcgly ykcgly released this 27 Oct 13:41
· 27 commits to main since this release

TangranTech 2.1.0 —— 存储与身份体系重构版

自 v2.0.0 以来的大版本更新。玩家数据全面迁入 SQLite,数据键改用 UUID,新增从 RSC 一键导入。

兼容性

项 要求
服务端 Paper 1.21.x(api-version 1.21)
前置 Slimefun4 4.9.x Beta(f172239 构建验证)
软依赖(可选) LiteXpansion / DynaTech / InfinityExpansion / LogiTech / NetworksExpansion / MagicExpansion / LuckPerms
构建 JDK 21

存储:SQLite + 定时落库

  • 玩家数据全部迁入 plugins/TangranTech/data/tangran.db(表 player_doc,WAL 模式);驱动与常用平台原生库已内置于 jar
  • 写后缓存 + 每 5 分钟统一落库,每次落库后台打印 [存储] 定时保存完成:写入 N 份文档;正常停服先落库再关(⚠️ 进程被强杀最多丢最近 5 分钟进度)
  • 旧 addon_configs/糖然科技/** JSON 档首次启动自动导入(不覆盖已有);SQLite 不可用时自动降级回文件后端

身份:玩家数据键改用 UUID

  • 所有玩家档(储物空间/境界/任务/丹方/异火/天道货币/BOSS战/双子账本/终刻合成台/糖b工具…)的键从「玩家名」换成「UUID」,改名不再丢档
  • 离线服本地确定性派生 UUID;在线服主线程只走缓存、不阻塞
  • 启动时自动把旧「名字键」文档迁移到 UUID 键;玩家进服自动记名字索引

权限:hook LuckPerms

  • 节点:tangrantech.admin / .admin.compiler / .admin.arena / .command.import(管理侧);tangrantech.storage.unlocked、tangrantech.yanhuo.<id>、tangrantech.danfang.<id>(玩法资格,获得时自动发放)
  • 口径:管理侧只认节点或 OP;玩法资格存档为主、权限为辅;未装 LuckPerms 自动回落 Bukkit

储物空间

  • 桶模型:带 NBT 的物品(附魔/改名/容器内容/PDC)独立成桶完整保存,取出原样;旧扁平档 {id:数量} 兼容读取
  • 删除「不要存入带 NBT 物品」的过时提示

/tr import —— 从 RSC 一键导入

/tr import                     预览(不写库)
/tr import --apply --overwrite 真正写入并覆盖库内同名档
/tr import --source <目录>     指定源目录(默认自动按序探测)
/tr import --only 境界,储物空间 只导指定命名空间
  • 默认源按序探测:plugins/RykenSlimefunCustomizer/addon_configs/糖然科技 → RykenSlimeCustomizer(旧拼写兜底)→ plugins/TangranTech/addon_configs/糖然科技 → plugins/糖然科技
  • RSC 的「玩家名」键自动升级为「UUID」键(含 <名>_编译器.json 特例);报告显示 原名 → uuid 映射
  • 全部跳过且无新建时提示加 --overwrite;--only 点名但源目录无文件的命名空间会明确列出

灵圃

  • 修复:农事事件(浇水/翻耕/施肥)此前因代码顺序 bug 完全无法触发——原版物品(水桶/锄头/骨粉)被 slimefun id 判空挡住;现已按「灵植事件介绍」逐条复现
  • 打开界面期间倒计时/事件进度每秒实时刷新
  • 取下改为空手右键直接取下(返还干净物品、不带灵植数据,进度丢弃);收获为空手左键
  • 修复点击保存导致倒计时回拨的问题

其它(自 v2.0.0 累积)

  • 多方块投影:放对消失并摘队伍 / 放错红色发光 / 液体格水桶渲染;方向感知成形 + dirty 自愈
  • 三阶段 BOSS 变身血量超原版上限(1024)导致整段中断的修复;BOSS 挑战场常驻独立世界 tangran_space + Dominion 式场地保护
  • 糖然的种植园、粗糖水「材料都在水中才合成」重写、浮生当铺定价覆盖
  • 移除挑战区域清除器(独立维度化后无用)

升级提示

  • 从 RSC 迁移:装好本插件后执行 /tr import --apply --overwrite(先 /tr import 预览确认)
  • 旧 v2.0.0 及更早的玩家档会在启动时自动迁移,无需手动操作
  • 备份 tangran.db 时请连同 -wal / -shm 一起拷