> 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/ji-ben-xin-xi/an-zhuang.md).

# ⚙️安装

## 安装插件

1. 停止服务器，将插件 JAR 放入服务端的 `plugins` 文件夹。
2. 更新插件时，移除旧版 JAR，避免同时存在多个版本。
3. 启动服务器。不要通过热加载工具加载插件。
4. 为客户端安装生成的资源包，或使用 ItemsAdder、Oraxen 等插件发送资源包。

插件会在 `plugins/SpinToWin/pack/` 生成资源包。**SpinToWin 本身不会向玩家发送资源包。**

从较新的游戏版本降级到旧版时，需要处理插件数据目录中原有的 `items` 和 `pack` 目录，避免沿用不兼容的数据。使用[本地化物品名称](https://spintowin.superiormc.cn/jian-ti-zhong-wen-2/gong-neng/localized-item-name.md)时，切换游戏版本后也需要删除旧的本地化 JSON 文件并重新生成。操作前请保留数据备份。

## 安装资源包

### 没有使用其他资源包插件

1. 将插件生成的 `pack` 文件夹内容打包为 ZIP，确保 `pack.mcmeta` 位于压缩包根目录。
2. 打开 Minecraft，在主菜单进入「选项」→「资源包」。
3. 将 ZIP 拖入资源包窗口，选择并启用它。
4. 进入服务器，检查转盘外框和图标是否正常显示。

### 使用 ItemsAdder、Oraxen 等插件

在 `config.yml` 中启用 `auto-copy-resourcepack.enabled`，并设置对应的插件名和目标路径，详见[自动复制资源包](https://spintowin.superiormc.cn/jian-ti-zhong-wen-2/gong-neng/auto-copy-resource-pack.md)。

插件使用 `BLACK_DYE` 承载外框和图标材质。如果其他资源包也修改了该物品，需要检查模型及 Custom Model Data 是否冲突，不能直接覆盖对方文件。英文版文档提供了[资源包合并工具](https://merge.elmakers.com/)作为参考；也可以通过支持渠道寻求帮助。

合并后，通过资源包插件向玩家发送最终资源包。自定义材质和重新生成资源包的步骤见[材质](https://spintowin.superiormc.cn/jian-ti-zhong-wen-2/zhuan-pan-ui/cai-zhi.md)。

## 更新后重载

修改配置后可执行 `/s2w reload`。替换插件 JAR 后必须重启服务器，配置重载不会加载新的 Java 代码。
