Repository navigation
概述
超多方块结构系统改用口木科技同款的「坐标表构造器」,并修复了长期存在、难以复现的投影实体残留问题。
兼容性: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 个」属预期行为。