Multiverse Portals 技术文档

1. 安装指南

1.1 环境要求

• Minecraft: Java Edition 1.13 及以上版本
• 服务器平台：Bukkit、Paper、Spigot

1.2 下载插件

• 从 Modrinth、Hangar 或 Bukkit 下载最新版本的 Multiverse Portals 插件。

1.3 安装步骤

1. 将下载的 .jar 文件放入服务器的 plugins 文件夹中。
2. 启动服务器，插件将自动加载。
3. 在服务器控制台中输入 mv version 确认插件已成功安装。

2. 项目的使用说明

2.1 创建传送门

1. 使用命令 /mvp create <portal_name> <world_name> 创建一个新的传送门。
2. 使用方块选择工具（如木棍）选择传送门的入口区域。
3. 确认传送门的出口位置，可以使用 /mvp setdest <portal_name> <destination> 设置。

2.2 传送门管理

• 使用 /mvp list 查看所有已创建的传送门。
• 使用 /mvp delete <portal_name> 删除指定的传送门。
• 使用 /mvp info <portal_name> 查看传送门的详细信息。

2.3 高级功能

• 结合 Multiverse Command Destination 插件，可以设置传送门执行命令。
• 使用 Multiverse-NetherPortals 插件，可以为每个主世界设置独立的下界和末地世界。

3. 项目API使用文档

3.1 基本API

• MultiversePortalsAPI：提供传送门创建、删除、查询等基本操作。
• Portal：表示一个传送门对象，包含传送门的名称、入口、出口等信息。

3.2 事件监听

• PortalCreateEvent：传送门创建时触发。
• PortalDeleteEvent：传送门删除时触发。
• PortalTeleportEvent：玩家通过传送门时触发。

3.3 示例代码

import com.onarandombox.MultiversePortals.api.MultiversePortalsAPI;
import com.onarandombox.MultiversePortals.api.Portal;

public class MyPlugin {
    private MultiversePortalsAPI portalsAPI;

    public void onEnable() {
        portalsAPI = (MultiversePortalsAPI) getServer().getPluginManager().getPlugin("Multiverse-Portals");
        Portal portal = portalsAPI.createPortal("myPortal", "world");
        portal.setDestination("anotherWorld");
    }
}

4. 项目安装方式

4.1 手动安装

1. 下载插件的 .jar 文件。
2. 将文件放入服务器的 plugins 文件夹。
3. 启动服务器，插件将自动加载。

4.2 使用构建工具

1. 克隆项目源码：git clone https://github.com/Multiverse/Multiverse-Portals.git
2. 进入项目目录：cd Multiverse-Portals
3. 使用 Gradle 构建项目：./gradlew build
4. 将生成的 .jar 文件放入服务器的 plugins 文件夹。

通过以上步骤，您可以顺利安装并使用 Multiverse Portals 插件，享受其强大的传送门管理功能。