> For the complete documentation index, see [llms.txt](https://spintowin.superiormc.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://spintowin.superiormc.cn/jian-ti-zhong-wen-2/configs/ui-pei-zhi.md).

# UI 配置

你可以在 `/plugins/SpinToWin/ui` 找到所有的UI配置。插件中用到的 uiName 参数就是文件的名称，例如 `ui.yml` 文件的 \<uiName> 参数就是 `example`。

**免费版只能加载 1 个UI，购买付费版以无视此限制。**

<figure><img src="/files/X2aaRsmX023Auouykgbn" alt=""><figcaption></figcaption></figure>

下面是一个示例文件：

```
gui: ":offset_-8::s2w_ui:"
inventory_size: 45
history_gui: ""
history_inventory_size_dynamic: true
slots: [9,10,11,12,13,22,31,40,39,38,37,36,27,18]
reserve: false
replace:
  material: gray_stained_glass_pane
  amount: 1
  display: "&3Acquired"
frame: frame
show_rate: true
auto_reset_when_empty: true
auto_close_when_empty: true
auto_close_when_price_not_meet: false
limits:
  default: 100
  vip: 200
limits-conditions:
  vip:
    - 'permission: group.vip'
buttons:
  spin:
    icons: [spin_1,spin_2,spin_3]
    slots: [33,34,35]
    display: "&aSpin!"
    lore:
      - "&fYou should cost %price%"
      - "&f"
      - "%click%"
  history:
    icons: [history_1,history_2,history_3]
    slots: [42,43,44]
    display: "History"
    lore:
      - "&fCheck the rewards you have drawn."
last_reward:
  material: DIAMOND_SWORD
  amount: 1
last_reward_slot: 16
rewards:
  1:
    material: DIAMOND
    cmd: 0
    display: '&eA赏'
    lore:
      - '&fLine1'
      - '&fLine2'
    commands:
      - 'help'
  2:
    material: IRON_INGOT
    amount: 10
    chance: 20
  3:
    material: GOLD_INGOT
    amount: 5
    chance: 10
  4:
    material: APPLE
    amount: 64
    chance: 10
  5:
    material: DIAMOND
    amount: 2
    chance: 5
  6:
    material: IRON_INGOT
    amount: 10
    chance: 20
  7:
    material: GOLD_INGOT
    amount: 5
    chance: 10
  8:
    material: APPLE
    amount: 64
    chance: 10
  9:
    material: DIAMOND
    amount: 2
    chance: 5
  10:
    material: IRON_INGOT
    amount: 10
    chance: 20
  11:
    material: GOLD_INGOT
    amount: 5
    chance: 10
  12:
    material: APPLE
    amount: 64
    chance: 10
  13:
    material: DIAMOND
    amount: 2
    chance: 5
  14:
    material: IRON_INGOT
    amount: 10
    chance: 20
prices:
  1:
    hook-plugin: EcoItems
    hook-item: test
    amount: 15
    placeholder: 'test x15'
  2:
    material: STONE
    amount: 10
    placeholder: 'STONE x10'
  3:
    economy-plugin: Vault
    amount: 10.0
    placeholder: '$10'
  4:
    vanilla-type: levels
    amount: 5
    placeholder: '5 L'
  5:
    economy-type: levels
    amount: 5
    placeholder: '5 L'
  6:
    economy-type: levels
    amount: 5
    placeholder: '5 L'
  7:
    economy-type: levels
    amount: 5
    placeholder: '5 L'
  8:
    economy-type: levels
    amount: 5
    placeholder: '5 L'
  9:
    economy-type: levels
    amount: 5
    placeholder: '5 L'
  10:
    economy-type: levels
    amount: 5
    placeholder: '5 L'
  11:
    economy-type: levels
    amount: 5
    placeholder: '5 L'
  12:
    economy-type: levels
    amount: 5
    placeholder: '5 L'
  13:
    economy-type: levels
    amount: 5
    placeholder: '5 L'
  14:
    economy-type: levels
    amount: 5
    placeholder: '5 L'
```

* gui: 转盘UI的标题。
* inventory\_size: 转盘UI的大小，必须是 `9, 18, 27, 36, 45, 54` 其中之一数字。
* history\_gui: 历史奖励UI的标题。
* history\_inventory\_size\_dynamic: 历史奖励UI的标题是否会跟随已领取奖励数量动态变化，例如 9 个奖励就一行大小，17个奖励就两行大小，如果是否，那么历史奖励UI的大小会和 `inventory_size` 一样。
* slots: 奖励物品所在格数。**不能在第一行！**
* reserve: 奖励抽中以后是继续保留还是这次不再能获取到了。
* auto\_reset\_when\_empty: 当所有奖励全部抽完以后是否重置奖励。
* auto\_close\_when\_empty: 当所有奖励全部抽完以后是否自动关闭UI。
* auto\_close\_when\_price\_not\_meet: 当玩家不能满足下次抽奖的价格时，是否自动关闭UI。
* replace: 玩家已抽到奖励且上面 reserve 选项开启情况下，该奖励对应位置替换的物品。
* frame: 外壳名称，见 `config.yml`。
* show\_rate: 是否在每个奖励物品下面添加一行，显示物品抽中几率。
* limits: 设置该UI最多抽奖次数。**你必须开启 config.yml 文件中的 check-permission-limit 选项才能使用这个功能。**
* limits.default: 如果玩家不能满足所有的条件，就会使用这个值作为抽奖次数上限。
* limits.<条件id>: 满足这个条件的玩家就会使用该选项的值作为抽奖次数上限。

```
limits:
  default: 10
  vip: 20
limits-conditions:
  vip: 
    - 'permission: test.permission'
```

条件id在 limits-conditions 选项中设置，格式如上。在这个示例中，满足 test.permission 权限节点的玩家将会有 20 次抽奖机会。

* button:  按钮物品。
* button.icons: 按钮名称，见 `config.yml`。
* last\_reward: 当所有奖励全部抽中以后，将会获得该奖励，如果不需要这个功能，可以删掉这个选项。
* last\_reward\_slot: 最终奖励的格子。
* rewards: 奖励配置。
* prices: 价格配置。