自定义传送门狐狸化

自定义传送门狐狸化

用任意方块建造传送门。创建两个相匹配的框架,用彩色催化剂点亮它们,并在相连的传送门之间穿梭。

游戏机制

Custom Portals Foxified

横幅,浮空岛上的闪长岩传送门

Custom Portals 让你可以用任意方块搭建传送门。相匹配的框架会相互连接,实现便捷的远距离旅行。你可以在整个世界和各个维度中创建传送门网络。

本模组是 Custom Portals(Fabric 版)的 NeoForge 重实现。

传送门

用任意固体方块搭建一个大致呈矩形的框架,然后用传送门催化剂右键点击框架内部。用完全相同的方块搭建第二个框架,用匹配颜色的催化剂将其点亮,它们便会立即连接。

  • 任意方块都可作为框架;石头、树叶、钻石块,随你所愿
  • 垂直或水平传送门均可,你可以在墙壁、地板、天花板上搭建框架,甚至悬空搭建
  • 16 种催化剂颜色,用于组织你的传送门网络
  • 传送门通过匹配颜色 + 框架材质进行连接
  • 支持同维度与跨维度旅行(需使用门径符文)
  • 彩色粒子和传送门效果,与原版传送门一致
  • 咩~~~ 🐑

催化剂

有序合成配方:4 个末影珍珠 + 4 个末影之眼 + 1 个染料 -> 2 个传送门催化剂

催化剂配方

催化剂也可以重新染色:任意催化剂 + 一个染料 -> 1 个新颜色的催化剂(无序合成)。

符文

将符文方块放置在传送门的框架上以增强它。符文必须安装在直接与传送门方块相邻的方块上。

符文 效果 关键材料
急速 瞬间传送(1 tick) 羽毛、兔子脚、紫水晶碎片
门径 启用跨维度连接 垂泪藤、缠怨藤、紫水晶碎片
增强 将连接范围提升至 1,000 格 青金石、紫水晶碎片
强力增强 将连接范围提升至 10,000 格 海晶石、增强符文
无限 无限连接范围 爆裂紫颂果、下界合金锭、强力增强符文

在没有符文的情况下,传送门在同维度内 100 格范围内连接。连接对中任意一端的急速符文都会为双方提供瞬间传送。

配方图片

急速符文 门径符文 增强符文 强力增强符文 无限符文

连接

传送门会自动连接到最近的兼容未连接传送门(相同催化剂颜色 + 相同框架方块)。如果某个传送门被破坏或禁用,其配对传送门将变为未连接状态,并会搜索新的有效匹配 🥀

该系统有意保持简单且确定。在多人游戏或密集的同色网络中,重新连接可能会选择与你预期不同的框架。这是设计使然:放置/距离和布局都很重要,并且它能实现更具创意的传送门拓扑结构。

红石

红石行为默认启用:红石信号会关闭传送门。在通电状态下,传送门会断开连接;当移除供电时,它会按照上述常规连接规则自动重新连接。

由于这是逐传送门生效的,你可以禁用一对传送门中的一端,并让被释放的传送门寻找另一个兼容的配对(如果存在)。这支持 ABC 传送门切换、红石控制的旅行网络以及多人游戏路由设置等玩法。

如果你愿意,可以在配置中完全禁用红石交互。

数据包

你可以使用数据包定义全新的自定义传送门。借助数据包,你可以:

  • 为传送门选择框架方块(单个方块或方块标签)和催化剂物品
  • 设置传送门的颜色(任意 16 种染料颜色)
  • 选择催化剂的使用方式(消耗、损坏或不受影响)以及数量
  • 使用连接对连接方式(类似内置传送门),或使用缩放维度对应连接方式,在目标维度中自动生成另一侧(类似原版下界传送门,可配置坐标缩放比例)
  • 通过框架允许列表/阻止列表标签,或为自定义传送门独占某个框架方块,来限制内置的 16 种彩色传送门

完整的数据包参考和即用型示例数据包请参见 examples/。

配置

所有设置均在 custom_portals_foxified-common.toml 中:

设置 默认值 描述
maxPortalSize 64 框架可包围的最大传送门方块数
minPortalSize 1 框架必须包围的最小传送门方块数
baseRange 100 无增强符文时的连接范围
enhancedRange 1,000 弱增强符文时的连接范围
strongRange 10,000 强力增强符文时的连接范围
allowCrossDimension true 门径符文是否可以跨维度连接
muteSounds false 静音传送门环境音和传送音效
redstoneDisables true 红石信号会关闭相邻的传送门

与原版的差异

为什么移植?

原模组可以与 Sinytra Connector 配合工作,但 Connector 可能会破坏模组并增加额外开销。更重要的是,原模组使用 mixin 重写 Minecraft 的传送序列,这在与那些将数据附加到玩家身上的模组一起使用时可能会导致崩溃或数据丢失。这不是原作者的错,这只是模组开发的常态。

本移植版改用 NeoForge 原生的 Portal 接口。由原版处理所有玩家数据和维度跳转。没有 mixin,没有数据丢失,希望兼容性更好。

除了兼容性之外,本移植版还包含许多相对原版的改进:

相对原版的改进

性能

  • 移除了每 tick 的方块实体轮询——原模组每个游戏 tick 都会对每个传送门方块进行 tick 以检查状态。本移植版完全由事件驱动(neighborChanged、连接/断开、符文变化)
  • 完全没有方块实体——传送门状态存储在带有空间索引的世界存档数据中

兼容性

  • 无 mixin——原模组使用 EntityMixin、ServerPlayerMixin 和 LocalPlayerMixin 重写传送。本移植版使用 NeoForge 原生的 Portal 接口,让原版干净地处理所有实体数据和维度转换

玩法

  • 移除符文会重新验证连接——在原版中,从跨维度连接对中移除门径符文后,它们仍保持连接。本移植版会在移除符文时正确断开不兼容的连接
  • 地图集成——传送门会向兼容的地图/小地图模组广播其位置和连接状态
  • 数据包集成

无私人传送门

原模组的私人传送门功能未被包含。该实现在多人游戏中并不具有实际意义。如果你想和朋友一起旅行,那会发生什么?如果确实有传送门访问控制的需求,我可以实现它;但合适的集成应该与 FTB Teams 之类的模组配合。

红石模式

与原模组的三种红石模式(off、on、no effect)相比,本移植版使用一致的行为:通电的传送门被禁用(默认 redstoneDisables = true)。
这使传送门状态可预测,并支持实用的路由构建;完整行为详情请参见红石。

兼容性

  • 需要 NeoForge 1.21.1(21.1.219+)

致谢

原版 Custom Portals 模组由 Palyon 制作(MIT 许可证)。这是对其传奇作品的 NeoForge 重实现。

许可证

GPL-3.0-or-later