## **重要提示**
本插件是 replugined 版本的一个插件，该插件已结束支持。原始创建者是 XZot1K & AlessioGR 贡献。 [链接到原始版本](https://www.spigotmc.org/resources/%E2%8D%9F-simple-portals-%E2%8D%9F-effective-regional-portals-bungeecord-compatible.56772/)。本插件是他们大部分的工作，迄今为止来自 the_n1n 仅添加了少量更改。
# 简单传送门
简单传送门是创建区域式传送门的最简单且最有效的方法。该插件已在许多大型实时服务器上进行了广泛测试并经过压力测试，以确保性能最佳。简单传送门还允许在你的 BungeeCord 服务器上远程传送玩家，而无需使用 BungeeCord API！
## 特性
- **跨服务器传送门** - 借助 MySQL，可以将玩家传送到其他服务器的特定位置
- **精美视觉效果** - 选择和区域显示会以粒子效果突出显示
- **无依赖** - 该插件是独立的
- **每个传送门权限** - 控制玩家可以访问哪些传送门
- **命令联想** - 提供缩写，以便更轻松地使用
- **流体控制** - 传送门区域内的流体会被冻结
- **轻量级更新检查器** - 你的配置始终是最新的
- **强大的开发者 API** - 触手可及地完全控制插件
- **易于操作** - 所有命令和功能都设计成易于使用
- **实体传送门传送** - 物品或车辆等实体都可以通过传送门传送，同时保持速度
- **虚空/末地传送门目的地替换** - 能够在任何世界中替换所有虚空/末地传送门的目的地
- **强制加入** - 能够在玩家加入服务器时强制其返回指定世界的出生点
## 命令
（注：输入无效命令时，将显示用法消息。）
- `/simpleportals selectionmode` (或 sm) - 切换玩家的开关状态，进出选择模式，允许他们创建区域。
- `/simpleportals reload` - 重新加载所有配置。
- `/simpleportals info` - 提供关于插件的信息。
- `/simpleportals create ` - 如果玩家的区域已完全创建，则创建一个新的传送门。
- `/simpleportals delete ` - 删除现有的传送门。
- `/simpleportals fill ` - 尝试用定义的材质填充传送门（方向性支持有限，这意味着某些材质可能需要先放置或创建才能更好地放置）。
- `/simpleportals setlocation ` (或 sl) - 将指定传送门的传送位置设置为发送者的位置。
- `/simpleportals setlocation ` (或 sl)- 将指定传送门的传送位置设置为另一输入的传送门的中心。
- `/simpleportals ` (或 sr)- 显示指定传送门的区域。
- `/simpleportals ` - 启用/禁用传送门，直到再次切换
- `/simpleportals switchserver ` (或 ss) - 设置传送门将玩家传送到哪个服务器。
请注意，要从传送门中删除服务器，必须将其设置为“none”。
- `/simpleportals setswitchlocation ` (或 ssl) - 设置在转移到另一个服务器时的传送门目的地
- `/simpleportals addcommand ` (或 addcmd) - 此命令将在玩家进入传送门时运行命令行（你可以在命令末尾添加冒号，后跟 PLAYER 或 CONSOLE，以确定命令的运行方式）。
- `/simpleportals clearcommands ` (或 clearcmds) - 此命令只需清除列表中的命令。
- `/simpleportals togglecommandonly ` (或 tco) - 此命令切换传送门的仅命令模式。
- `/simpleportals commands ` (或 cmds) - 提供以添加顺序列出定义传送门的所有命令。
- `/simpleportals message ` - 将指定传送门的 message 设置为指定的文字（可以使用冒号后跟 NORMAL、BAR、TITLE 或 SUBTITLE 来定义消息的类型）。
- `/simpleportals disablemessages ` (或 dm) - 禁用与定义的传送门关联的所有消息。
- `/simpleportals cooldown ` - 设置指定传送门的冷却时间，以秒为单位。
- `/simpleportals delay ` - 设置指定传送门的延迟时间，以秒为单位。
- `/simpleportals find ` - 在指定的范围内查找 3 个附近的传送门。
## 权限
- `simpleportals.showregion` - 允许玩家查看传送门的区域。
- `simpleportals.setlocation` - 允许玩家设置传送门的远程传送位置。
- `simpleportals.info` - 允许玩家查看插件的信息。
- `simpleportals.reload` - 允许玩家重新加载配置文件。
- `simpleportals.create` - 允许玩家创建传送门。
- `simpleportals.delete` - 允许玩家删除传送门。
- `simpleportals.list` - 允许玩家列出所有传送门。
- `simpleportals.switchserver` - 允许玩家使用 BungeeCord 将玩家传送到另一个服务器。
- `simpleportals.setswitchlocation` - 允许玩家设置传送门的切换服务器位置。
- `simpleportals.selectionmode` - 允许玩家进出选择模式。
- `simpleportals.portal.*` - 允许玩家使用所有传送门。
- `simpleportals.portal.` - 允许玩家使用指定的传送门。
- `simpleportals.addcommand` - 允许玩家将命令添加到指定的传送门。
- `simpleportals.clearcommands` - 允许玩家清除指定的传送门的所有命令。
- `simpleportals.togglecommandonly` - 允许玩家切换传送门的仅命令模式。
- `simpleportals.viewcommands` - 允许玩家查看传送门的命令。
- `simpleportals.toggle` - 允许玩家完全切换传送门。
- `simpleportals.message` - 允许发送者使用传送门的 message 命令。
- `simpleportals.dm` - 允许发送者使用传送门的禁用消息命令。
- `simpleportals.fill` - 授予访问传送门填充命令的权限。
- `simpleportals.cooldown` - 允许发送者使用 /simpleportals cooldown 命令。
- `simpleportals.delay` - 允许发送者使用 /simpleportals delay 命令。
- `simpleportals.find` - 允许发送者使用 /simpleportals find 命令。
- `simpleportals.admin` - 授予玩家插件的所有权限。
- `simpleportals.cdbypass` - 允许玩家绕过传送门冷却。
- `simpleportals.use` - 允许发送者使用基本的 /simpleportals 命令。
### 使用 SimplePortals 的服务器:
** [Skade Gaming](https://skadegaming.com/) | 该服务器拥有超过 2500 个传送门！**
以下是传送门创建过程中区域视觉显示的一个非常简短的示例:
## 插件用法
简单传送门旨在，嗯... 简单！因此，传送门创建过程非常简单。请参阅以下说明:
[注意] - "选择模式" 命令是一个开关，这意味着运行一次将启用，运行两次将禁用。
1. 为了创建传送门，你必须首先使用命令 "/portals selectionmode" 或 "/portals sm" 进入“选择模式”。
2. 接下来，你需要“左键单击”立方体或矩形区域的一端最低的方块，然后“右键单击”区域的另一角最高方块。这将设置你当前的选择，用于稍后创建的任何传送门。
3. 为了完成传送门创建过程，你必须使用命令 "/portals create <传送门名称>" 使用你的 WorldEdit-Like 选择来创建传送门。
4. 从此点起，你已经创建了一个传送门。默认情况下，传送门将远程传送玩家的位置始终设置为最低方块或点 1。要更改传送门的远程传送位置，请使用命令 "/portals setlocation" 或 "/portals sl" 在你希望传送门远程传送你的位置。
以下是一些额外的信息:
你可以使用命令 "/portals fill <传送门>" 用特定的材质填充传送门的区域（不要担心，所有基于液体的材质都不会流出区域）。
你可以使用命令 "/portals relocate <传送门>" 在另一个选择模式下进行另一个选择后重新定位传送门的区域。
对于插件中的命令和其他功能，使用 {player} 作为占位符以获取玩家的姓名。
为了让玩家通过 Bungee 远程传送，只需使用命令 "/portals ss <传送门> <服务器>" 设置服务器名称。你可以将此值设置为“none”以禁用传送门的此功能。
不要忘记使用 "/simpleportals <传送门> <世界> " 设置远程传送门的坐标。
你还可以在玩家加入服务器时向其发送命令。
关于将命令添加到传送门，可以使用命令 "/portals addcmd <传送门名称> <命令>:<类型>"，其中 <类型> 为 PLAYER、CONSOLE 或 CHAT。
你可以使用命令 "/portals clearcommands <传送门>" 来清除命令。
**命令示例**:
```
"/portals addcmd example-portal rtp:PLAYER"
此命令将像玩家发送命令一样运行 /rtp。
"/portals addcmd example-portal rtp {player}:CONSOLE"
此命令将像玩家发送命令一样运行 /rtp。
"/portals addcmd example-portal rtp:CHAT"
此命令将像玩家在聊天中键入它一样运行 /rtp。
请注意，/rtp 不是 SimplePortals 的功能。
```
在添加命令时，请不要使用斜杠。
添加命令时，请务必以冒号结尾，后跟 PLAYER 或 CONSOLE。 自 v1.3.6 以来，还可以使用 CHAT，它将命令发送到聊天以供其他插件用作伪命令！
类似于添加命令，设置传送门的 message 需要一个类型。 在输入的文本后面，只需添加 :NORMAL、:BAR、:TITLE 或 :SUBTITLE 以定义应设置的消息类型（包含冒号）。 这与添加命令的原理相同。
### 开发者 API ⍟
目前，API 中的所有内容都可以在插件内的 API 包中找到，该包可以在 GitHub 页面上找到。 但是，你可以在下方找到 API 类名及其用途。
- Manager (Class) - 此处存储所有常规方法、计算和存储列表或映射。
- PointType (Enum) - 用于监听器中区域选择。
- Portal (Class Object) - 存储有关单个传送门的所有信息的完整对象。
- Region (Class Object) - 存储有关区域（坐标和位置）的所有信息的完整对象。
- SerializableLocation (Class Object) - 用于序列化位置并防止对同一位置进行未来更改。
- TaskHolder (Class Object) - 用于存储每个玩家的视觉效果任务。 此类还管理它们，以确保一次不显示过多的任务。
- PortalEnterEvent (Event Object) - 当玩家进入传送门区域时，会调用此事件。
## 常见问题解答
（Q）在使用专门的传送门材质进行简单传送门时，用户被远程传送到了虚空/末地。
（A）此问题之前已被报告，大多数情况下，这与诸如 Multiverse 或 MultiWorld 之类的世界操作插件有关。请确保在不使用世界插件的情况下进行测试，并使用其最新版本（开发版本），以确保这不是已解决的问题。 你还可以使用 vanilla 游戏规则命令增加虚空/末地传送门的 time！
（Q）我在控制台中收到错误/消息，涉及“simpleportals.cdbypass”权限节点。我如何解决此问题？
（A）这不是一个实际的问题，消息是通知具有此权限的 OP 或用户的他们已绕过此功能的冷却。可以通过在 lang.yml 中将其设置为 "" 来禁用此消息。
（Q）我在控制台中收到错误，而且我无法远程传送或使用传送门。我如何解决此问题？
（A）该插件是 Minecraft 最新版本的原生，因此较旧的版本可能需要在配置中进行调整。通常，在这种情况下，通过在 config.yml 中设置粒子选项来解决此问题。
（Q）我如何禁用传送门的标题、操作栏或副标题消息？
（A）如果传送门尚未创建，请在 lang.yml 中设置默认消息将禁用所有新创建的传送门的这些消息。对于已经创建的传送门，你可以要么禁用插件并在 portals.yml 中将消息设置为 ""，要么使用命令 "/portals message :NORMAL"、"/portals message :BAR"、"/portals message :TITLE" 或 "/portals message :SUB-TITLE" 简单地单独禁用每个消息。 从 v1.5.1 开始，可以使用命令 "/portals dm " 禁用消息。