QueDP

主题

常见问题 ​

本页面收集了使用 QueDP 过程中的常见问题和解决方案。

安装相关 ​

Q: 插件无法启动？ ​

症状：插件加载失败或报错

可能原因和解决方案：

  1. 未安装依赖插件

    • 确认已安装 MythicMobs 和 WorldEdit
    • 查看控制台是否有缺少依赖的提示

  2. Java 版本不兼容

    • 确认使用 Java 8 或更高版本
    • 推荐使用 Java 17+

  3. 服务器版本不兼容

    • 确认服务器版本为 1.16.5+
    • 使用 Paper/Spigot/Purpur 服务端

  4. 配置文件错误

    • 删除 plugins/QueDP/config.yml 让插件重新生成
    • 检查 YAML 格式是否正确

Q: 如何确认插件正常加载？ ​

查看启动信息：

控制台应该显示类似信息：

[QueDP] ════════════════════════════════════════
[QueDP]   QueDungeon Plus v1.0.0
[QueDP]   ✓ 语言配置 | 已加载 2 个语言
[QueDP]   ✓ JavaScript脚本引擎 | 45 个动作已注册
[QueDP]   ✓ MythicMobs集成 | 已启用 (5.x)
[QueDP]   ✓ 地牢管理器 | 已加载 1 个地牢模板
[QueDP] ════════════════════════════════════════

测试命令：

bash
/dg list

地图相关 ​

Q: 地图无法加载？ ​

可能原因：

  1. 地图文件不完整

    • 世界文件夹必须包含 level.dat
    • Schematic 文件格式必须正确

  2. WorldEdit 未安装

    • Schematic 文件需要 WorldEdit 支持
    • 确认 WorldEdit 版本兼容

  3. 文件路径错误

    • 世界文件夹放在 plugins/QueDP/maps/
    • Schematic 文件放在 plugins/QueDP/maps/schematics/

解决方案：

bash
# 检查地图文件结构
plugins/QueDP/maps/
├── my_world/          # 世界文件夹
│   ├── level.dat     # 必须存在
│   ├── region/
│   └── ...
└── schematics/
    ├── arena.schem
    └── dungeon.schem

Q: 如何导出地图为模板？ ​

方法一：使用世界文件夹

  1. 复制整个世界文件夹到 plugins/QueDP/maps/
  2. 重载插件或重启服务器

方法二：使用 WorldEdit

  1. 在游戏中选择区域
bash
//pos1  # 第一个点
//pos2  # 第二个点
  1. 复制区域
bash
//copy
  1. 保存为 Schematic
bash
//schem save my_map
  1. 文件会保存到 WorldEdit 的 schematics 文件夹
  2. 将文件移动到 plugins/QueDP/maps/schematics/

怪物相关 ​

Q: 怪物无法生成？ ​

可能原因：

  1. MythicMobs 未安装或未启动

    • 确认 MythicMobs 已正确安装
    • 查看控制台 MythicMobs 集成状态

  2. 怪物 ID 错误

    • 检查 MythicMobs 配置中是否存在该怪物
    • ID 区分大小写

  3. 生成位置不正确

    • 确认坐标格式正确：x,y,z
    • 确认生成位置可通行

调试方法：

bash
# 测试生成 MythicMobs 怪物
/dga mythicSpawn <怪物ID> [等级]

# 例如
/dga mythicSpawn SkeletonWarrior 5

Q: 怪物击杀数不统计？ ​

原因和解决：

  1. 怪物必须是 MythicMobs 怪物
  2. 怪物必须通过地牢系统生成
  3. 检查怪物组配置是否正确

编辑器相关 ​

Q: 编辑器工具栏没有显示？ ​

解决方案：

  1. 确认已进入编辑模式：
bash
/dgedit enter <地牢ID>
  1. 如果物品栏被清空，重新进入：
bash
/dgedit exit
/dgedit enter <地牢ID>
  1. 检查权限：
bash
quedp.editor.use

Q: 粒子预览看不见？ ​

可能原因：

  1. 预览模式关闭
bash
/dgedit preview all  # 开启所有预览

  1. 客户端粒子设置

    • 检查客户端视频设置中的粒子选项

  2. 距离太远

    • 靠近标记点查看

Q: 如何保存编辑内容？ ​

手动保存：

bash
/dgedit save

自动保存：

  • 编辑器每 60 秒自动保存
  • 退出编辑模式时会提示保存

脚本相关 ​

Q: 脚本不执行？ ​

检查项：

  1. 语法错误

    • 检查 YAML 格式是否正确
    • 确认缩进使用空格而非 Tab
    • 查看控制台错误信息

  2. 选择器错误

    • 确认使用正确的选择器（@所有玩家、@触发者等）
    • 检查选择器是否有目标玩家

  3. 条件不满足

    • 检查 if 条件是否满足
    • 使用调试消息输出变量值

调试方法：

