安装配置

本页面包含 QueDP 的详细安装说明、系统要求和故障排除方法。

TIP

如果你想快速开始，请查看 快速开始 页面。

系统要求

服务器要求

• Minecraft 版本: 1.12 ~ 1.21.x
• 服务器类型: Paper / Spigot / Purpur
• Java 版本: Java 8+（推荐 Java 17+）
• 内存建议: 至少 2GB 可用内存
• 磁盘空间: 建议至少 1GB（用于地图模板和副本世界）

必需插件

插件	版本	说明
MythicMobs	4.x / 5.x	用于怪物生成和管理，插件会自动适配版本
WorldEdit	7.x+	用于地图导入和区域操作

可选插件

插件	用途	说明
Vault + 经济插件	经济系统	支持金币奖励
LuckPerms	权限管理	支持临时权限和用户组管理
PlaceholderAPI	变量系统	支持在其他插件中显示副本数据

安装步骤

1. 下载插件

请从官方渠道（如 QQ 群）下载最新版本的 QueDP 插件。

2. 安装依赖

将以下插件放入服务器的 plugins 目录：

plugins/
├── MythicMobs.jar      # 必需
├── WorldEdit.jar       # 必需
├── Vault.jar           # 可选
├── LuckPerms.jar       # 可选
└── PlaceholderAPI.jar  # 可选

3. 安装 QueDP

将 QueDP-x.x.x.jar 文件放入服务器的 plugins 目录。

4. 启动服务器

首次启动时，插件会自动生成以下文件结构：

plugins/QueDP/
├── config.yml          # 主配置文件
├── language/           # 语言文件
│   └── zh_CN.yml
├── dungeons/           # 地牢配置目录
│   └── example/        # 示例地牢
├── maps/               # 地图模板目录
│   └── schematics/     # Schematic 文件
└── data/               # 数据存储目录

准备地图

方式一：使用 Schematic 文件（推荐）

这是最高效的方式，支持地牢秒开。

1. 使用 WorldEdit 保存地图为 .schem 格式（注意：不支持旧版 .schematic 格式）。
2. 将 .schem 文件放入 plugins/QueDP/maps/schematics/。
3. 重载插件或重启服务器。

IMPORTANT

插件默认开启 Schematic 预转换 功能。服务器启动时会自动将 .schem 文件转换为虚空世界，从而实现创建地牢时的零延迟体验。

方式二：使用世界文件夹

1. 将完整的世界文件夹放入 plugins/QueDP/maps/。
2. 确保文件夹内包含 level.dat。
3. 重载插件。

验证安装

使用以下命令验证插件是否正常运行：

/dg list

如果显示已加载的地牢列表，说明安装成功。

常见问题

地图无法加载？

• 确认文件格式为 .schem 而不是 .schematic。
• 确认 WorldEdit 版本与服务器版本兼容。

怪物无法生成？

• 确认 MythicMobs 已正确安装且无报错。
• 检查配置文件中的怪物 ID 是否与 MythicMobs 中定义的一致。

更多问题请查看 常见问题。