> 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/zhuan-pan-ui/cai-zhi.md).

# 🖼️材质

## 添加按钮图标

1. 将新图标 PNG 放入 `plugins/SpinToWin/texture/icon/`。
2. 执行 `/s2w reload`。
3. 如需指定模型编号，在 `config.yml` 的 `icon` 中按 `文件名: Custom Model Data` 设置。
4. 在 UI 配置的 `buttons.<按钮ID>.icons` 中填写图标文件名，不含扩展名。
5. 再次重载插件，并重新生成、加载或发送资源包。

## 添加转盘外框

将外框 PNG 放入 `plugins/SpinToWin/texture/frame/`，其余步骤与图标相同。UI 使用 `frame` 指定外框名称。

源材质目录使用单数 `icon` 和 `frame`，与当前插件的目录一致。

## 重新生成资源包

* 新增外框或图标后，执行 `/s2w reload`。
* 修改已有外框或图标后，先从 `config.yml` 中移除对应的已生成 `icon` / `frame` 映射，再重载插件。
* 移除映射前保留备份，并核对重新生成的 Custom Model Data 是否与其他资源包冲突。

映射结构示例：

```yaml
icon:
  history_3: 70000
  expansion_history_3: 70001
  expansion_history_2: 70002
  expansion_history_1: 70003
  spin_1: 70004
  expansion_spin_3: 70005
  spin_2: 70006
  expansion_spin_2: 70007
  history_2: 70008
  spin_3: 70009
  expansion_spin_1: 70010
  history_1: 70011
frame:
  expansion_frame_3: 70012
  expansion_frame_2: 70013
  frame_1: 70014
  expansion_frame_4: 70015
  frame_4: 70016
  expansion_frame_1: 70017
  frame_2: 70018
  frame_3: 70019

```

## ItemsAdder 示例包

{% file src="/files/qmi9wgu6IuX6ILxn97r1" %}

## 拓展包 1

<div><figure><img src="https://content.gitbook.com/content/lZa8qg7GyuZPlsNnz1EO/blobs/IUox3PA0uVRcDepWviW0/yellow.gif" alt="黄色转盘"><figcaption></figcaption></figure> <figure><img src="https://content.gitbook.com/content/lZa8qg7GyuZPlsNnz1EO/blobs/ac9HmQrd8RuGruzMazAS/blue.gif" alt="蓝色转盘"><figcaption></figcaption></figure> <figure><img src="https://content.gitbook.com/content/lZa8qg7GyuZPlsNnz1EO/blobs/8pwby81tjD3FrcdhiIos/red.gif" alt="红色转盘"><figcaption></figcaption></figure> <figure><img src="https://content.gitbook.com/content/lZa8qg7GyuZPlsNnz1EO/blobs/5vdnEJ67DpGUb5It47ir/green.gif" alt="绿色转盘"><figcaption></figcaption></figure></div>

{% embed url="<https://polymart.org/resource/spintowin-expansion-pack-1.4426/>" %}

已购买 SpinToWin 高级版的用户，也可通过英文文档提供的 [Discord](https://discord.gg/KA5A4JMzYc) 支持渠道获取此拓展包的免费下载。

资源包安装见[安装](https://spintowin.superiormc.cn/jian-ti-zhong-wen-2/ji-ben-xin-xi/an-zhuang.md)，与其他插件合并见[自动复制资源包](https://spintowin.superiormc.cn/jian-ti-zhong-wen-2/gong-neng/auto-copy-resource-pack.md)。
