Glymera传送门门

GlymeraPortalDoors - 传送门

所有 16 种 Hytale 门的传送门变体。手持生命精华将两扇门配对，穿过其中一扇开启的门，即可传送至其配对门。每扇门仍可正常开关，门框内带有动画传送门光环效果。

目前的正式版本仅适用于 Hytale 稳定版 5！ 不要错过我的其他精彩项目 — 请查看 GlymeraCraft 的个人资料 Discord: https://discord.gg/s5NRFWfxgy

---

什么是 GlymeraPortalDoors?

为每个标准 Hytale 门添加了一个传送门版本（共 16 种），可与原始门一同制作。每个传送门都是一扇功能完整的门，并且在与你选择的另一扇传送门配对后，还能充当传送器。穿过一扇开启的传送门，你会从另一扇门中出来，出现的位置是你放置那扇门时所面对的方向。

当门开启时，一个旋转闪烁的传送门光环效果会充满门框；门关闭时，效果会消失。

---

工作原理

制作

所有 16 种传送门变体都在炼金台的杂项选项卡下制作：

• 原始门的材料（例如，简易变体需要 2x 轻质软木）
• + 15x 生命精华

配置中的 craftingEnabled 开关允许服务器管理员完全禁用该配方。

设置传送对

1. 在同一个世界中任意位置放置两扇传送门。
2. 将一个生命精华拿在手中。
3. 按 F（使用）点击第一扇门 → “配对已开始”
4. 在 60 秒内，按 F 点击第二扇门 → “传送门已配对！”

现在两扇门已建立双向连接。穿过其中一扇开启的门，你会被传送到另一扇门。

使用

• 空手按 F 点击传送门：正常打开/关闭。
• 手持生命精华按 F 点击传送门：开始/完成配对。
• 穿过一扇已配对且开启的传送门：传送至其配对门。你会出现在配对门放置者放置该门时所面对的那一侧，背对着它。
• 穿过一扇关闭的门没有任何效果（不会传送，无效果）。

---

内含内容

所有 16 种标准 Hytale 门变体都有传送门版本：

门类型	传送门变体
简易门	简易门（传送门）
远古木门	远古木门（传送门）
风沙门	风沙门（传送门）
弗兰门	弗兰门（传送门）
寒冰城堡门	寒冰城堡门（传送门）
失落文明木门	失落文明木门（传送门）
竹门	竹门（传送门）
奎比克门	奎比克门（传送门）
伐木工门	伐木工门（传送门）
酒馆门	酒馆门（传送门）
黑暗神庙门	黑暗神庙门（传送门）
大地神庙门	大地神庙门（传送门）
蔓生神庙门	蔓生神庙门（传送门）
光明神庙门	光明神庙门（传送门）
风之神庙门	风之神庙门（传送门）
简易木门	简易木门（传送门）

---

所有权

• 放置一扇传送门的玩家成为其所有者。
• 只有所有者（或服务器管理员）可以破坏门或更改其配对。
• 当一扇门被破坏时，其配对门会自动解除连接。

---

指令

指令	权限	描述
/gpd	管理员	显示调优摘要
/gpd pitch / yaw / roll <弧度>	管理员	调整粒子旋转（弧度）
/gpd scale <浮点数>	管理员	调整粒子缩放
/gpd cy <浮点数>	管理员	调整垂直中心偏移
/gpd width / height <浮点数>	管理员	网格跨度（为未来布局预留）
/gpd cols / rows <整数>	管理员	网格数量（预留）
/gpd orient <0-3>	管理员	哪个方向轴接收 door.yaw: 0=yaw, 1=pitch, 2=roll, 3=关闭
/gpd show	管理员	打印当前调优值

调优指令是为未来的视觉调整预留的；内置默认值已经正确。

---

配置

文件：plugins/GlymeraPortalDoors/config.json（首次启动时创建）

设置	默认值	描述
craftingEnabled	true	指示性设置：设为 false 以阻止制作（实际配方嵌入在资源包中，目前始终激活）

---

持久化

• 门的位置、所有权和配对信息存储在 plugins/GlymeraPortalDoors/doors.json 中。
• 服务器重启： 所有门和配对信息都会保留。
• 区块重新加载： 门数据会被保留；只有当方块被确认替换为其他类型时，才会从注册表中移除。
• 实际朝向方向是从已放置方块的旋转中实时读取的 - 如果 Hytale 旋转门的方式与玩家头部方向不同，粒子和出口位置会跟随实际的方块旋转。

---

性能

• 快速扫描（50 毫秒）： 遍历在线玩家，并对每个玩家进行一次 O(1) 哈希表查找以找到匹配的传送门。穿行检测使用 3x3x2 单元格查找 + 半径检查，以及上一次扫描的回退位置，以捕捉快速跑动的玩家。
• 慢速滴答（1.5 秒）： 每个门的粒子重生和旋转刷新。读取方块的实际旋转索引，并在 door.yaw 漂移时进行修正。
• 传送保护： 每个玩家有 3 秒冷却时间，通过最后位置清理来消除，防止双重触发。

扩展性：100 名玩家 x 100 对已配对的门，每秒 CPU 占用仍远低于 1 毫秒。

---

特性

• 16 种传送门变体 - 对应每个标准 Hytale 门
• 原生风格的动画传送门效果（使用 Hytale 的 PlayerSpawn_Portal 光环，重新定位和定向以适配门框）
• 效果和传送仅在门开启时激活 - 关闭传送门会完全禁用传送门
• 仅所有者可破坏/配对 - 内置防恶意破坏保护
• 使用生命精华作为配对“钥匙” - 直观，重用现有 Hytale 资源
• 双向配对 - 当一扇门被破坏或重新配对时，其配对门会自动更新
• 真实方块旋转 - 粒子和出口方向跟随实际放置的方块，而不仅仅是玩家的视角向量
• 破坏时的幽灵方块清理 - 防止两格高的门在 IsDoor=false 时留下不可见残留物

---

安装

1. 将 GlymeraPortalDoors-1.0.0.jar 放入服务器的 mods/ 文件夹。
2. 启动（或重启）服务器。
3. 所有内容都嵌入在 JAR 文件中 - 无需外部资源文件夹。

---

值得了解

• 传送门是独立的物品，与原始门不同。两种配方共存；原始门仍在工匠台制作，传送门变体在炼金台制作。
• 每扇传送门都充当普通门。配对和传送是附加功能。
• 穿过一扇关闭的传送门不会发生任何事情。玩家仍然可以正常打开和穿过，没有任何传送副作用。
• 传送门光环效果会随着门自动旋转。如果你拆除一扇旧门，以不同朝向放置一扇新门，效果会在 1.5 秒内自行更新。
• 配对环境是独占的：将一扇门与新伙伴配对会自动解除该门两侧之前的配对。

---

由 Glymera 为 Hytale 社区精心制作