# koishi-plugin-wheel-fortune

[![npm](https://img.shields.io/npm/v/koishi-plugin-wheel-fortune)](https://www.npmjs.com/package/koishi-plugin-wheel-fortune)
[![LICENSE](https://img.shields.io/npm/l/koishi-plugin-wheel-fortune)](https://github.com/WhiteBr1ck/koishi-plugin-wheel-fortune/blob/main/LICENSE)

一个灵活可配置的转盘/轮盘抽奖 Koishi 插件。

## ✨ 功能特性

*   **高度可配置**: 支持创建任意数量的自定义转盘，每个转盘的指令、名称和选项均可独立配置。

## 📥 安装

```bash
# 在你的 Koishi 项目根目录下执行
npm install koishi-plugin-wheel-fortune
```

或者，直接在 Koishi 的插件市场搜索 `wheel-fortune` 并安装。

**依赖项**

本插件依赖 [koishi-plugin-puppeteer](https://koishi.chat/plugins/service/puppeteer.html) 服务。请确保你的项目中已安装并启用了该插件。

## 📖 使用

启用插件后，即可通过在配置项中定义的指令来使用转盘。

例如，使用默认配置，你可以发送：

*   `吃饭转盘`
*   `周末转盘`

机器人将会回复一个旋转中的 GIF，并在几秒后发送最终的结果图片和文字。

## ⚙️ 配置项

本插件提供以下配置项：

*   **`turntables`**: 自定义转盘列表。
    *   **`name`**: 转盘的名称，用于在后台辨认。
    *   **`command`**: 触发此转盘的指令（无需包含前缀 `/`）。
    *   **`options`**: 转盘的选项列表，一个字符串数组。
*   **`spinningGifUrl`**: “转盘正在旋转时”所显示的 GIF 图片的网络地址。
*   **`delay`**: 从发送旋转动画到揭晓结果的延迟时间（单位：秒）。

## 📝 免责声明

1.  本插件仅供娱乐，其生成的抽奖结果是完全随机的，不应作为任何重要决策的依据。
2.  对于使用本插件所做出的任何选择及其可能导致的任何后果，插件作者概不负责。
3.  请勿将本插件用于任何形式的赌博或其他非法活动。

## ©️ 许可证

本项目使用 [MIT](https://github.com/WhiteBr1ck/koishi-plugin-wheel-fortune/blob/main/LICENSE) 许可证。

© 2025, WhiteBr1ck.