Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

📝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