nb plugin install nonebot-plugin-werewolf

在 nonebot2 项目的插件目录下, 打开命令行, 根据你使用的包管理器, 输入相应的安装命令

uv add nonebot-plugin-werewolf

pdm add nonebot-plugin-werewolf

poetry add nonebot-plugin-werewolf

conda install nonebot-plugin-werewolf

pip install nonebot-plugin-werewolf

打开 nonebot2 项目根目录下的 pyproject.toml 文件, 在 [tool.nonebot] 部分追加写入

plugins = ["nonebot_plugin_werewolf"]

# 所有命令均需 at 触发
werewolf__require_at=true

# 所有命令均不需 at 触发
werewolf__require_at=false

# 狼人杀命令需要 at, 中止游戏命令不需要 at
werewolf__require_at='{"start": true, "terminate": false}'

众所周知， QQ 官方机器人对主动消息有次数限制 (参考)

因此，本插件可能无法在 adapter-qq 下正常运行

而对于野生机器人，现有协议端通常不支持或不建议使用临时私聊消息。

在使用本插件前，应当确保机器人可以正常向玩家发送私聊消息。即保证机器人与玩家为好友关系

• 命令: 狼人杀预设 职业 6 1 3 2

• 上述命令指定当总人数为 6 时，狼人、神职、平民的数量分别为 1、3、2

命令 狼人杀预设 狼人

• 命令: 狼人杀预设 狼人 狼 狼王 狼 狼

• 上述命令指定狼人的职业优先级为 狼人, 狼王, 狼人, 狼人

命令 狼人杀预设 神职

• 命令: 狼人杀预设 神职 预言家 女巫 猎人 守卫 白痴

• 上述命令指定神职的职业优先级为 预言家, 女巫, 猎人, 守卫, 白痴

• 截止 chronocat v0.2.19, 调用 guild.member.get / user.get 均无法获取用户名，这将导致在交互过程中的玩家名显示为用户 ID

• v1.1.6 添加的按钮操作在 discord 适配器中不可用, 已在 v1.1.12 禁用 (2e31d43)

• 2025.06.04 v1.1.13

  • 添加配置项 werewolf__use_cmd_start, 用于配置插件命令前缀
  • 调整 v1.1.11 优先级配置的默认值

• 2025.06.01 v1.1.12

  • 禁用 discord 适配器中的按钮操作 以后会写适配的...吗?

• 2025.04.20 v1.1.11

  • 添加配置项 werewolf__require_at, 用于配置命令是否需要 at 机器人触发
  • 添加配置项 werewolf__matcher_priority, 用于配置插件 matcher 注册优先级

• 2025.04.17 v1.1.10

  • 添加狼人多选目标配置项显示
  • 在游戏开始时打乱并固定轮流发言模式的发言顺序 (#20)

• 2025.04.15 v1.1.9

  • 添加游戏行为配置 werewolf_multi_select
  • 重构玩家类
  • 添加轮流发言模式缺失的 at 消息段 (#19)

• 2025.02.13 v1.1.8

  • 优化交互按钮
  • 新增命令 狼人杀配置 用于调整游戏行为
  • 新增配置项 werewolf__stop_command

• 2024.10.31 v1.1.7

  • Bug fix

• 2024.10.31 v1.1.6

  • 新增超级用户中止游戏 (#7)
  • 新增快速发起上次游戏 (#8)
  • 准备阶段添加可选的交互按钮
  • 新增超级用户修改游戏预设 (#9)

• 2024.10.23 v1.1.5

  • 添加对 chronocat:poke 的支持
  • 游戏内 stop 命令使用 COMMAND_START
  • 使用 anyio 重写并发逻辑

• 2024.10.06 v1.1.3

  • 使用 RF-Tar-Railt/nonebot-plugin-uninfo 获取用户数据
  • 优化交互文本

• 2024.09.18 v1.1.2

  • 修改 Python 需求为 >=3.10

• 2024.09.11 v1.1.1

  • 修改 Python 需求为 >=3.11
  • 优化交互结果处理 可以在一局游戏中加入多个女巫了

• 2024.09.09 v1.1.0

  • 新增职业 小丑
  • 修复守卫无法保护自己的 bug
  • 添加部分特殊职业的说明
  • 添加游戏过程中的日志输出

• 2024.09.04 v1.0.7

  • 优先使用群名片作为玩家名
  • 支持通过配置项修改职业分配优先级

• 2024.09.03 v1.0.6

  • 修复预言家查验狼王返回好人的 bug

• 2024.09.03 v1.0.5

  • 优化玩家交互体验
  • 添加游戏结束后死亡报告

• 2024.08.31 v1.0.1

  • 支持通过配置项修改职业预设

• 2024.08.31 v1.0.0

  • 插件开源