配置说明

修改 config.yml、datasource.yml 或 message.yml 后，可以使用 /ybd reload 重载。

配置文件

文件 / 目录	用途
config.yml	基础设置
datasource.yml	SQLite 数据存储
message.yml	消息文本

配置示例

config.yml

# 是否开启调试模式
# 说明：调试模式会打印较多内部信息，仅在开发或排查 bug 时建议开启。
debug: false

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

datasource.yml

# 数据源类型：仅支持 SQLite
use-datasource: "SQLite"

sqlite:
  # 数据库文件名（保存在插件数据目录下）
  file: "database.db"

hikari:
  # 连接超时（毫秒）
  connection-timeout: 30000
  # 空闲超时（毫秒）
  idle-timeout: 600000
  # 最大生命周期（毫秒）
  max-lifetime: 1800000
  # 最小空闲连接数
  minimum-idle: 1
  # 最大连接池大小
  maximum-pool-size: 4
  # 连接测试语句
  connection-test-query: "SELECT 1"

message.yml

MESSAGE:
  RELOAD: '配置文件重载完成'
COMMAND:
  RELOAD: '重载插件的配置文件'
ADMIN:
  NO_PERMISSION_CMD: '你没有权限执行此指令'
  NO_CMD: '未找到此子指令'
  NO_FORMAT: '格式错误'
  NO_ONLINE: '玩家不在线或玩家不存在'
  PLUGIN_RELOAD: '插件已重载'
ERROR:
  USAGE_COMMAND: '未找到此子指令'

调试模式

debug: true 会在后台输出方块放置、跳过记录、破坏返还等调试信息。

正式服建议保持 false，只在排查 NBT 识别问题时临时开启。

数据库

当前只支持 SQLite，默认数据库文件为根目录下的 database.db。

插件会把已记录方块的世界、坐标、物品 NBT 和方块状态写入数据库。服务器重启后，会重新载入这些记录。