yaml
# 添加调试消息
- "发送消息 @所有玩家 '&7[DEBUG] 脚本执行'"
- "发送消息 @所有玩家 '&7[DEBUG] 击杀数: {总击杀}'"

Q: 变量不生效？ ​

常见问题：

  1. 变量名错误

    • 确认变量名拼写正确
    • 变量名区分大小写

  2. 变量未定义

    • 确认已使用 设置变量 定义变量
    • 检查变量定义的顺序

  3. 语法错误

    • 变量占位符使用 {变量名}
    • 数学表达式也使用 {表达式}

正确示例：

yaml
- "设置变量 分数 1000"
- "发送消息 @所有玩家 '分数: {分数}'"
- "设置变量 总分 {分数 + 500}"

性能相关 ​

Q: 服务器卡顿？ ​

可能原因和优化：

  1. 同时运行太多实例
yaml
# plugins/QueDP/dungeons/<地牢ID>/config.yml
实例限制:
  # 限制该地牢同时运行的实例数
  最大数量: 3

  1. 地图文件太大

    • 优化地图大小
    • 使用更小的地图

  2. 怪物数量过多

    • 减少怪物生成数量
    • 优化怪物刷新频率

  3. 降低实体限制

yaml
# config.yml
performance:
  entity-limit: 50  # 降低单个副本实体数量限制

Q: 内存占用过高？ ​

优化建议：

  1. 关闭 Schematic 预转换（不推荐）
yaml
# config.yml
schematic-preconvert:
  enabled: false  # 会导致创建地牢时卡服
  1. 限制单个地牢的实例数量
yaml
# plugins/QueDP/dungeons/<地牢ID>/config.yml
实例限制:
  # 该地牢最多同时运行的实例数量
  最大数量: 3
  1. 及时清理过期实例
bash
/dga cleanup
  1. 定期重启服务器

集成相关 ​

Q: 经济奖励不生效？ ​

检查项：

  1. Vault 已安装
bash
/plugins

  1. 经济插件已安装

    • EssentialsX
    • CMI
    • 或其他支持 Vault 的经济插件

  2. 插件集成状态

    • 查看启动信息中的 Vault 状态

  3. 配置正确

yaml
rewards:
  fixed:
    - type: "CURRENCY"
      amount: 1000

Q: 权限奖励不生效？ ​

检查项：

  1. LuckPerms 已安装

  2. 权限格式正确

yaml
rewards:
  fixed:
    - type: "PERMISSION"
      value: "vip.weekly"
      duration: 604800  # 秒，0=永久
  1. 权限节点存在
    • 确认权限系统中有该权限节点

Q: PlaceholderAPI 变量不显示？ ​

检查项：

  1. PlaceholderAPI 已安装

  2. QueDP 扩展已注册

    • 重启服务器后自动注册

  3. 变量格式正确

%quedp_dungeon_<地牢ID>_completion_count%
%quedp_in_dungeon%

权限相关 ​

Q: 玩家无法使用命令？ ​

解决方案：

  1. 添加基础权限
yaml
# LuckPerms
/lp user <玩家> permission set quedp.command.dungeon true
/lp user <玩家> permission set quedp.command.party true
  1. 添加地牢权限
yaml
/lp user <玩家> permission set quedp.dungeon.<地牢ID> true
  1. 查看玩家权限
bash
/lp user <玩家> permission info

Q: 如何设置 VIP 地牢？ ​

配置方法：

  1. 地牢配置添加权限要求
yaml
# dungeons/vip_dungeon/config.yml
requirements:
  permissions:
    - "quedp.dungeon.vip"
  1. 给予玩家权限
bash
/lp user <玩家> permission set quedp.dungeon.vip true

或给予用户组：

bash
/lp group vip permission set quedp.dungeon.vip true

数据相关 ​

Q: 如何重置玩家数据？ ​

重置单个玩家：

bash
/dga reset <玩家> [地牢ID]

重置所有玩家（谨慎）：

  1. 停止服务器
  2. 删除 plugins/QueDP/data/players/ 文件夹
  3. 启动服务器

Q: 如何备份数据？ ​

备份方法：

  1. 停止服务器

  2. 复制文件夹

bash
plugins/QueDP/
├── config.yml        # 配置
├── dungeons/         # 地牢配置
├── data/             # 玩家数据
└── maps/             # 地图模板
  1. 使用 MySQL（推荐）
yaml
# config.yml
database:
  type: MYSQL
  host: localhost
  port: 3306
  database: quedp
  user: root
  password: password

故障排除 ​

日志查看 ​

查看日志文件：

bash
logs/latest.log

开启调试模式：

yaml
# config.yml
debug: true

获取帮助 ​

  1. 查看控制台日志

    • 记录完整的错误信息

  2. 提供配置文件

    • config.yml
    • 相关地牢配置文件

  3. 说明复现步骤

    • 详细描述问题发生的情况

  4. 联系支持

    • QQ群:883939708

更多帮助 ​

基于 MIT 许可发布

Copyright © 2025 QueDP