维度科技

Dimension Tech

Dimension Tech 是一个科技模组。它的自动化循环建立在已生成结构（structure）的价值之上：将结构解析为标记（marker），然后让神话矿机（Mythic Miner）根据该结构的战利品预期产出资源。

许可证：GPL-3.0

玩家指南

核心循环

1. 站在结构内部，手持结构标记（Structure Marker）右键：屏幕会列出你所处位置命中的所有结构，选择一个后会把它的维度、坐标和边界写入标记，并计算战利品预期。对于散落的容器，改用箱子标记（Chest Marker）：按 V 键解析并标记准星所指的容器。
2. 放置所需等级的神话矿机，右键打开其控制界面。
3. 手持扳手右键矿机可切换其多方块投影；Shift+右键可从你的背包中一次性建造该多方块结构。然后搭建显示出的结构。
4. 将已写入数据的结构标记放入矿机，然后提供 FE 能量和所需流体。
5. 配置红石、物品输出面、流体面和自动抽取流体。矿机会处理标记并输送生成的战利品。除了结构战利品之外，每个循环还会产出矿机自身等级的维度碎片（dimension fragments）和挖矿代币（mining tokens）（各 min(10, parallel) 个）。
6. 当你拥有 2 级碎片和代币后，合成数据集成器（Data Integrator）；5 级碎片和代币则让你获得结构解析器（Structure Interpreter）（还需要一个数据集成器、一个下界之星和下界合金）。只有把两者都装入结构数据操作器（Structure Data Operator），才能解锁结构目录和批量写入——这也是为什么该机器位于矿机之后，而不是循环的起点。

结构解析会读取结构的战利品表并计算预期物品数量和结构价值。解析可以异步完成；在结果就绪之前，标记不会进入处理作业。

矿机输出使用基于已解析物品预期的保期望奖励生成。它保留长期期望值，但不会重放原版 LootTable 的联合分布、池选择、函数链或随机序列。

神话矿机

神话矿机提供 1 级到 6 级。每一级在标记槽数量、基础并行度、幸运、效率和能量规格上均不同（1 级只有一个标记槽，6 级有九个），每个槽独立推进。服务器的通用配置控制实际数值。

基础多方块需要：

• 40 个神话矿机外壳
• 12 个神话矿机玻璃
• 2 个神话矿机结构方块
• 12 个升级槽（每个可放置一个升级方块或一个结构方块）

整台机器悬挂在矿机本体下方（矿机本体占据最顶层）：请先在其下方清出 5x5x5 的空间。投影会标出每一个位置。玻璃替代了旧布局所需的聚焦方块，贯穿腰部，使外壳侧面保持透明。

默认情况下每一级都需要流体输入（判定点为 BaseMinerBlockEntity#requiresFluidInput，默认为 tier >= 1；KubeJS 可通过 requiresFluid(false) 关闭）。所需流体为：

等级	所需流体
1	水
2	神话精华
3	涌动神话精华
4	递归精华
5	涌动递归精华
6	分形精华

流体在每次处理循环开始时充能；能量每个自然游戏刻充能一次。每次处理循环至少持续 400 个自然刻。当外部系统加速方块实体刻时，这能保持可预测的资源核算。

除了结构战利品之外，每次处理循环还会额外产出三样东西：min(10, parallel) 个维度碎片和相同数量的挖矿代币，均为矿机自身等级；此外还有维度解构核心（dimension deconstruction cores），按 min(1, 5% x tier) 的概率掷 parallel 次，每循环上限为 10 个（预期物品开关可将其关闭）。碎片和代币是数据集成器和结构解析器的原料，因此这两个部件只能在矿机之后获得。

结构反应堆

结构反应堆（Structure Reactor） 是单方块机器，也是结构相关合成（例如生产维度碎片和其他维度产物）的主线。它有两个 16,000 mB 的精华罐、一个碎片槽和一个即时操作槽，通过有限状态循环推进配方。启动和提交一个循环会校验输入流体、碎片、配方匹配和输出容量，并可发出红石模拟信号。

默认配方将精华链逐级提升：水 → 神话精华 → 涌动神话精华 → 递归精华 → 涌动递归精华 → 分形精华，每一步消耗对应等级的维度碎片。KubeJS 可以覆盖这些配方；具体数值和遥测请参见游戏内 GUI、JEI 和 KubeJS 文档。

结构数据操作器与标记

该机器需要两个前置部件，且两者的配方都消耗矿机产出：数据集成器需要 2 级维度碎片和挖矿代币（外加石英、紫水晶碎片、一个外壳和红石），而结构解析器需要 5 级碎片和代币外加一个下界之星和下界合金，并且自身配方中还需要一个数据集成器。这就是操作器位于矿机之后的原因。

操作器无法自行浏览结构：目录需要先在集成器槽中放入数据集成器，然后在解析器槽中放入结构解析器——只有在集成器就位时，该槽才接受解析器，而当解析器在位时集成器无法被取出。两者都安装后目录才会出现，你就可以浏览和解析结构，并将条目写入目标槽中的结构标记。

• 复制不需要前置部件：将已携带数据的标记放入目标槽，将待填充的标记放入写入槽，操作器就会把目标的数据复制到所有这些标记中。
• 结构标记存储其目标维度、坐标或目录结构、边界、价值和预期物品数量。

箱子标记处理散落的容器：手持它并按下解析键（默认 V），即可对准星所指的容器进行预期解析——如果该容器引用了战利品表，该表就会成为来源，容器也会被标记。该操作绑定按键而非右键，因为右键箱子会先打开它；右键箱子标记只会打开所标记内容的解析界面（箱子价值和计算方法）。

箱子标记和结构标记共享同一套标记 NBT（StructureMarkerData；箱子会额外嵌套一个 ChestData 标签，保存战利品表和种子）。下游只读取 NBT 结构，从不读取物品类型，因此操作器的复制模式和矿机的生产链对两者均适用。唯一的区别在于解析档案：箱子不注册结构，因此其档案仅使用记录的战利品表，绝不会触及结构模板或关卡加载。

服务器配置或 KubeJS 可以更改结构、维度和物品的价值规则。规则变更会使相关解析缓存失效，并在下次使用时触发重新计算。

配置与兼容性

Forge 通用配置包含全部六个矿机等级的基础数值，以及结构价值、稀有度倍率、维度价值、物品规则和解析策略。Forge 会在实例的 config 目录中创建配置文件。

以下集成是可选的：

• KubeJS：服务端矿机覆盖、反应堆配方、结构价值规则和工作事件。
• Jade：矿机状态显示。
• 应用能源 2（Applied Energistics 2）：ME 网络相关的输出和流体交互。
• JEI：反应堆、矿机和解构核心的配方。

完整的 KubeJS API、事件和校验规则请参见 docs/kubejs.md。processingTime 必须至少为 400；更小的值会被明确拒绝。