Multiverse 系列传送门插件

Multiverse-Portals

Multiverse 系列传送门插件，允许你在任意世界之间创建自定义传送门——方块门、付费门、矿车/船只通道、甚至触发命令执行或 BungeeCord 跨服跳转。与 Multiverse-Core 深度集成，是构建多世界服务器的核心组件之一。

为什么选择 Multiverse-Portals
任意目的地：传送门可指向任何 Multiverse 目的地——世界、锚点、精确坐标、甚至另一个传送门
多实体支持：不只是玩家，所有生物实体都能通过传送门（v5.2.0+）
命令执行：传送门触发时可直接执行服务器命令，实现"进门即执行"的高级玩法
BungeeCord 集成：传送门可跳转到 BungeeCord 代理下的其他服务器节点
经济收费：每个传送门可单独设置使用费用，支持 Vault 经济
权限管控：通过权限节点精确控制谁能使用哪个传送门
载具通行：矿车、船只可直接驶过传送门完成跨世界转移
空中发射：玩家进入传送门时可被弹射到空中（配合炮台目的地）
游戏内全配置：无需手改配置文件，所有操作均有交互式引导
与 Multiverse 全家桶无缝协作

版本与兼容性

| 项目 | 说明 |
| :--- | :--- |
| 当前版本 | v5.2.0 |
| 服务端 | Paper / Purpur / Spigot / Bukkit |
| Minecraft | 1.18.2 – 26.2 |
| Java | 17+ |
| 前置依赖 | Multiverse-Core 5.x（必须） |
| 可选依赖 | Vault（经济收费）、WorldEdit（选区工具增强）、BungeeCord / Velocity（跨服跳转） |
⚠️ v5.x 是重写版本，命令结构与 v4 不兼容。如果你从旧版升级，请使用 /mvp import 迁移旧传送门数据。

核心功能详解
传送门创建与管理
手持选择工具（默认为木棍，可通过 /mvp wand 获取）
左键点击传送门框架的一个角
右键点击对角位置，完成区域选择
使用 /mvp create <ID> <目的地> 创建传送门

目的地格式：

| 类型 | 格式示例 | 说明 |
| :--- | :--- | :--- |
| 世界 | w:survival | 传送到目标世界出生点 |
| 精确坐标 | e:world:100:64:200 | 传送到指定坐标 |
| 另一个传送门 | p:portal_id | 串联传送门 |
| 命令执行 | cmd:gamemode creative | 进门触发命令 |
| 炮台发射 | cannon | 将玩家弹射到空中 |
权限与费用
每个传送门可绑定独立权限节点 mvportals.portal.<ID>
无权限的玩家尝试使用会被拒绝并收到提示
配合 Vault 可设置使用费用，玩家余额不足时无法通行
可配置免费名单（特定权限组免付费）
载具与实体
矿车、船只驶入传送门后自动跨世界转移
v5.2.0 起支持所有生物实体通过传送门（不只是玩家）
可用于自动化农场、生物运输等高级场景
命令执行与 BungeeCord
传送门可配置为执行任意服务器命令（以控制台身份或玩家身份）
配合 BungeeCord 可实现"进传送门 = 跳转到另一台服务器"
v5.2.0 新增 action handler 系统，支持更灵活的触发逻辑
搭配推荐

| 插件 | 配合效果 |
| :--- | :--- |
| Multiverse-Core | 必须前置，提供世界管理基础 |
| Multiverse-NetherPortals | 自动链接下界/末地传送门 |
| Multiverse-Inventories | 跨世界背包/状态隔离 |
| Vault | 传送门收费功能 |
| WorldEdit | 增强选区工具体验 |
| PlaceholderAPI | 在传送门消息中显示动态变量 |

获取支持
GitHub Issues：github.com/Multiverse/Multiverse-Portals/issues
Modrinth：modrinth.com/plugin/multiverse-portals
Hangar：hangar.papermc.io/Multiverse/Multiverse-Portals
SpigotMC：spigotmc.org/resources/multiverse-portals