配置文件

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

基础设置

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

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

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

Schematic 预转换

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

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

数据库设置

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

副本设置

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

防逃逸设置

拦截玩家用末影珍珠、紫颂果、传送门等手段逃出副本世界。命令传送、插件传送以及副本正常结束的传送都不受影响。

dungeon:
  anti-escape:
    # 是否启用
    enabled: true
    # 处理模式：
    #   BLOCK         - 取消传送，玩家留在副本原地（推荐）
    #   TELEPORT_BACK - 取消传送并拉回副本出生点
    #   FAIL          - 允许离开，但整个副本判定失败
    mode: BLOCK

字段	类型	默认值	说明
`enabled`	Boolean	true	是否启用防逃逸拦截
`mode`	String	BLOCK	处理模式：`BLOCK` / `TELEPORT_BACK` / `FAIL`

队伍设置

party:
  # 队伍最大人数
  max-size: 4
  # 邀请超时时间（秒）
  invite-timeout: 60
  # 是否强制将共享范围锁定为「仅副本内」
  # 开启后玩家无法把战利品/经验共享改为全局
  force-dungeon-only-share-scope: false
  # 队伍仓库
  storage:
    # 是否启用队伍仓库功能
    enabled: true
  name:
    # 队伍名称最大长度
    max-length: 20
    # 是否允许颜色代码
    allow-color: false

字段	类型	默认值	说明
`max-size`	Int	4	队伍最大人数
`invite-timeout`	Int	60	邀请超时时间（秒）
`force-dungeon-only-share-scope`	Boolean	false	开启后队伍共享范围被强制锁定为「仅副本内」
`storage.enabled`	Boolean	true	关闭后整体禁用队伍仓库功能

性能设置

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

排行榜设置

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

统计设置

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

体力设置

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

stamina:
  # 是否启用体力系统
  enabled: true
  # 最大体力值
  max-stamina: 100
  # 每次回复多少点
  recovery-rate: 1
  # 回复间隔（秒）
  recovery-interval: 60

字段	类型	默认值	说明
`enabled`	Boolean	true	关闭后所有地牢不消耗体力
`max-stamina`	Int	100	玩家体力上限
`recovery-rate`	Int	1	每次回复的体力点数
`recovery-interval`	Int	60	回复间隔（秒）

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

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

更新设置

update:
  # 是否检查更新
  check: true
  # 是否通知在线管理员
  notify: true
  # 是否自动下载更新（不推荐，建议手动）
  auto-download: false
  # 检查间隔（小时，0 = 仅启动时检查）
  check-interval: 6

字段	类型	默认值	说明
`check`	Boolean	true	是否启用更新检查
`notify`	Boolean	true	有更新时是否通知拥有 `quedp.admin` 权限的在线玩家
`auto-download`	Boolean	false	是否自动下载新版本 jar
`check-interval`	Int	6	检查间隔（小时），`0` 表示仅服务器启动时检查一次