YlesssのWiki

配置说明 ​

修改 config.yml、datasource.yml、icons/*.yml 和消息文件后，可以使用 /ybh reload 重载。

修改 DragonCore HUD 文件后，需要重进客户端查看效果。

配置文件 ​

文件 / 目录用途
config.yml基础设置
datasource.yml数据存储
icons/Buff 图标
message.yml消息文本
plugins/DragonCore/Gui/YlesBuffHud.ymlHUD 界面

配置示例 ​

下面几个文件是插件默认配置。复制时注意文件路径。

yaml
# 是否开启调试模式
# 说明：调试模式会打印较多内部信息，并在 HUD 上显示刷新诊断，仅在开发或排查 bug 时建议开启。
debug: false

# 是否启用 bStats
# 说明：bStats 会收集一些匿名使用数据（如插件版本、服务器软件等），用于插件开发者改进功能与兼容性。
#       该统计不包含个人可识别信息；如需完全不发送任何数据可设为 false。
metrics: true

dragon:
  # 同一玩家的 HUD 刷新最小间隔，单位毫秒
  packet-interval-ms: 120
  # 过期图标扫描周期，单位 tick
  clear-expired-interval-ticks: 20

# 状态栏排版
hud:
  # horizontal 横排，vertical 竖排
  direction: horizontal
  # 横排时一行几个
  columns: 8
  # 竖排时一列几个
  rows: 8
  icon:
    # 图标横向间距
    gap-x: 3
    # 图标纵向间距
    gap-y: 3
yaml
# 自动保存
auto-save:
  enable: true
  time: 6000
  batch-size: 10
  batch-delay: 1

# 存储类型：MySQL，SQLite
use-datasource: SQLite

# 数据库配置
datasource:
  hostname: localhost
  port: 3306
  username: root
  password: 123456
  database: mc
  properties:
    - "useUnicode=true"
    - "characterEncoding=utf8"
    - "useSSL=false"
  driver-class-name: com.mysql.cj.jdbc.Driver
  hikari:
    maximum-pool-size: 12
    minimum-idle: 1
    idle-timeout: 600000
    connection-timeout: 30000
    max-life-time: 1800000
yaml
# 示例图标，配置名就是图标 ID
speed:
  # 显示名称
  display: "迅捷"
  # DragonCore 贴图路径
  texture: "YlesBuffHud/textures/speed.png"
  # 排序权重，数字越大越靠前
  priority: 100
  # 默认持续时间，单位毫秒
  default-duration-ms: 30000
  # 重复添加时的处理方式：override 覆盖，extend 延长，max 取更久，ignore 忽略
  refresh-mode: extend
  # 是否显示剩余时间
  show-remaining: true
  # 描述文本，后续可用于悬浮提示或管理界面
  description:
    - "移动速度提升"

HUD 排版 ​

hud.direction 控制状态栏方向。

值效果
horizontal横排，优先按列从左到右显示
vertical竖排，优先按行从上到下显示

columns 和 rows 会决定最多显示多少个图标。容量按 columns * rows 计算。

图标间距通过 hud.icon.gap-x 和 hud.icon.gap-y 调整。默认图标尺寸由插件内部按 18x18 处理，龙核界面缩放在 YlesBuffHud.yml 里继续调整。

图标配置 ​

icons/default.yml 里的节点名就是图标 ID。

比如默认示例的图标 ID 是 speed，后台可以用 /ybh add 玩家 speed 给玩家添加这个图标。

配置项说明
display图标显示名
textureDragonCore 贴图路径
priority排序权重，数字越大越靠前
default-duration-ms默认持续时间，单位毫秒
description描述文本，可用于提示内容

数据库 ​

默认使用 SQLite，适合单服或测试。

如果需要跨服保存玩家 HUD 状态，把 use-datasource 改成 MySQL，再填写 datasource 下的数据库信息。

警告

切换 SQLite / MySQL 后建议重启服务器。不要在正式服运行中来回切换存储方式。

龙核 HUD ​

HUD 文件路径：plugins/DragonCore/Gui/YlesBuffHud.yml

这个文件负责图标显示、遮罩和倒计时文本。插件会向 DragonCore 下发 ylesbuffhud 相关变量，HUD 只负责渲染，不负责判断玩家是否真的拥有某个 Buff。