Wuufu's Waygates - 传送门插件

💡Wuufu's Waygates 传送门插件

Wuufu's Waygates 是一款灵感来源于 Creative Gates 和 Stargate 的传送门插件。它允许玩家使用几乎任何方块（除少数关键方块外）建造传送门，并将其连接成互联的网络，整个过程无需使用任何指令。本插件高度可配置，拥有易于上手但功能深入的权限系统，并且支持完全翻译，所有消息文本都可供轻松本地化。本项目基于 GNU 通用公共许可证第三版授权。

🎮创建传送门

传送门框架可以由任何方块建造，但框架中必须包含两个绿宝石方块（可配置）。请注意，如果框架被破坏，传送门也会随之失效，因此建议使用坚固的材料建造框架。

框架建好后，玩家还需要制作一个传送门构造器。合成方法是在工作台中，用红石围绕一个金粒。

• 手持传送门构造器，点击框架的内部空间即可完成传送门的创建。
• 传送门内部空间最小可以是 1x1，最大可达 200x200（可配置）。
• 创建传送门时请注意你的站立位置，该位置将被设定为传送门的出口点。你也可以在传送门建成后，再次使用构造器点击框架来更新出口位置。

传送门创建后，会被赋予一个随机名称并分配到 Void（虚空）网络。虚空网络名副其实——该网络内的所有传送门彼此不可见，玩家也无法在其间旅行（管理员除外）。因此，最好立即为你的传送门重命名并分配到一个不同的网络。

🎮使用与编辑传送门

要使用或修改传送门，你首先需要制作一把传送门钥匙。合成方法是在工作台中，用红石围绕一根羽毛。

制作完成后，手持传送门钥匙右键点击传送门框架的任何部分，即可打开传送门管理界面。通过这个界面，你可以：

• 连接到同一网络下的其他传送门。
• 更改传送门的设置（如名称）。
• 更改传送门所属的网络。

传送门模式

传送门可以设置为两种模式

• 定时模式：打开一个连接后，传送门会保持开启20秒（可配置）供你通过，随后自动关闭。
• 常开模式：传送门连接会永久保持开启。

无论哪种模式，当传送门处于激活状态时，其当前连接的目标都会在目的地列表中优先显示。

权限与外观

传送门还可以设置为

• 私有：只有所有者可以使用钥匙操作或通过此门旅行。
• 隐藏：只有所有者能在网络中看到此门并旅行至该门。

拥有 wg.bypass 权限的玩家可以绕过这些限制。

玩家还可以通过潜行状态，手持特定物品右键点击框架来更改传送门的图标。传送门会消耗该物品并将其设为图标。如果该物品是一本成书，传送门会消耗它，并将书中的文本（最多200字符，可配置）用作传送门的描述。

🎮控制器

传送门控制器可以作为传送门的远程激活装置，无需亲临传送门即可更改其目的地。

创建控制器

• 制作一个控制创造器：在工作台中心放置一把传送门钥匙，在其左右两侧各放一个传送门构造器。
• 手持控制创造器右键点击一个方块，即可在该方块位置生成一个传送门控制器。

使用控制器

• 可以使用传送门钥匙或空手与控制器交互。
• 控制器可以设置为激活半径50格内（可配置）的任何传送门。

🎮固定目的地

传送门可以设置一个固定目的地。这意味着该传送门只能开启通往那个特定的目标传送门，即使网络中存在其他可用传送门。

• 拥有固定目的地的传送门，可以通过在框架旁或框架上放置并激活红石信号源（如压力板、按钮）来激活并开启。
• 如果出发门是私有的，或目标门是隐藏的，那么受限传送门的所有者需要位于触发红石事件的附近，门才会开启。

🎮网络系统

插件包含六种网络类型

网络类型

• Void（虚空）网络：特殊系统网络，此网络内所有传送门彼此不可见，只有管理员能在其间旅行。
• 系统网络：默认包含五个——Overworld（主世界）、Ocean（海洋）、Nether（下界）、The End（末地）、Underworld（下界）。
• 全局网络：自定义的公共网络，所有人均可加入。
• 邀请网络：由玩家创建，并可邀请其他用户加入并添加传送门的网络。
• 私有网络：仅对传送门所有者私有的网络。
• 固定网络：类似全局网络，任何人都可以加入。但只有网络所有者（或被所有者“邀请”到网络组的成员）能将其传送门设为非隐藏状态，其他所有传送门默认隐藏，从而为所有人提供少数几个固定的公共出口。

网络管理

• 所有网络类型都可通过权限控制，服务器管理员可以决定谁有权创建和/或添加传送门到这些网络。系统网络、全局网络和固定网络还支持单独的特定权限。
• 拥有相应权限的玩家可以将传送门分配到这些网络，或从网络列表中创建自己的网络。
• 网络图标根据类型预设，但网络所有者或服务器管理员可以通过“网络设置”菜单完全更改为其他图标。

关于固定网络

固定网络默认不包含在玩家权限组中。其设计初衷是让服务器所有者能够设置一个或多个对任何连接者都开放的出口传送门。为了避免网络列表杂乱，非出口传送门会自动隐藏，只有出口传送门会显示。

🔧实体传送

注意：传送门的实体传送系统目前无法正常工作。计划是使用现代 API 彻底重写此系统。

除了传送玩家，传送门还能传送其他实体

• 玩家骑乘的生物或载具（如马、船）会一同传送，玩家在另一端出现时仍处于骑乘状态。
• 玩家用拴绳牵引的生物也会在出口点的安全位置出现，仍处于被牵引状态。
• 掉落的物品或未被控制的生物也可以通过传送门，并出现在出口点。但这仅适用于使用“下界效果”且连接到同样使用该效果的传送门的情况。

请确保出口端有足够的空间容纳你想要传送的生物，否则你或你的生物可能会窒息。

🎮指令

为服务器管理员提供了一些实用指令，便于在多世界服务器中管理传送门。

• /wg list [世界名] [页码]：列出指定世界中的传送门。
• /wg delete <世界名>：删除指定世界中的所有传送门。
• /wg reload：重新加载配置文件。

查看完整指令列表

🎮权限

查看完整权限列表

🎮配置

查看配置信息

✨可选集成

• NBT API：为插件物品添加 NBT 标签，便于识别并与 MMOItems 等插件兼容。

-   **请注意版本要求**：1.18 需要此插件 2.9.0+ 版本，1.19 需要 2.10.0+，1.20 需要 2.11.3+。

❓其他传送门插件推荐

我知道并非所有传送门插件都能满足每个服务器的需求（这也是我创建本插件的原因）。如果你正在寻找传送门插件而本插件不符合你的要求，以下是一些推荐：

• Advanced Portals：高级传送门插件（支持 BungeeCord）。
• Ancient Gates：使用指令创建传送门。
• Portal Stones：改造下界传送门用于本地旅行。
• The Gate：一个星际之门风格插件（支持 BungeeCord）。
• Simple Portals：创建基于区域的传送门（支持 BungeeCord）。
• Stargate：重制版的星际之门插件。