config.yml
plugins/StarCrate/config.yml 是插件的全局设定，第一次启动时自动生成，注释都是中文。
修改后怎么生效
| 设定 | 生效方式 |
|---|---|
database.*、sync.server-id、sync.interval-seconds、history-keep-days、menu.cloudui | 重启服务器 |
broadcast.cross-server 从 false 改成 true | 重启服务器（开服时才会开始接收其他子服的公告） |
| 其他全部 | /sc reload |
升级后新版本新增的设定如果你的文件里没有，会直接使用默认值；想调整就自己把键加进去。
奖励发放（delivery）
delivery:
use-starmail: true
mail-commands: claim
mail-sender: '<gradient:#FFD86F:#FC6262>星月造物</gradient>'
mail-title: '{crate} <gray>· {count} 件奖励'
mail-expire-days: 0
overflow: stash
| 键 | 类型 | 默认 | 作用 |
|---|---|---|---|
use-starmail | true / false | true | true = 安装了 StarMail 星月邮箱 时奖励寄到邮箱；false = 一律直接放进背包 |
mail-commands | claim / now | claim | 奖品的指令奖励：claim = 玩家领取邮件时才执行；now = 发放时立刻执行 |
mail-sender | 文字 | 见上 | 奖励邮件的寄件人名称 |
mail-title | 文字 | 见上 | 奖励邮件标题，{crate} = 奖池名称，{count} = 奖品数量 |
mail-expire-days | 数字 | 0 | 奖励邮件几天后过期，0 = 永不过期 |
overflow | stash / drop | stash | 直接放进背包时背包满了：stash = 暂存，玩家用 /sc stash 领取；drop = 掉在脚下 |
邮件正文在 messages.yml 的 mail.content。详见 奖励发放。
动画（animation）
animation:
enabled: true
speed: 1.0
allow-skip: true
close-skips: true
result-hold-ticks: 50
results-menu: true
| 键 | 类型 | 默认 | 作用 |
|---|---|---|---|
enabled | true / false | true | false = 所有奖池都不播放动画，直接显示结果 |
speed | 数字 | 1.0 | 动画速度倍率（0.25 ～ 4），2 = 两倍速，0.5 = 慢一倍 |
allow-skip | true / false | true | 允许跳过：箱子动画点「跳过」，3D 动画按潜行 |
close-skips | true / false | true | 关掉箱子动画界面 = 直接跳到结果；false = 关不掉，会重新打开 |
result-hold-ticks | 整数（tick） | 50 | 动画结束后停留多久再发放奖励、显示结果界面（20 tick = 1 秒；3D 动画至少 20） |
results-menu | true / false | true | 动画后打开「抽奖结果」界面（有再抽一次、再来十连按钮）；false = 动画结束直接关闭 |
每种动画自己的参数在 animations.yml，见 抽奖动画。
公告（broadcast）
| 键 | 类型 | 默认 | 作用 |
|---|---|---|---|
broadcast.enabled | true / false | true | false = 所有奖池都不公告 |
broadcast.cross-server | true / false | true | 使用 MySQL 时，把会公告的奖品同步公告到其他子服 |
公告规则见 奖励发放 · 全服公告，文字在 messages.yml 的 broadcast.*。
默认值（defaults）
| 键 | 类型 | 默认 | 作用 |
|---|---|---|---|
defaults.ten-guarantee | 稀有度 ID | '' | 奖池没有设定十连保底（pity.ten-guarantee 空白）时使用的十连保底稀有度。'' = 不保底。例如写 rare，所有没设定的奖池十连都至少一个稀有以上 |
抽奖方块（block）
block:
left-click-preview: true
shift-right-quick-draw: false
protect: true
hologram:
title: '<bold>{crate}</bold>'
height: 1.0
show-item: true
cycle-seconds: 3
| 键 | 类型 | 默认 | 作用 |
|---|---|---|---|
left-click-preview | true / false | true | 左键抽奖方块也打开预览 |
shift-right-quick-draw | true / false | false | 潜行右键抽奖方块直接单抽（不打开预览） |
protect | true / false | true | 禁止破坏抽奖方块（用 /sc removeblock 解除后才能破坏）。爆炸一律不会炸掉抽奖方块 |
hologram.title | 文字 | <bold>{crate}</bold> | 方块上方的标题，{crate} = 奖池名称；下面的说明行在 messages.yml 的 hologram.lines |
hologram.height | 数字（格） | 1.0 | 标题离方块顶部的高度 |
hologram.show-item | true / false | true | 标题下方展示旋转的奖品 |
hologram.cycle-seconds | 整数（秒） | 3 | 每隔几秒换下一个奖品（最少 1） |
每个奖池要不要显示全息、用哪种粒子，在奖池自己的设定里。见 抽奖方块。
宝箱物品（crate-item）
宝箱物品的默认材质、名称、发光与说明格式（奖励一览）。每个键的说明见 宝箱物品与钥匙 · config.yml 的 crate-item。
数据库（database）
database:
type: sqlite
file: data.db
host: 127.0.0.1
port: 3306
database: starcrate
username: root
password: ''
parameters: 'useSSL=false&allowPublicKeyRetrieval=true&characterEncoding=utf8'
table-prefix: 'sc_'
pool-size: 6
| 键 | 类型 | 默认 | 作用 |
|---|---|---|---|
type | sqlite / mysql / mariadb | sqlite | sqlite = 单服，数据存在插件文件夹的文件里；mysql（或 mariadb）= 多个子服共用，保底次数、抽奖记录、每日次数等都跨服共享 |
file | 文件名 | data.db | SQLite 数据库文件（在 plugins/StarCrate/ 里） |
host | 文字 | 127.0.0.1 | MySQL 地址 |
port | 整数 | 3306 | MySQL 端口 |
database | 文字 | starcrate | 数据库名称（需要先自己建立） |
username / password | 文字 | root / '' | MySQL 帐号密码 |
parameters | 文字 | 见上 | 接在连线网址后面的参数 |
table-prefix | 文字 | sc_ | 数据表名称前缀，只能用字母、数字与下划线（最多 32 个字）。同一个数据库给多组互不相干的服务器用时，可以用不同前缀分开 |
pool-size | 整数 | 6 | MySQL 连线池大小（最少 2）。SQLite 固定使用 1 条连线 |
插件启动时会自动建立需要的数据表。数据库连不上时插件会停用并在控制台写出原因（例如「数据库连接失败，插件已停用：…」）。 MySQL 设定步骤见 跨服。
跨服（sync）
sync:
server-id: ''
server-names:
s1: '生存服'
interval-seconds: 2
| 键 | 类型 | 默认 | 作用 |
|---|---|---|---|
server-id | 文字 | '' | 这个子服的 ID，用在跨服公告上。留空时每次开服自动产生（端口 + 随机字符），跨服时请每个子服设一个固定且不重复的 ID |
server-names | 子服 ID: 名称 | s1: 生存服 | 跨服公告前面显示的子服名称。没有对应名称时直接显示子服 ID |
interval-seconds | 整数（秒） | 2 | 每隔几秒检查一次其他子服的公告（最少 1） |
只有 database.type 是 MySQL 时有作用。见 跨服。
其他
| 键 | 类型 | 默认 | 作用 |
|---|---|---|---|
history-keep-days | 整数（天） | 180 | 抽奖记录保留几天，超过的每 6 小时清理一次；0 = 永久保留。影响 /sc history、/sc stats、/sc top；保底次数与每人上限的计数不受影响 |
command-aliases | 列表 | [sc] | 这些指令一律交给星月造物处理（CMI 等插件也有 /sc，会抢走指令），清空 [] 则不处理。见 安装 · /sc 被其他插件抢走了？ |
menu.cloudui | true / false | true | 安装了云界面 CloudUI 时，奖池预览使用云界面画面（自选奖池与无法显示云界面的玩家仍用箱子菜单）。重启生效。见 云界面预览 |
menu.default-crate | 奖池 ID | 空 | 玩家只打 /sc 时打开哪个奖池；留空 = 第一个奖池。装了云界面就是云界面抽奖画面，没装是箱子预览。/sc reload 生效 |
menu.draw-sound / menu.reveal-sound | 音效 | cloudui:draw_star / cloudui:draw_end | 云界面抽奖动画开始时、卡牌翻开时的音效（留空 = 不播放；可写 声音 音量 音调） |
menu.flip-sound | 音效 | minecraft:item.book.page_turn 1 1.3 | 命运翻牌（cui-flip）每翻开一张的音效 |
menu.wheel-sound | 音效 | minecraft:block.note_block.hat 0.6 1.8 | 星轮转盘（cui-wheel）光点每走一格的音效 |
menu.date-format | 日期格式 | MM-dd HH:mm | 抽奖记录界面的时间格式，例如 yyyy-MM-dd HH:mm。写错时使用默认格式 |
menu.click-cooldown-ms | 整数（毫秒） | 250 | 连点保护：两次点击界面按钮之间、两次点抽奖方块 / 右键宝箱物品之间至少间隔多久 |