Repository navigation
TangranTech 2.1.0
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一起拷