StargateNH

[!INFO] Git Commit: 5707753 | Updated: 2026-07-26

StargateNH 是 GTNH（GregTech: New Horizons）1.7.10 环境下的星门模组，用来搭建可互联的星际传送网络。玩家用 16 个方块在地面竖起一座 5×5 的拱门结构，放下最后一块的瞬间结构自动"成形"（全部方块变为隐形，由自定义模型渲染），再用拨号装置为它设定一个 7 位字母地址，即可与世界上任何其他已设定地址的星门互联——生物走进门内即被传送到目标星门。

本 mod 规模很小：1 个 @Mod 入口类、19 个方块、2 个 TileEntity、3 个工具类，外加 WAILA 与 ModularUI 集成。

[!NOTE] 本 mod 没有任何能量系统。 全部源码检索 energy / power / cost / EU 均无匹配，没有 Forge 能量接口、没有应力、没有电力网络。激活一座星门的成本只有 16 个方块 + 1 个地址 + 一次性的"被拨"资格。

核心特点

  • 全自动多方块成形 — 无需手动装配或结构模板，放下方块即检测。
  • 无损拆解 — 拆掉成形星门精确掉回原来那 16 个方块，metadata 全部保留，可立即重新成形。
  • 7 位地址系统 — 16 个符号（A/O/T/D/P/F/H/L/M/I/E/J/G/K/B/C）组成 7 位地址，地址空间约 2.68 亿，全服唯一。
  • 7 个雪佛龙逐位锁定 — 拱门上的 7 个雪佛龙数量与地址位数严格一致，拨号动画即逐位对准符号。
  • 6 种材质主题 — 5 种 legacy 主题带名字后缀与游戏内版本号背景故事，结构要求完全相同。

方块列表

本 mod 共注册 19 个方块：6 种材质组 × 3 个星门方块 + 1 个拨号装置。

  • 星门环方块 - 星门结构基础成员（BlockStargate metadata 0），一座门需 8 个
  • 星门雪佛龙方块 - 承担地址符号对准功能的成员方块（metadata 1），一座门需 7 个
  • 星门控制器方块 - 结构核心方块，朝向来源与拨号发起端，TileStargateController 宿主
  • 已成形星门方块 - 成形后替换全部 16 个位置的隐形方块，metadata 记录原始身份，承载碰撞传送与自定义渲染
  • 拨号装置 - 唯一交互方块（Dial Home Device），设定地址与发起拨号

多方块结构

  • 星门 - 玩家自建的 5×5 拱门，16 个方块（1 控制器 + 7 雪佛龙 + 8 环），全自动成形与无损解体，含 6 种材质组变体对比

游戏设定

  • 地址与星门注册表 - 7 位地址的 16 符号字母表、268,435,456 地址空间、唯一性规则、仅主世界的全局注册表与持久化机制
  • 拨号序列 - 拨出后的 4 状态动画机（IDLE/SPINNING/LOCKED/CONNECTED），雪佛龙角度计算与 15.75 秒最短锁定耗时

第三方模组集成

  • ModularUI（GTNH 自带）- 拨号装置的整个界面基于 ModularPanel / CycleButtonWidget / InteractionSyncHandler 构建
  • WAILA（可选）- 通过 IMC 注册 StargateDataProvider，在提示栏显示已成形星门及其地址（用原版 standardGalacticFontRenderer 渲染为银河文字）；ClientProxy 用 Loader.isModLoaded("Waila") 做软依赖检测
  • NEI（可选）- 注册时即用 API.hideItem() 把 formedGateBlock 从物品列表隐藏
  • gtnhlib - 使用其 BlockPos 作为注册表的坐标键类型

未涵盖的维度

本 mod 不注册任何 Item（独立物品）、Entity、Dimension、Biome、Structure（世界生成）、Achievement、Enchantment、KeyBinding、PotionEffect、ItemEffect，也没有注册任何指令（serverStarting 为空实现）。所有 ItemBlock 都只是方块的物品形态，已在方块条目中说明。