Skip to content

Releases

2.1.7 — 超多方块改用口木同款坐标表构造器 + 修复投影实体残留

Choose a tag to compare

@ykcgly ykcgly released this 15 Nov 18:09

概述

超多方块结构系统改用口木科技同款的「坐标表构造器」,并修复了长期存在、难以复现的投影实体残留问题。

兼容性: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)全部照旧生效,只统一了每格投影实体的生成方式;红色缺块提示是独立的一套实体,两者互不干扰。

修复:投影实体残留

排查出四条路径并全部加固:

  1. 主因:createDisplay 从未 setPersistent(false)。Bukkit 的 Display 默认持久化为 true,会随区块写进世界存档;重启后内存里的 CORE / MONITOR / projectiles 三张表全空,旧投影无人认领也无人删。更隐蔽的是投影生成只在未成形时调用,结构一旦成形,连「按 PDC 收养」的路径都没有 —— 这解释了为什么残留难以复现:要重启后才显现,且与成形时机有关。现在统一关闭持久化。
  2. 历史残留:启动 20 tick 后清理上一版写进存档的持久化投影(只删「仍 persistent 且带本插件标记」的,本轮新建实体不会误删),启动日志会打印清理数量。
  3. 重复生成:refreshCellSync 原先在投影表为空时直接新建,插件 reload / 实例重建后会叠出第二套实体;现在先按 PDC 收养已有实体。
  4. 核心非破坏路径:爆炸 / 活塞 / 其它插件移除核心不走 Slimefun 的 BlockBreakHandler,实例与投影会一起泄漏;现在每 30 秒兜底检测(带双重判定,避免缓存未命中误重建)。
  5. 插件停用 / 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)

Choose a tag to compare

@ykcgly ykcgly released this 10 Nov 15:29

背景:实服 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:

  1. getBooleanAttributes0 的糖然链应消失,YanhuoListener.onPotionEffect 从调用树掉落;
  2. 反向验证:给一个没选异火的新号手动放一份旧 JSON 到玩家数据目录,30 秒内应被读到并入库(确认 TTL 与惰性迁移没被负缓存堵死);
  3. /tr import --apply 后游戏内立即可见导入数据;
  4. 厚土异火免疫瞬间治疗仍生效(P0-A 等价性)。

升级说明

  • 无配置、无存档格式变更,plugins/TangranTech/data/tangran.db 结构不变;直接替换 jar 并完整重启即可。
  • 本版不含 P1(异火事件统一走 watchdog 缓存、初章祭坛右键的 BlockStorage 扫描优化),按实测结果再定。
  • 前提仍是本插件独占 tangran.db;若用外部工具直接改库,改动需重启后可见。

2.1.5 — watchdog 第二轮瘦身:每刻循环只让厚土玩家做实际工作

Choose a tag to compare

