koishi-plugin-wheel-fortune
Version:
一个灵活可配置的转盘/轮盘抽奖 Koishi 插件。
57 lines (35 loc) • 2.16 kB
Markdown
# koishi-plugin-wheel-fortune
[](https://www.npmjs.com/package/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.