Skip to content

TangranTech 2.0.0

Choose a tag to compare

@ykcgly ykcgly released this 26 Oct 13:16
· 31 commits to main since this release

糖然科技 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。