📝UI 配置
所有转盘配置位于 plugins/SpinToWin/ui/。指令中的 UI 名称就是文件名,不含 .yml;例如 example.yml 对应 example。
免费版只能加载 1 个转盘 UI,高级版没有此限制。

配置示例
以下示例与英文版 UI Config 的结构一致,使用 gui.title、gui.size、history-gui、auto-settings 等节点:
基础选项
gui.title
转盘 UI 标题,可包含资源包字体字符或变量
gui.size
转盘大小,取 9、18、27、36、45、54 之一
history-gui.title
已领取奖励界面的标题
history-gui.dynamic-size
是否根据已领取奖励数量调整历史界面的大小;关闭后使用 gui.size
slots
奖励展示槽位及指针前进顺序,不能使用第一行 0~8
reserve
true 允许重复抽取,false 表示本轮已领取奖励不再参与抽奖
replace
reserve: false 时用于替换已领取奖励的物品;不配置则移除已领取奖励
frame
外框名称,来自 config.yml 的外框映射
show-rate
是否给奖励物品添加显示抽中概率的 Lore
默认 UI 有 14 个展示槽位,但奖励数量可以超过槽位数量。超过后自动启用待机慢速轮转和抽奖时的反向旋转、同步减速,详见奖励轮转与抽奖动画。
替代物品仍占据展示列表位置并参与轮转。不配置 replace 时,已领取奖励从列表移除,剩余展示数量不超过槽位数量后停止奖励轮转。
自动关闭与重置
auto-settings.empty-amount
判定奖池即将抽空时使用的剩余奖励数量;示例为 1
auto-settings.reset-timer-after-first-spin
第一次抽奖后自动重置的计时,-1 为禁用;当前实现按秒读取,再转换为 tick
auto-settings.reset-when-empty
奖池抽空时是否重置玩家数据
auto-settings.close-when-empty
奖池抽空时是否关闭 UI
auto-settings.close-when-price-not-meet
玩家无法满足后续抽奖价格时是否关闭 UI;请核对所用版本实际支持的键名
次数限制
limits:转盘的抽奖次数上限,需要在config.yml启用check-permission-limit。limits.default:默认次数上限。limits.<条件ID>:满足对应条件时采用的次数上限。limits-conditions.<条件ID>:对应的条件格式配置。
此例中,拥有 test.permission 权限的玩家上限为 20 次,其他玩家为 10 次。条件语法见配置格式。
按钮、奖励与价格
buttons:按钮配置。buttons.<按钮ID>.icons引用config.yml中登记的图标名称。last-reward:最后赏的物品配置,兼容旧名last_reward。物品与动作格式见奖励配置。last-reward-slot:最后赏展示槽位。last-reward-times:触发最后赏的抽奖次数,兼容旧名last_reward_times。不设置时,取初始奖励数量与展示槽位数量中的较大值;20 个奖励、14 个槽位时默认第 20 抽触发。最后赏本身及槽位也需要配置。rewards:普通奖励列表,见奖励配置。prices:抽奖价格列表,见价格配置。
奖励和价格 ID 均从 1 开始连续递增,不要跳号。
自定义按钮
可以在 buttons 下增加按钮,并通过 actions 设置点击后的动作:
上例增加了 test 按钮。对应图标也需要在 config.yml 登记,例如:
icons:图标名称列表。slots:按钮所在槽位,不得使用第一行0~8,且必须小于gui.size。actions:点击后执行的动作,使用动作格式。
Last updated