@ykcgly ykcgly released this 31 Oct 03:35

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。重排后:

  1. 非厚土玩家零成本:选中判定后立即 continue,只剩一条 WD_LAST_HP.remove(顺带清掉基准,map 不再随在线人数积累)。hasMetadata 从「全员每刻」降到「厚土玩家每刻」——在线玩家里厚土通常一个都没有,0.13% 归零。
  2. 伤害事件侧同样过滤:onDamageMonitor 用 WD_LAST_HP.containsKey 识别厚土玩家,非厚土受伤不再白做额度 merge + put。
  3. 正确性保障:挑战期分支虽然不护不回滚,但继续维护血量基准——否则解锁后基准停在挑战前,玩家挑战中掉的血会被错误回滚(这个 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 性能优化:每刻全量查库归零

Choose a tag to compare

@ykcgly ykcgly released this 31 Oct 02:27

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 秒。

修复(六项)

  1. 负结果缓存(收益 ~20×):新增哨兵 NONE_SELECTED,「没选」也写进缓存;EARTH_ID.equals(哨兵) 恒为 false,非厚土玩家照旧跳过护血。
  2. 目录对象缓存:YANHUO_DIR 只在首次解析时建目录,之后不再每刻 stat。
  3. Store 读缓存(全插件受益):DOC_CACHE 缓存库里的原始 JSON 文本(含「确认没有」的负缓存)——缓存字符串而非解析后的 Map,load() 每次返回新副本,调用方就地修改不会污染缓存;save/delete 同步维护,shutdown 清空。
  4. 语句复用:Sqlite.select 按 SQL 文本复用 PreparedStatement(全局锁内天然串行),prepareStatement 从毫秒级降到微秒级;异常时踢出重建,close() 全部清理。
  5. 事件驱动失效:选中状态只在 setSelected()(玩家自选 / 挑战清空)里变化,那里主动失效缓存;TTL 从 1s 放宽到 30s 只作兜底。
  6. 快判: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 — 紧急修复:不再干扰逻辑工艺读取其他附属的配方

Choose a tag to compare

@ykcgly ykcgly released this 30 Oct 13:47

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 已置位,什么都不会做,所以永远补不回来。

修复

  1. 只在对方扫描结束后登记:新增 scheduleRegister(),第 2 tick 起轮询对方的 PostSetupTasks.startPostRegister(只读这一个 public boolean,该类的静态初始化只有一个 HashSet,不会连带触发 RecipeSupporter),最多等 20 tick 后按时间兜底(应对字段名随版本变化)。
  2. 所有跨插件探测改 Class.forName(name, false, loader)(只加载、不初始化),resolve() 首行加 if (!postRegisterDone()) return false,彻底断掉提前初始化路径。
  3. 让对方的扫描自然收编糖然机器:buildRecipes() 前置 ready(),于是第 1 tick 扫描时我们的机器会被正常读到,并进入对方第 1 tick 定稿的机器列表菜单(和其他附属同批处理)。
  4. 登记时对已存在条目只改耗电、不覆盖对方已转换好的配方;启动日志新增「其中 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)堆叠机对接

Choose a tag to compare

@ykcgly ykcgly released this 29 Oct 17:53

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

Choose a tag to compare

@ykcgly ykcgly released this 29 Oct 15:05

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

安装

  1. 下载下方附件,放入服务器 plugins/ 目录,重启。
  2. 玩家数据位于 plugins/TangranTech/data/tangran.db(SQLite),备份请连同 -wal / -shm 一起拷贝。
  3. 从 RSC 迁移玩家数据:/tr import 预览 → /tr import --apply --overwrite 落库(自动完成玩家名 → UUID 键映射)。

TangranTech 2.1.0

Choose a tag to compare

@ykcgly ykcgly released this 27 Oct 13:41

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

Choose a tag to compare

@ykcgly ykcgly released this 26 Oct 13:16

糖然科技 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 通道,天然重启免疫
  • 工具包发放按归属玩家定型;经济入口的名字兜底一律加阶段闸

安装

  1. 服务端装好 Slimefun4 4.9.x Beta(其余软依赖可选)
  2. 把 TangranTech-2.0.0-standalone.jar 放进 plugins/
  3. 首次启动会自动创建虚空世界 tangran_space(两座场地常驻其中)
  4. 内容入口见粘液科技指南对应物品组

变更提示

  • 移除道具「挑战区域清除器」Tr_tzqyqcq 及其整条清场链路(挑战场独立维度化后不再需要按标记反推清场);旧存档里该物品会显示为未知物品,建议清掉
  • 三阶段决斗体实际血量上限 1024(原设计 2000 受原版属性上限约束)

已知事项

  • 堆叠机为分批移植,附魔书规则 / 自动熔炉 / UU 物质制造 / geo & crafttype 类型尚未落地
  • 单场挑战同时只服务一名挑战者(入口处拒绝第二名)

构建产物:TangranTech-2.0.0-standalone.jar(1,402,270 字节)
移植细节、适配清单与踩坑记录见仓库 README.md 与 转化报告.md。