🎉 抽奖系统
描述
用户指南
发起抽奖、管理多个奖品、要求角色/积分、重新抽奖获奖者并显示参与者——轻松无压力。
🔎 功能介绍
- 创建单个或多个奖品的抽奖。
- 持久的参与按钮（计数器更新）。
- 参与条件：要求的角色、积分（可选）。
- 几率权重：角色累积 + 加成角色。
- 自动结束 ⏱️、抽取获奖者 🏆、轻松重新抽奖。
🚀 快速开始
- 发起简单抽奖（单个奖品）：
/giveaway duration:1h winners:1 role_1:@成员 cumul_roles:否 plusieurs_items:否 gain_multiple:否 - 或多奖品抽奖：机器人会要求奖品列表（每行一个）。
- （可选）要求/消耗积分：
required_points:100•consume_points:是
🧩 重要选项
| 选项 | 描述 |
|---|---|
duration | 例如 10m、2h、3d1h10m。 |
winners | 每个奖品的获奖者数量。 |
role_1 | 必需角色。role_2 可选。 |
cumul_roles | 累加 role_1 + role_2 以获得更高几率。 |
bonus_roles | 提供几率加成的角色。 |
plusieurs_items | 启用多奖品（机器人会要求列表）。 |
gain_multiple | 同一人可以赢得多个奖品吗？ |
required_points | 要求积分才能参与。 |
consume_points | 参与时扣除积分。 |
message_id | 重用现有embed（自动添加"⏰ 结束"部分）。 |
🧰 快速管理（管理员）
| 命令 | 描述 |
|---|---|
/giveaway | 创建（单个或多个奖品）。 |
/giveaway_lister | 查看活动抽奖。 |
/giveaway_participants | 按奖品列出参与者。 |
/giveaway_terminer | 立即结束并抽奖。 |
/giveaway_annuler | 取消不抽奖。 |
/giveaway_relancer | 延长/修改持续时间。 |
/giveaway_reroll | 重新抽奖（一个或多个奖品）。 |
👥 成员参与
- 点击🎉 参与按钮或想要的奖品按钮。
- 如果您已注册，小菜单会提供取消注册（如适用则退还积分💸）。
📊 参与者 (N)标签自动更新。
🛟 故障排除
- 🚫 无法参与：缺少要求的角色，或积分不足。
- 🧮 计数器卡住：等待1-2秒，写入数据库后更新。
- 🎛️ 多奖品：每个奖品有自己的按钮和自己的参与者列表。
- 🔁 重新抽奖：如果禁用"多次获奖"，获奖者不能赢两个奖品。
❓ 常见问题
常见问题
可以重用已发布的embed吗？
可以：提供 message_id 和（可选）channel。机器人添加 ⏰ 结束 行。
取消注册会退还积分吗？ 是的，如果"消耗积分"选项已激活，取消注册时自动退还。
如何写持续时间？
连接单位：3d1h10m（天/小时/分钟）。