Skip to content

配置说明

LyLotteryReload 的配置由三部分组成:config.yml 控制全局设置,chest/ 存放宝箱,reward/ 存放奖池。

配置文件

文件 / 目录用途
config.yml数据库、消息、界面、全局抽奖设置
chest/*.yml宝箱配置
reward/*.yml奖池配置

数据库

MySQL 前置要求

只要启用 MySQL 存储,就必须先安装 LyMySQLCore,并确认它已成功连接数据库。LyMySQLCore 未加载或连接失败时,本插件的 MySQL 数据读取、保存、同步或相关记录不会生效。

yaml
mysql:
  enable: false
  databasename: mc2
  username: mc2
  password: mc1234
  port: 3306
  ip: 127.0.0.1

数据库用于保存玩家抽奖次数、稀有次数、抽奖记录和累计奖励领取状态。切换数据库开关后需要重启服务器。

条件物品分隔符

yaml
condition-item-key: "#"

抽奖条件中的物品写法默认为 item:{物品名#数量}。如果物品名里需要使用 #,可以通过 condition-item-key 修改分隔符。

龙核兼容

yaml
dragoncore-enable: true

开启后,抽奖完成会把展示物品发包到指定槽位,用于兼容龙核界面展示。

保存与点击冷却

yaml
auto-save-interval: 3
click-cooldown: 300
配置说明
auto-save-interval自动保存间隔,单位秒
click-cooldown点击抽奖冷却,单位毫秒

消息

message 下配置奖池为空、抽奖次数达到上限、背包空间不足、条件不足、触发稀有奖池、领取累计奖励等提示。

常用占位:

占位说明
{amount}数量或次数
{item}物品名称
{status}累计奖励状态

抽奖记录

yaml
lottery-log-format: "&7[{time}] &f{name}x{amount}"

用于格式化变量 %lycj_log_宝箱id% 显示的中奖记录。

累计奖励状态

yaml
reward-status-shortage: "&7不满足要求"
reward-status-clickable: "&a<可领取>"
reward-status-clicked: "&7<已领取>"

这些文本会替换累计奖励物品中的 {status}

默认示例配置

yaml
load-default-config: true

开启后会加载默认示例宝箱和示例奖池。正式服复制并改好自己的宝箱后,可以关闭它,避免示例配置继续参与加载。

全局中奖消息和稀有音效

yaml
global-player-message:
  - "&a恭喜你中奖了!"
rare-reward-sound: "ENTITY_PLAYER_LEVELUP"

奖品没有单独配置玩家消息时,会使用 global-player-message。抽中稀有奖池时,如果 rare-reward-sound 不为空,会播放对应 Bukkit 音效。

界面配置

gui 下配置标题、填充物品、单抽按钮、十连按钮、翻页按钮和按钮 lore。

按钮 lore 支持:

占位说明
{lottery_count}当前宝箱已抽次数
{rare_count}当前宝箱已抽中稀有次数
{need_condition}本次抽奖需要的条件说明