ForgeRelocation

[!INFO] Git Commit: 21da7aa | Updated: 2026-08-04

ForgeRelocation（modid ForgeRelocation）不是一个内容 mod，而是一个 API + 引擎：让任意 mod 能在世界里把一整块方块结构（包括方块实体）平滑地推移一格，并负责客户端动画与状态同步。

同一个 jar 里还塞了第二个 mod MCFrames（modid MCFrames），它是 ForgeRelocation 引擎的一个完整参考实现——提供玩家可用的框架方块与红石马达。

mcmod.info 里唯一的描述是仓库 README 的第一句：“An API for handling the movement of blocks.”

⚠️ 这个 mod 不是什么

任务简报把它描述为"改写 Minecraft 物品/metadata 模型的 mod"。这是错的，源码核实结论：

• 没有物品 / metadata 重写、没有注册表重映射、没有 ore dict 映射（addMapping 零命中）
• 这里的 “relocation” 指的是在世界内搬迁方块（move blocks from one place to another），不是"重定位物品 ID"
• 唯一的 metadata 相关代码是方块搬运器查表时读的 w.getBlockMetadata(x, y, z)——用来决定某个方块的哪个 meta 变体绑哪个搬运器，本身不改写任何东西
• 本 mod 唯一的方块改写手段是 ASM 核心 mod，且只改写两个原版客户端渲染类（RenderBlocks.renderBlockByRenderType、TileEntityRendererDispatcher.renderTileEntity），与注册表无关

基本信息

语言构成

13 个 Java 文件全部是接口 / 抽象类 / 简单 POJO（含 2 个 package-info.java），没有一行是 net.minecraft 的类。全部 @Mod 入口、ASM 转换器、运动引擎、渲染代码都是 Scala。两个 @Mod 注解里都写了 modLanguage = "scala"。

一个 jar、两个 mod

两者都硬依赖 MrTJPCore，但都不声明彼此为 FML 依赖——MCFrames 隐式依赖 ForgeRelocation。

⚠️ 由此产生一个工程问题：FML 排序 mod 容器时会算进 @API，而同一 jar 里的两个 API 互相"嵌入对方"，形成循环加载顺序。源码的处理方式是把 mrtjp/mcframes/api/package-info.java 的 @API 注解整段注释掉并在文件里留了一张 ASCII 依赖图说明。副作用：MCFramesAPI 不受 API 版本隔离保护。

全部 11 个条目

方块（3 个）

全 jar 只有 1 条配方（GameRegistry.addRecipe 全仓库仅 1 处）：logWood + Items.stick 环形产出 8 个框架方块。马达与占位方块都没有配方。

机制与设定（8 个）

核心机制速览

一次移动的完整链路

[马达方块] 红石信号 → TileMotor.update()
  ↓  MCFramesAPI.getStickResolver.getStructure(...)   ← 解析整条框架结构（排除马达自身）
  ↓  Relocator.push / setWorld / setDirection / setSpeed(1/16) / addBlocks / execute / pop
[ForgeRelocation] MovementManager2.tryStartMove()
  ↓  检查 blocks.size <= moveLimit(2048)
  ↓  MathLib.normal/basis 分桶 → splitLine → rhrAxis  ← 切成平行的 BlockRow
  ↓  MovingTileRegistry.canRunOverBlock 逐行检查行首     ← 不通则整次失败
  ↓  放置 TileMovingRow 占位方块 + BlockStruct + sendStruct()
[每 tick]  push() 推进 progress → 客户端插值渲染 + TileMovingRow 推实体
[完成]      doMove → postMove → endMove → rescheduleTicks → 邻居更新 → rerender

三个内置搬运器

搬运器查找优先级

blockMetaMap[(b, meta)] → blockMetaMap[(b, -1)] → modMap[modid] → defaultMover

叠加优先级：配置文件 > preferredMover（软）> mandatoryMover（硬，覆盖一切）。

本 mod 没有的东西（grep 证据）

以下断言均已在 /Users/evlos/a/mirror/ForgeRelocation/ 的 src/ 全量检索核实：

因此只建了 block/ 与 setting/ 两个目录；item、entity、multiblock、enchantment、dimension、keybinding、potioneffect、biome、structure、achievement、item-effect 共 11 个维度无内容，未建目录、未在正文里留占位。

源码中的若干不一致（均为原文，未修正）