QueDP

主题

配置文件 ​

主配置文件位于 plugins/QueDP/config.yml，用于控制插件的全局行为。

基础设置 ​

yaml
# 语言设置（对应 lang/ 目录下的语言文件）
language: zh_CN

# 是否启用 SimpleComponent 富文本支持
enableSimpleComponent: false

# 调试模式（开启后输出详细日志）
debug: false

Schematic 预转换 ​

控制地图模板的 schematic 文件是否在启动时预转换。预转换后创建副本时无需实时转换，避免卡服。

yaml
schematic-preconvert:
  # 是否在服务器启动时自动预转换所有 schematic 文件
  # true: 启动时异步转换，创建地牢时秒开（推荐）
  # false: 创建地牢时实时转换，会卡服 3-5 秒
  enabled: true

提示

此功能需要安装 WorldEdit 插件。

数据库设置 ​

yaml
database:
  # 数据库类型: YAML, SQLITE, MYSQL
  type: YAML
  # MySQL 设置（当 type 为 MYSQL 时使用）
  host: localhost
  port: 3306
  database: quedp
  user: root
  password: password

注意

目前仅实现了 YAML 文件存储。SQLITE 和 MYSQL 为预留选项，尚未实现。

副本设置 ​

yaml
dungeon:
  # 实例清理超时时间（秒）- 兜底安全机制
  # 用于清理异常情况：玩家全掉线、实例卡死、创建失败等
  # 正常完成的地牢会立即清理，无需等待此时间
  instance-timeout: 7200

提示

每个地牢的实例数量限制和时间限制在各自的 config.yml 中配置，不在此处。

队伍设置 ​

yaml
party:
  # 队伍最大人数
  max-size: 4
  # 邀请超时时间（秒）
  invite-timeout: 60
  name:
    # 队伍名称最大长度
    max-length: 20
    # 是否允许颜色代码
    allow-color: false

性能设置 ​

yaml
performance:
  # 每个副本世界的实体数量上限
  entity-limit: 100

排行榜设置 ​

yaml
leaderboard:
  # 是否启用排行榜
  enabled: true
  # 每页显示条目数
  entries-per-page: 10
  # 数据保留天数
  retention-days: 30
  # 排行榜更新间隔（秒）
  update-interval: 60

统计设置 ​

yaml
statistics:
  # 是否启用统计系统
  enabled: true
  # 副本结束后是否自动显示统计
  auto-show: true
  # 是否追踪伤害数据
  track-damage: true
  # 是否追踪承受伤害
  track-damage-taken: true
  # 是否追踪治疗数据
  track-healing: false
  # 统计显示时长（秒）
  display-duration: 30

体力设置 ​

体力系统用于限制玩家进入副本的频率。玩家进入地牢时消耗体力，体力会随时间自动回复。

yaml
stamina:
  # 是否启用体力系统
  enabled: true
  # 最大体力值
  max-stamina: 100
  # 每次回复多少点
  recovery-rate: 1
  # 回复间隔（秒）
  recovery-interval: 60
字段类型默认值说明
enabledBooleantrue关闭后所有地牢不消耗体力
max-staminaInt100玩家体力上限
recovery-rateInt1每次回复的体力点数
recovery-intervalInt60回复间隔（秒）

提示

每个地牢的体力消耗在各自 config.yml 的 requirements.stamina_cost 中配置。设为 0 表示该地牢不消耗体力。

管理员可通过命令管理玩家体力：

  • /dg admin stamina <玩家> — 查看体力
  • /dg admin stamina <玩家> set <数值> — 设置体力
  • /dg admin stamina <玩家> add <数值> — 增加体力
  • /dg admin stamina <玩家> reset — 重置为满体力

更新设置 ​

yaml
update:
  # 是否检查更新
  check: true
  # 是否通知在线管理员
  notify: true
  # 是否自动下载更新（不推荐，建议手动）
  auto-download: false
  # 检查间隔（小时，0 = 仅启动时检查）
  check-interval: 6
字段类型默认值说明
checkBooleantrue是否启用更新检查
notifyBooleantrue有更新时是否通知拥有 quedp.admin 权限的在线玩家
auto-downloadBooleanfalse是否自动下载新版本 jar
check-intervalInt6检查间隔（小时），0 表示仅服务器启动时检查一次

基于 MIT 许可发布

Copyright © 2025 QueDP