Skip to content

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

Latest

Choose a tag to compare

@ykcgly ykcgly released this 15 Nov 18:09
· 1 commit to main since this release

概述

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

兼容性: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 个」属预期行为。