Repository navigation
Releases
2.1.7 — 超多方块改用口木同款坐标表构造器 + 修复投影实体残留
概述
超多方块结构系统改用口木科技同款的「坐标表构造器」,并修复了长期存在、难以复现的投影实体残留问题。
兼容性:yml 配置、四台机器 ID、全部物品 ID、玩家存档格式一律不变,只替换 Java 层实现;content/super_multi_block_machines.yml 一行未动。本次也没有改动 3×3 普通多方块机器、脚本机器与「大型结构填充棒」的行为。
新增:口木同款结构构造器
SuperStructure:机器注册时把 yml 的「层 → 行 → 列字符矩阵 + mapping」一次性编译成StructureBlock(dx, dy, dz, material, sfId)坐标表,提供checkStructure(首错即返)、collectMissing(全量缺块、世界绝对坐标)、cells(Dir)、scanCells。此后结构判定、缺块收集、投影建档都只读这一张表,不再各自重复解析字符矩阵。- 四向旋转复用糖然原有的
Dir.rx/rz,与口木rot(x,z,dir)公式逐项核对完全一致。 - 比对规则保留糖然语义:粘液格按 id、原版按材质,水/岩浆含 waterlogged 判定 —— 没有照搬口木只比
getType().name()(那会让 yml 里的a6: water永远判缺失)。
新增:红色缺块提示
右键未成形的核心时,一次性标出全部缺失格:红色发光 ItemDisplay + 名称牌(原版方块走客户端翻译,中文客户端显示中文)+ 聊天栏世界绝对坐标。放对方块后对应提示自动消失,全部补齐会提示完成。
- 单台最多标 48 处:口木结构只有几十格,糖然最大的浑天仪有 535 个结构格,直接照搬会一次生成 1000+ 个 Display 实体。超限时按离核心距离取最近 48 处,聊天栏仍如实报总数与前 12 处坐标。
- 分层投影(
displayProjectiles/allowSwitchDisplayLayer等六个 yml flag)全部照旧生效,只统一了每格投影实体的生成方式;红色缺块提示是独立的一套实体,两者互不干扰。
修复:投影实体残留
排查出四条路径并全部加固:
- 主因:
createDisplay从未setPersistent(false)。Bukkit 的 Display 默认持久化为 true,会随区块写进世界存档;重启后内存里的CORE / MONITOR / projectiles三张表全空,旧投影无人认领也无人删。更隐蔽的是投影生成只在未成形时调用,结构一旦成形,连「按 PDC 收养」的路径都没有 —— 这解释了为什么残留难以复现:要重启后才显现,且与成形时机有关。现在统一关闭持久化。 - 历史残留:启动 20 tick 后清理上一版写进存档的持久化投影(只删「仍 persistent 且带本插件标记」的,本轮新建实体不会误删),启动日志会打印清理数量。
- 重复生成:
refreshCellSync原先在投影表为空时直接新建,插件 reload / 实例重建后会叠出第二套实体;现在先按 PDC 收养已有实体。 - 核心非破坏路径:爆炸 / 活塞 / 其它插件移除核心不走 Slimefun 的
BlockBreakHandler,实例与投影会一起泄漏;现在每 30 秒兜底检测(带双重判定,避免缓存未命中误重建)。 - 插件停用 / reload:
onDisable统一清掉全部投影与缺块提示实体、清空内存索引。
顺带修复
旧 isFormed / scanCells 固定 NORTH 朝向,与 SuperBlocks 的方向感知判定口径不一致;现在三处统一读取 TTHorizonDirection。斜向搭建的机器,以及「大型结构填充棒」在斜向核心上的补齐位置,都随之修正(填充棒代码本身零改动)。
验证
./gradlew clean build 通过。按旧坐标公式解析四台机器 yml 做了等价性核对:有效格 98 / 169 / 102 / 536(排除核心后 97 / 168 / 101 / 535),四向旋转后唯一数全部相等,证明旋转是双射、不会把两格折到同一格。
建议实测:①四个朝向各搭一台确认成形;②未成形右键核心看红标、放对方块自动消失;③浑天仪大量缺块时确认提示实体不超过 48 套且不卡顿;④水/岩浆格仍按 waterlogged 判定;⑤重启 / reload 后无残留投影;⑥爆炸拆核心后 30 秒内投影被收掉。
升级说明
无配置、无存档格式变更,直接替换 jar 并完整重启(新增了启动期历史投影清理,reload 不适用)。若从 2.1.6 之前升级,启动日志里的「启动清理历史投影实体 N 个」属预期行为。
2.1.6 — 断掉药水事件的旧文件回落 stat(P0-A + P0-B)
背景:实服 spark 报告里「被低估」的一条链
对 v2.1.5 实际服务器报告(h8WoC9Nxr4.sparkprofile,Leaf 1.21.11、2 人在线、61 分钟有效窗口)的复核显示:BY PLUGIN 里 TangranTech 自身 Java 帧仅 0.05%,watchdogTick 已完全从调用树消失(前两轮优化确认生效);但 HOT CALL PATHS 榜首的 WinNTFileSystem.getBooleanAttributes0(Windows 文件 stat,被归入 <jvm-internal>,不记在插件账上)有一条完整调用链来自糖然:
Player.turtleHelmetTick > LivingEntity.addEffect
> CraftEventFactory.callEntityPotionEffectChangeEvent
> YanhuoListener.onPotionEffect > selectedYanhuo
> AddonPaths.readJson > readJsonFile > File.exists
> WinNTFileSystem.getBooleanAttributes0
海龟头盔、潮涌核心、信标以及无限时长药水(水火异火被动自己就会挂)每刻都会刷新药水效果;Store.DOC_CACHE 挡住了 SQLite,却挡不住「库里没档 → 无条件回落查旧文件」的那次 stat,形成自激。当前没有卡顿,但这条链随在线人数 / 药水频率线性放大。
修复
P0-A · 药水事件先过滤、再读档(YanhuoSelectionScript.onPotionEffect)
把 getNewEffect() 与 INSTANT_HEALTH 判断提到 selectedYanhuo() 之前,不匹配直接 return。该监听器只对瞬间治疗有副作用,顺序前移行为等价;99.9% 的高频药水刷新不再触发读档。
P0-B · 旧 JSON 回落探测负缓存(AddonPaths.readJson,玩家数据唯一路由点)
新增 LEGACY_FILE_ABSENT:记住「库里没有、且磁盘上也没有同名旧 JSON」的 (ns, key),命中即跳过 readJsonFile → File.exists()。异火、储物空间、丹方权限、境界、任务等全部事件 / 周期路径一并受益,不必逐个模块改。
正确性约束(这次改动最容易踩坏的地方)
- 只在 SQLite 可用时启用:库不可用时整体降级为文件后端,一次
exists()都不能省,否则刚写下的文件会被「无文件」结论挡住。 - 30s TTL + 4096 容量上限:管理员手动补放旧档、外部工具写入后自动生效;过期条目不会随玩家上下线长期堆积。用
System.nanoTime()差值比较,溢出安全。 - 4 处显式失效:
writeJson(写库失败要落真实文件,不失效会导致「写后立即读 30 秒读不到」)、deleteDoc、/tr import前后(异步导入期间可能又产生新结论)、Store.shutdown(关库后降级文件后端)。 - 缓存键用
docParts产出的(ns, key),不用绝对路径:无路径形状歧义、零路径规范化开销;addons/**资源文件保持原路径不受影响。 Store.importLegacy走自己的文件读取,首次启动自动导入与单条惰性迁移语义完全未变。
自查过 6 条路径:库可用+磁盘有旧档(照常迁移入库)/库可用+磁盘无档(首次 stat 后缓存 30s)/库不可用(原行为)/save 失败落文件(撤缓存后立即可读)/删档/导入,均无回归。Store.available() 仅两个字段读,新增调用零成本。
验证方法
替换 jar 后完整重启,挂 30 分钟 /spark:
getBooleanAttributes0的糖然链应消失,YanhuoListener.onPotionEffect从调用树掉落;- 反向验证:给一个没选异火的新号手动放一份旧 JSON 到玩家数据目录,30 秒内应被读到并入库(确认 TTL 与惰性迁移没被负缓存堵死);
/tr import --apply后游戏内立即可见导入数据;- 厚土异火免疫瞬间治疗仍生效(P0-A 等价性)。
升级说明
- 无配置、无存档格式变更,
plugins/TangranTech/data/tangran.db结构不变;直接替换 jar 并完整重启即可。 - 本版不含 P1(异火事件统一走 watchdog 缓存、初章祭坛右键的 BlockStorage 扫描优化),按实测结果再定。
- 前提仍是本插件独占
tangran.db;若用外部工具直接改库,改动需重启后可见。
2.1.5 — watchdog 第二轮瘦身:每刻循环只让厚土玩家做实际工作
2.1.5 — watchdog 第二轮瘦身:每刻循环只让厚土玩家做实际工作
spark 复测确认第一轮优化生效:watchdogTick 从 16.4% 降到 1.03%,selectedYanhuo / readJson / SQLite 相关帧全部归零。剩余 1.03% 的解剖:
| 剩余热点 | 占比 | 性质 |
|---|---|---|
| Bukkit 遍历在线玩家的迭代器骨架 | ~0.8% | API 固有成本,动不了 |
每刻 ConcurrentHashMap.put |
0.21% | 全员每刻写血量基准 |
isPhaseTwoLocked(hasMetadata) |
0.13% | 全员每刻查挑战锁 |
后两项就是本版修掉的。
核心改动:结构铁律——每刻循环里只有厚土玩家才做实际工作
厚土护血逻辑只对选中厚土(EARTH)的玩家有意义,但旧结构让全部在线玩家每刻做 isDead + 2 次 CHM put + isPhaseTwoLocked。重排后:
- 非厚土玩家零成本:选中判定后立即
continue,只剩一条WD_LAST_HP.remove(顺带清掉基准,map 不再随在线人数积累)。hasMetadata从「全员每刻」降到「厚土玩家每刻」——在线玩家里厚土通常一个都没有,0.13% 归零。 - 伤害事件侧同样过滤:
onDamageMonitor用WD_LAST_HP.containsKey识别厚土玩家,非厚土受伤不再白做额度merge + put。 - 正确性保障:挑战期分支虽然不护不回滚,但继续维护血量基准——否则解锁后基准停在挑战前,玩家挑战中掉的血会被错误回滚(这个 bug 在重排自查时抓回,未进入任何发布版)。
语义等价性
- 厚土玩家:护血、回滚、消息节流行为不变;
- 非厚土玩家:本来就不享受任何看门狗保护,现在只是不再白付成本;
- 挑战联动:进入二阶段异火立即失效、结束下一刻恢复(基准连续,无回滚毛刺);
- 玩家清火/换火:事件式失效照常,1 tick 内生效。
预期收益
watchdogTick 及其调用树预期从 1.03% 进一步降到 0.5% 以下(剩余为 Bukkit 迭代器骨架)。sugarTick(0.18%)、ScriptMachineItem.tick(0.09%)等其余热点均在内存缓存路径上、低于 0.2%,属于改动风险大于收益的量级,本版不动。
升级说明
直接替换 jar,无配置改动、无数据迁移。
校验:TangranTech-2.1.5-standalone.jar,7,297,874 字节。
本版包含的完整优化链(v2.1.4 + v2.1.5)
watchdog 负结果哨兵缓存 → Store 文档读缓存(含负缓存与异常不缓存)→ SQLite 语句复用 → 事件式失效(30s TTL 兜底)→ 目录/路径缓存 → UUID 快判 → 非厚土零成本路径。整链把异火系统从「单人 8.2ms/刻、占主线程 16.4%、6 人掉 TPS」压到「约 0.5%,且与在线人数基本无关(只剩遍历骨架)」。
2.1.4 — watchdog 性能优化:每刻全量查库归零
2.1.4 — watchdog 性能优化:每刻全量查库归零
一句话:watchdog 对「没有选中异火」的玩家负结果缓存不住,导致每 tick 完整走一遍 SQLite + 两次 File.exists——单人实测 8.2ms/刻、占主线程 16.4%,且复杂度 O(在线人数):6 个这样的在线玩家 TPS 就会掉到 12。本版把这条路径整体归零。
问题本体
YanhuoSelectionScript.watchdogTick(每刻任务)的选中状态缓存在 ConcurrentHashMap 里,它不允许 null——旧代码用 remove() 表示「没有」,结果下一刻 sel == null 又成立,负结果永远缓存不住:
- 玩家有异火 → 缓存住 → 1 秒读 1 次 ✅
- 玩家没有异火(新人、或清过选择)→ 每刻重查 ❌
单次成本拆解:prepareStatement(每次都让 SQLite 重新校验 schema)1.45ms + 目录 ensure 的 File.exists 0.90ms + 文件回落探测 0.54ms + 查询执行 0.51ms……乘以 22 个活跃窗口 × 26,400 次调用,总计 216 秒。
修复(六项)
- 负结果缓存(收益 ~20×):新增哨兵
NONE_SELECTED,「没选」也写进缓存;EARTH_ID.equals(哨兵)恒为 false,非厚土玩家照旧跳过护血。 - 目录对象缓存:
YANHUO_DIR只在首次解析时建目录,之后不再每刻stat。 - Store 读缓存(全插件受益):
DOC_CACHE缓存库里的原始 JSON 文本(含「确认没有」的负缓存)——缓存字符串而非解析后的 Map,load()每次返回新副本,调用方就地修改不会污染缓存;save/delete 同步维护,shutdown 清空。 - 语句复用:
Sqlite.select按 SQL 文本复用PreparedStatement(全局锁内天然串行),prepareStatement从毫秒级降到微秒级;异常时踢出重建,close()全部清理。 - 事件驱动失效:选中状态只在
setSelected()(玩家自选 / 挑战清空)里变化,那里主动失效缓存;TTL 从 1s 放宽到 30s 只作兜底。 - 快判:
PlayerKeys的 UUID 判定加长度短路;AddonPaths.docParts的根路径normalize()也缓存了。
三个正确性保障(比提速更重要)
- 查询异常不缓存:回库探测区分「正常无行」与「查询异常」,后者不写负缓存——否则一次瞬时 SQLite 故障会把「有档」永久固化成「没档」。
- 二阶段挑战期短路:
isPhaseTwoLocked是纯内存查询,锁定期间直接按「未选中」处理、不读也不污染缓存,解锁后下一刻立即重读存档——30s TTL 不会拖慢「挑战结束异火恢复」。 - 惰性迁移不受影响:ABSENT 命中时仍会回落读旧 JSON 文件,「文件→库」迁移语义不变。
预期收益
| 阶段 | 每 tick(1 名未选异火玩家) | 相对现状 |
|---|---|---|
| 现状 | 8.2ms | — |
| 仅负结果缓存 | 0.41ms | ↓20× |
| + 目录缓存 + Store 读缓存 | ≈0.03ms | ↓270× |
| + 30s TTL | ≈0.001ms | 归零 |
watchdogTick 从占用主线程 16.4% 降到 <0.05%,MSPT 中位数不变,但腾出了全部玩家扩展空间——这是开服前必须修的一条。
升级说明
直接替换 jar,无配置改动、无数据迁移。前提是本插件独占 tangran.db(目前 /tr import 也走本类,没有外部工具直写库)——若你用外部工具直接改库,需要重启才能看到新值。
校验:TangranTech-2.1.4-standalone.jar,7,297,744 字节。
验证方法
用一个没选异火的新号进服(最坏情况),挂 20 分钟 /spark profiler start:期望 watchdogTick 从 SELF-TIME 榜消失或 <0.05%。反向验证:选一次异火应立即生效,清空后被动应立即消失,二阶段挑战期间免死失效、结束后下一刻恢复。
2.1.3 — 紧急修复:不再干扰逻辑工艺读取其他附属的配方
2.1.3 — 紧急修复:不再干扰逻辑工艺读取其他附属的配方
如果你装了 2.1.2 且服务器上还有别的 Slimefun 附属,请升级本版或回退到 2.1.1。 2.1.2 会让逻辑工艺(LogiTech)的「配方供应器」提前初始化,导致晚于糖然科技加载的附属机器配方整批静默缺失——逻辑快捷机器读不到、机器列表里看不到,而且重启也补不回来。
症状
- 逻辑工艺的机器列表 / 快捷合成台里,其他附属的机器与配方消失(Slimefun 原生与逻辑工艺自己的正常)
- 糖然科技的机器反而正常出现(因为它自己写进了表)
- 没有任何报错,只是静默少项
根因
逻辑工艺把全部采集工作放在 RecipeSupporter 的静态初始化里(RecipeSupporter.java:1889-1892),而 RecipeSupporter.init() 是个空方法(:43)——它唯一的作用就是「触发类初始化」。对方靠 Schedules.java:36-41 在第 1 tick 延迟调用 PostSetupTasks.schedulePostRegister()(:18-24 先置 startPostRegister = true,再调 init()),以此保证「等所有附属注册完毕之后才快照」。
2.1.2 在 onEnable 里调 Class.forName(RecipeSupporter)(默认 initialize = true),把这份快照提前到了第 0 tick:此时只有先于本插件 enable 的附属注册完毕,其余全部缺席;而第 1 tick 的 init() 因为类已初始化、hasInit 已置位,什么都不会做,所以永远补不回来。
修复
- 只在对方扫描结束后登记:新增
scheduleRegister(),第 2 tick 起轮询对方的PostSetupTasks.startPostRegister(只读这一个 public boolean,该类的静态初始化只有一个HashSet,不会连带触发RecipeSupporter),最多等 20 tick 后按时间兜底(应对字段名随版本变化)。 - 所有跨插件探测改
Class.forName(name, false, loader)(只加载、不初始化),resolve()首行加if (!postRegisterDone()) return false,彻底断掉提前初始化路径。 - 让对方的扫描自然收编糖然机器:
buildRecipes()前置ready(),于是第 1 tick 扫描时我们的机器会被正常读到,并进入对方第 1 tick 定稿的机器列表菜单(和其他附属同批处理)。 - 登记时对已存在条目只改耗电、不覆盖对方已转换好的配方;启动日志新增「其中 N 台由对方扫描自动收编」,可据此确认时序生效。
兼容性校验
已用 javap 对测试服实际运行的 LogiTech-Build 3 (git 51ee3a5).jar 逐一核对:PostSetupTasks.startPostRegister、RecipeSupporter 的三张配方表与 transferRSCRecipes、MGeneratorRecipe(int, ItemStack[], ItemStack[])、MachineRecipeUtils.stackFromMachine / tryGenerateMGFromMachine、StackMachine / StackMGenerator 的 BW_LIST / BW_LIST_ENERGYCOMSUME / BWSIZE / hasInit —— 全部存在、签名一致。
升级说明
直接替换 jar,无配置改动、无数据迁移(SQLite 与存档格式不变)。从 2.1.2 升级后需要完整重启(不是 reload),因为修复点就在启动时序上。
校验:TangranTech-2.1.3-standalone.jar,7,296,403 字节。
附:2.1.2 引入、本版保留的功能
造物匣进入堆叠机生成器表;配方机器保留概率产出与 noConsume 语义;耗电按 tickRate 均摊;只追加不重排(保护老存档 craftType)。多方块核心机器与脚本机器不参与堆叠。
已知限制:5 台「概率 / chooseOne」造物匣走配方机器通道后,因逻辑工艺 CraftUtils.matchMultiRecipe 在输入槽全空时返回 null,输入槽需放一个占位物才会运转。
2.1.2 — 逻辑工艺(LogiTech)堆叠机对接
2.1.2 — 逻辑工艺(LogiTech)堆叠机对接
让糖然科技的机器出现在「逻辑工艺」的堆叠机里。
此前糖然机器在堆叠机中完全不可见:TTRecipeMachine 把 registerDefaultRecipes() 覆写成空实现(配方自管),于是 AContainer.getMachineRecipes() 返回空表,LogiTech 扫描时 if (!recipes.isEmpty()) 直接跳过入库——两张表都不在。
新增
- 造物匣 → 生成器表:纯生成语义(无输入、产出全 100%、非 chooseOne)构造 LogiTech 的
MGeneratorRecipe(ticks = tickRate - 1),进STACKMGENERATOR_LIST。 - 配方机器 → 堆叠机器表:其余机器走 LogiTech 自己的 RSC 兼容通道(
transferRSCRecipes→tryGenerateMGFromMachine/stackFromMachine),概率产出与 noConsume 语义原样保留。新增TTCustomMachineRecipe作为载体(类名以CustomMachineRecipe结尾 +forDisplay/chances/noConsume/chooseOneIfHas四字段),对齐 LogiTech 的反射读取。 TTRecipeMachine.getMachineRecipes()覆写为返回转换后的配方(惰性缓存);运行期产能仍读自身recipes字段,不受影响。
不参与堆叠
- 多方块核心机器(
TTSuperMultiBlockMachine):产能取决于结构是否成形、核心朝向与SuperBlocks的成形缓存,而堆叠机只认「输入槽 + 配方 + 每 tick 耗电」。登记进去等于允许未成形核心凭空产出,且一份「已成形」状态被 N 份并行共用。新增supportsLogiTechStacking()开关,核心机器返回false,getMachineRecipes()直接给空表——这样连 LogiTech 自己的静态扫描也不会把它收编。 - 脚本机器(
ScriptMachineItem,命轨织机等):产能由 NativeScript 的 tick 钩子驱动,没有「输入槽 + 配方」这层语义,代码未改动;仅在登记循环加显式守卫,防将来被改成继承TTRecipeMachine后误入。
兼容与细节
- 只追加、不重排:绝不删除 LogiTech 表里的既有条目——删除会让后续条目下标前移,老存档里的
craftType会串机。 - 耗电按 tickRate 均摊:糖然机器「每次操作扣一次」对 LogiTech「每 tick × 份数」,写入
ceil(energy / minTicks),宁可略贵不可漏扣。 - 修复探测重入隐患:LogiTech 的静态初始化会回调
getMachineRecipes()重入本层探测,此时它的静态表还是null。新增resolving标记与ready():未就绪时返回空表且不写缓存,避免把「暂时不可用」固化成永久不可用。 plugin.yml的softdepend增加LogiTech;未安装时整层静默跳过,无硬依赖、无硬链接。
已知限制
- 5 台「概率 / chooseOne」造物匣走配方机器通道后,因 LogiTech
CraftUtils.matchMultiRecipe在输入槽全空时直接返回null,输入槽需放一个占位物才会运转。 - 模板机的工具耐久(damage)语义在对接到堆叠机时会失真。
- 本次发布未在装有 LogiTech 的环境做运行期实测(开发服未安装)。
升级说明
直接替换 jar 即可,无配置改动、无数据迁移。玩家数据(SQLite,plugins/TangranTech/data/tangran.db)与存档格式均不变。
校验:TangranTech-2.1.2-standalone.jar,7,294,479 字节。
TangranTech 2.1.1
TangranTech 2.1.1
修复与清理版。基于 2.1.0 的小版本迭代,包含一项界面修复与一次内容下架。
修复
- 造物匣破坏后不再错误掉落「绿色玻璃板」:根因是造物匣的状态槽配置(
status: 0)恰好是菜单 0 号槽的绿玻璃板装饰板,而实现把它误算进了破坏掉落列表,导致每次拆除必掉一块。修复后 0 号槽回归纯装饰板(带空点击处理器),不进任何掉落列表。
移除:糖然牌堆叠机(TR_TRPDDJ)
堆叠机自本版本起整体下架,相关内容全部移除:
- 8 个实现类(原 4251 行 RSC 脚本的原生化实现)与全部注册点
machines.yml配置条目- 浮生当铺「机器类」商品(当铺缓存版本升级,客户端会自动重建)
plugin.yml软依赖收敛为[LuckPerms]——其余 6 个附属软依赖仅服务于堆叠机的识别层
⚠️ 上线提示:旧存档中已放置的堆叠机会变为未知物品方块,请在更新前清理服务器上的堆叠机及其容器内物品;玩家背包/仓库中持有的堆叠机物品同理。
兼容性
| 项 | 要求 |
|---|---|
| 服务端 | Paper 1.21.x(api-version 1.21) |
| 前置 | Slimefun4 4.9.x(中文本地化 Beta 构建验证) |
| 可选 | LuckPerms(缺失时权限回落 Bukkit) |
| 构建 | JDK 21 |
安装
- 下载下方附件,放入服务器
plugins/目录,重启。 - 玩家数据位于
plugins/TangranTech/data/tangran.db(SQLite),备份请连同-wal/-shm一起拷贝。 - 从 RSC 迁移玩家数据:
/tr import预览 →/tr import --apply --overwrite落库(自动完成玩家名 → UUID 键映射)。
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一起拷
TangranTech 2.0.0
糖然科技 TangranTech 2.0.0
首个正式发布版。把原本依赖 RSC(RykenSlimefunCustomizer)运行时 + Graal.js 脚本的附属,完整重写为独立可运行的 Slimefun 附属插件 jar:32 个 JS 脚本全部原生化,运行期不再需要 RSC,也不加载任何 JS 引擎。
兼容性
| 项目 | 版本 |
|---|---|
| 服务端 | Paper 1.21.x(编译期对齐 1.21.11 API,api-version: 1.21) |
| 前置 | Slimefun4 4.9.x Beta(Slimefun4-*-Beta.jar,硬依赖) |
| 可选软依赖 | LiteXpansion / DynaTech / InfinityExpansion / LogiTech / NetworksExpansion / MagicExpansion(缺哪个都只是对应功能静默退化) |
| 构建 | JDK 21 + Gradle 8.11.1(./gradlew build,需 libs/Slimefun4-*-Beta.jar) |
内容规模
169 个粘液物品 · 7 台机器 · 5 台配方机器 · 1 座经典多方块 · 4 座超多方块 · 1 台发电机 · 130 个材料生成器 · 24 种自定义配方类型 · 10 台模板机器 · 74 个物品组 · 153 个菜单 · 136 个 Java 源文件
本版重点
超多方块系统
- 方向感知成形、逐格 dirty 检测与自愈、成形抽检距离门控(不再全服机器叠加开销)
- 投影:未成形时逐格显示目标结构,右键核心切换展示层数;放对即消失、放错红色发光、缺失白色发光;液体格用 ItemDisplay + 水桶材质渲染(BlockDisplay 画不出流体),检测到水源/流动水/含水方块即可成形
- 机器 tick 跑在 Slimefun 的异步线程 → 实体/玩家操作统一
runSync;右键过滤副手事件,切层不再一次跳两层 - 配方匹配语义 = 材质 + 粘液 id(PDC),弃用
SlimefunUtils.isItemSimilar(对本链路恒 false);生产与诊断共用唯一实现,杜绝双实现漂移
BOSS 挑战(道法 / BOSS战,四阶段全量移植)
- 挑战场改为常驻的独立虚空世界
tangran_space:21×21×12 躲避场 + 51×51×20 石英场,每场结束就地重置,不再「在玩家身边选址建场 → 打完拆场」 - 配套
BossArenaProtector(Dominion 式场地保护):非挑战者禁破坏/放置/桶操作,爆炸只摘方块列表、火蔓延与液体流入、活塞跨界、生物改方块一律拦 - 阶段一躲避场 → 阶段二糖然本体(100 血)+ zqx125 / Katarina / 双子三位护法 → 阶段三糖然下场决斗 → 阶段四跪像与天道证明
- 双子经营小游戏:天墟虚仆、天实账本、挖掘/伐木/种田、商店四分类、破法弓兑换;补上「周目」计数与账本增益回套
- 体验:挑战期间在聊天栏发送 「我不玩了」 可随时中断并送回原位(开局会提示)
- 修复:阶段三变身在原脚本口径下把血量写成 2000,超过原版
MAX_HEALTH上限 1024 直接抛异常、变身中断 → 现按上限截断并回读真实值做血条折算
糖然科技内容线
- 糖精获取改为「糖然的种植园」:4 行界面、6 列泥土、随机 15~30 秒长一根、点水桶加速、点甘蔗收获;只在打开界面时计时(关界面暂停,重开续算)
- 粗糖水改「材料都在水中才合成」:丢出后延时实扫落点、现算现扣,连续丢出不再因原版实体合并而永久卡死
- 浮生当铺:龙首/龙蛋定价覆盖,缓存版本化(旧缓存自动失效重建)
- 配方展示按 RSC 语义复原(单物品直显 / 多物品绿色玻璃板按钮 + 点击预览并以 LOW 优先级接管事件)
稳定性与安全(挑重点)
- 物品身份只认
sf_id(PDC),菜单按钮按「格子 + 点击来源」判身份 —— 铁砧改名无法伪造 - 末影人免疫投射物伤害时
EntityDamageByEntityEvent不会触发 → 伤害统一以玩家为伤害源结算 - 下线改状态必须写在
PlayerQuitEvent(早于最终存档);周期逻辑一律走 tick 通道,天然重启免疫 - 工具包发放按归属玩家定型;经济入口的名字兜底一律加阶段闸
安装
- 服务端装好 Slimefun4 4.9.x Beta(其余软依赖可选)
- 把
TangranTech-2.0.0-standalone.jar放进plugins/ - 首次启动会自动创建虚空世界
tangran_space(两座场地常驻其中) - 内容入口见粘液科技指南对应物品组
变更提示
- 移除道具「挑战区域清除器」
Tr_tzqyqcq及其整条清场链路(挑战场独立维度化后不再需要按标记反推清场);旧存档里该物品会显示为未知物品,建议清掉 - 三阶段决斗体实际血量上限 1024(原设计 2000 受原版属性上限约束)
已知事项
- 堆叠机为分批移植,附魔书规则 / 自动熔炉 / UU 物质制造 / geo & crafttype 类型尚未落地
- 单场挑战同时只服务一名挑战者(入口处拒绝第二名)
构建产物:TangranTech-2.0.0-standalone.jar(1,402,270 字节)
移植细节、适配清单与踩坑记录见仓库 README.md 与 转化报告.md。