Advanced Portals - 高级传送门插件

💡简介

Advanced Portals 是一款由 sekwah41 开发的全新 Bukkit 传送门插件，旨在提供丰富且易于使用的功能。该插件添加了一系列用于创建和编辑传送门及目的地的命令。它不仅支持普通的服务器内传送，还能为使用 Bungee 的网络提供跨服务器传送功能。插件设计上力求轻量高效，同时提供强大的特性。

如果您有任何新功能建议或希望报告错误，请在 GitHub 上提交工单。

🎮当前功能

• 自定义传送门创建：允许你自由创建传送门。
• Bungee 跨服传送门：支持将目标位置设定到其他服务器。
• 自定义形状建造：你可以使用传送门方块进行建造，设计任意形状的传送门。
• 进入传送门时执行命令：可配置玩家进入传送门时触发的命令。
• 传送特效：如爆炸或末影之眼效果（默认禁用，需在配置文件中启用）。
• 传送门保护区域：防止无权限的玩家破坏传送门，包括爆炸保护和冻结区域内的流体（也可用于水和岩浆传送门，但目前岩浆仍会点燃玩家）。
• 自定义消息前缀：可以修改发送给普通玩家的消息前缀，使其更符合服务器风格。
• 传送门触发方块：指定插件检测的方块类型，甚至可以使用半砖和楼梯组合来创建独特的传送门。
• 高度可配置：大多数功能都可以通过修改配置文件中的变量来调整或开关。

🔧使用方法

• 使用 /portal (portalblock, gatewayblock 或 endportalblock) 命令获取一块特殊的羊毛，用于放置对应类型的传送门方块。
• 现在，你可以用 portalblock 物品右击一个传送门方块来旋转它。
• 更多详细信息，请查阅文档。

❓常见问题与解答

为什么插件不工作？

• 请检查控制台日志。
• 确保你使用的是 Spigot 或其分支（如 Paper），CraftBukkit 无法运行此插件。
• 最新版本的插件仅支持 1.13 及以上 的 Minecraft 版本。如需支持 1.7 到 1.12，请下载 0.0.41 版本。

选择器工具不工作？

• 请确认受影响的玩家拥有 advancedportals.createportal 权限。
• 检查你是否修改了 config.yml 中的材料设置。
• 例如，使用 LuckPerms 检查权限的命令是：/lp check <用户> advancedportals.createportal

Bungee 功能不工作？

• 确保已在 BungeeCord 中启用 ip_forwarding。
• 参考指南：https://www.spigotmc.org/wiki/bungeecord-ip-forwarding/

Bungee 传送门与目的地问题（仅限 v0.5.0 及以上版本）

• 必须在 Bungee 和 Spigot 两端都安装 Advanced Portals 插件。
• 确保使用相同的 jar 文件版本。
• 命令中必须同时提供目标服务器（bungee:服务器名）和有效的目的地（desti:名称）。
• 目前自动补全功能不支持其他服务器上的目的地，未来会考虑添加。

如何使用 GUI 命令？

• 如果你想使用 GUI 命令，请不要将传送门触发方块设置为 triggerblock，请使用 air 或 water。

X 功能在 Re-Code 版本中缺失了？

• 目前开发重点在于发布核心功能。如有功能缺失，请在 GitHub 上提交工单，我们会尽快添加回来。

Bungee 插件在哪里？

• Bungee 和 Spigot 插件包含在同一个 jar 文件中。只需将相同的 Advanced Portals jar 文件放入你的 Bungee 和 Spigot 插件文件夹即可。
• 通常跨版本可以工作，但如果遇到问题，请确保两端使用的是完全相同的版本。

⭐重要须知

• Java 支持：目前支持 Java 8 及以上版本。未来由于 Velocity 的新特性和变化，我们将迁移至 Java 11。
• 开发状态：本插件仍处于密集开发阶段，并将进行完全重写。但主要功能运行良好，据我所知，这是实现此类传送门插件最高效的方式之一。
• 文档与支持：GitHub Wiki 的布局可能不太理想且难以修改。如需了解具体细节，欢迎加入 Discord 提问，我将制作一个更合适的页面来替代 Git Wiki。

✨链接与联系

• 源代码：请访问 GitHub 仓库。
• 使用教程视频：由 BashBR 制作的葡萄牙语视频。
• Discord：欢迎加入 Discord 进行一般性讨论、提出建议或直接向我发送私信。我在这里可能不那么活跃，但在 Discord 上通常回复更快。
• 报告问题：如果遇到问题，请提供你使用的 Minecraft 版本 和 插件版本，以及是否为 Spigot 的特殊分支（例如 Paper Spigot）。我无法保证立即回复。

🔧计划中的功能

• 编辑现有传送门数据（目前仅支持重命名）。
• 升级开发者 API，以允许注册自定义标签。

💡捐赠

捐赠能极大地激励我继续开发在线项目，因为这表明人们足够喜欢或需要它，并愿意支持我。