breedocker/raidquaza

*** Poll Bot Raidquaza

镜像概述和主要用途

Raidquaza是一个专为设计的投票机器人，允许用户在服务器中创建和管理投票。通过简单的命令，用户可以快速生成带反应的投票，支持两种投票模式，并可自定义命令前缀以适应不同服务器需求。

!raidquaza_example

核心功能和特性

• 两种投票模式：
  • 标准投票：支持最多17个选项，自动添加数字反应
  • 简单投票：支持最多21个选项，不添加数字反应
• 自定义命令前缀：默认使用机器人用户名作为前缀，可通过命令修改为自定义前缀（如!）
• 实用工具命令：提供帮助、 ping、运行时间查询等功能
• 数据库集成：支持SQLAlchemy兼容的数据库存储投票数据
• 可配置性：通过环境变量或配置文件自定义机器人参数

使用场景和适用范围

• ***社区决策投票
• 活动选项征集
• 意见调查和偏好收集
• 团队或公会内部投票决策

详细使用方法和配置说明

命令说明

命令由前缀和别名组成，默认前缀为机器人用户名（格式：@bot_user_name#1337）。可通过@bot_user_name#1337 set_prefix <新前缀>修改前缀（如!）。

工具类命令

• @bot_user_name#1337 help：显示帮助信息
• @bot_user_name#1337 ping：测试机器人响应
• @bot_user_name#1337 uptime：查看机器人运行时间

投票类命令

• @bot_user_name#1337 poll <标题> <选项1> .. <选项17>：创建带数字反应的标准投票（最多17个选项）
• @bot_user_name#1337 simplepoll <标题> <选项1> .. <选项21>：创建无数字反应的简单投票（最多21个选项）

部署要求

• Python 3.8+（非Docker部署）
• 机器人账户（需在开发者平台创建）
• 数据库（支持SQLAlchemy的数据库，如MySQL、PostgreSQL等）
• ***服务器需添加指定表情：从/poll/emojis/目录添加表情，名称需为rq_plus_one、rq_plus_two、rq_plus_three、rq_plus_four

Docker部署示例

docker-compose配置

yaml
version: '2.4'
services:
  raidquaza:
    image: breedocker/raidquaza
    entrypoint: ["/entrypoint.sh"]
    environment:
      - "BOT_TOKEN=你的机器人令牌"  # Discord机器人令牌
      - "BOT_PREFIX=!"             # 自定义命令前缀
      - "POLL_DB_HOST=poll-db"     # 数据库主机
      - "POLL_DB_PORT=3306"        # 数据库端口
      - "POLL_DB_NAME=polldb"      # 数据库名称
      - "POLL_DB_USER=pollman"     # 数据库用户名
      - "POLL_DB_PASSWORD=bestpw"  # 数据库密码
      - "POLL_DB_DIALECT=mysql"    # 数据库方言（如mysql、postgresql）
      - "POLL_DB_DRIVER=mysqlconnector"  # 数据库驱动
    volumes:
      - ./raidquaza/:/usr/src/app/  # 本地代码挂载（可选）
    restart: always
    depends_on:
      - poll-db
    networks:
      - default

  poll-db:
    image: mariadb
    environment:
      - "MYSQL_ROOT_PASSWORD=root1234"  # 数据库root密码
      - "MYSQL_DATABASE=polldb"         # 数据库名称（需与raidquaza配置一致）
      - "MYSQL_USER=pollman"            # 数据库用户名（需与raidquaza配置一致）
      - "MYSQL_PASSWORD=bestpw"         # 数据库密码（需与raidquaza配置一致）
    command: ['mysqld', '--character-set-server=utf8mb4', '--collation-server=utf8mb4_unicode_ci']
    volumes:
      - ./volumes/mysql/db:/var/lib/mysql  # 数据库数据持久化
    restart: always
    networks:
      - default

部署步骤

1. 保存上述配置为docker-compose.yml
2. 替换环境变量中的占位符（如BOT_TOKEN）
3. 启动数据库：docker-compose up -d poll-db
4. 启动机器人：docker-compose up -d raidquaza

环境变量说明

相关链接

• Docker镜像：[***]
• 服务器：[]
• 添加机器人到服务器：[***]