动画、全息、音效与播报

动画方向与显示类型

/lb setanimation <上下|左右>
/lb setmode <wool|item>

• 上下 与 左右 控制当前箱子的动画方向。
• wool 使用稀有度羊毛颜色表现滚动结果。
• item 使用奖品物品表现滚动结果。
• setmode 只控制视觉显示类型，不是 DIRECT/KEY 抽奖模式；后者使用 /lb setdrawmode。

两种抽奖流程共用 36 格 animation-gui。默认标题为“抽奖机”，状态格显示“正在抽奖…”。关闭界面不会取消已经提交的结算，也不会重新随机。

时间参数

键	默认值	说明
animation.duration-ticks	60	总时长，按 20 TPS 约三秒
animation.interval-ticks	2	刷新间隔，按 20 TPS 约 0.1 秒

服务器掉 TPS 时实际墙钟时间会变长。不要把间隔设成零；在 Folia 上 Entity/Region 跨上下文调度至少延迟一 tick。

箱顶全息

全息使用服务端 TextDisplay，不依赖第三方全息插件。主要设置：

键	默认值	作用
hologram.enabled	true	总开关
hologram.y-offset	1.4	相对箱子的 Y 偏移
hologram.view-range	32.0	可视距离
hologram.see-through	false	是否隔方块可见
hologram.background-argb	1073741824	TextDisplay 背景 ARGB
hologram.default-title	&6&l✦ 抽奖箱 ✦	未设置箱名时的标题
hologram.direct-line	左键预览、右键付费抽奖	DIRECT 提示
hologram.key-line	左键预览、右键购买/使用钥匙	KEY 提示
hologram.cost-line	左键预览、右键付费抽奖	旧配置兼容项

执行 /lb name <text...|clear> 修改箱名，/lb reload 会按新配置重建全部箱顶全息。cost-line 只为旧配置读取保留，当前模式提示优先用 direct-line 或 key-line。

音效

sound.enabled 是总开关。默认三组声音均由 key、volume 和 pitch 组成：

阶段	默认声音	音量	音调
sound.start	UI_BUTTON_CLICK	1.0	1.0
sound.spin	BLOCK_NOTE_BLOCK_HAT	0.5	1.5
sound.win	UI_TOAST_CHALLENGE_COMPLETE	1.0	1.0

声音键必须是目标服务端支持的 Bukkit Sound 名称。升级核心后先在测试服验证。

全服播报

键	默认	说明
broadcast.enabled	true	总开关
broadcast.use-prefix	true	是否拼接 broadcast.prefix
broadcast.prefix	&6[抽奖系统]	前缀
broadcast.only-epic	true	只播报 EPIC
broadcast.format	当前中奖文案	主体格式

格式支持 {player}、{prize}、{rarity}、{prize_count}、{category}。在 Folia 路径中，全服播报通过全局调度上下文执行。