Skip to main content

适用于 Nonebot2 的狼人杀插件

Project description

nonebot-plugin-werewolf

✨ 简单的狼人杀插件 ✨

license pypi python

uv ruff isort black pyright

wakatime pre-commit pyright publish

NoneBot Registry Supported Adapters

📖 介绍

和朋友们来一场紧张刺激的狼人杀游戏

💿 安装

[!note]

请确保 NoneBot2 使用的 Python 解释器版本 >=3.10

使用 nb-cli 安装 在 nonebot2 项目的根目录下打开命令行, 输入以下指令即可安装
nb plugin install nonebot-plugin-werewolf
使用包管理器安装 在 nonebot2 项目的插件目录下, 打开命令行, 根据你使用的包管理器, 输入相应的安装命令
pip
pip install nonebot-plugin-werewolf
pdm
pdm add nonebot-plugin-werewolf
poetry
poetry add nonebot-plugin-werewolf
conda
conda install nonebot-plugin-werewolf

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

plugins = ["nonebot_plugin_werewolf"]

⚙️ 配置

在 nonebot2 项目的 .env 文件中添加如下配置:

配置项 必填 默认值 说明
werewolf__enable_poke True 是否使用戳一戳简化操作流程
werewolf__enable_button False 是否在交互中添加按钮

werewolf__enable_poke 仅在 OneBot V11 适配器 / Satori/chronocat 下生效

werewolf__enable_button 仅在 Telegram 适配器下通过测试,不保证在其他适配器的可用性。如有疑问欢迎提出。

🎉 使用

[!note]

插件通过群聊+私聊进行游戏交互

使用前请确保机器人有权限发起相应对话。

举例

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

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

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

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

指令表

指令 权限 需要@ 范围 说明
werewolf/狼人杀 群员 群聊 发起游戏 (进入准备阶段)
开始游戏 游戏发起者 群聊 [准备阶段] 游戏发起者开始游戏
结束游戏 游戏发起者/超级用户 群聊 [准备阶段] 游戏发起者/超级用户 结束游戏
当前玩家 群员 群聊 [准备阶段] 列出参与游戏的玩家列表
加入游戏 群员 群聊 [准备阶段] 玩家加入游戏
退出游戏 群员 群聊 [准备阶段] 玩家退出游戏
中止游戏 超级用户 群聊 [游戏内] 超级用户强制中止游戏
狼人杀预设 超级用户 任意 [游戏外] 超级用户编辑游戏预设
  • 发起游戏时添加 restart/重开, 可加载上一次游戏的玩家列表, 快速发起游戏。例: werewolf restart/狼人杀 重开

  • 狼人杀预设 命令用法可通过 狼人杀预设 --help 获取,或参考 游戏内容 部分的介绍

  • 对于 OneBot V11 适配器和 Satori 适配器的 chronocat, 启用配置项 werewolf__enable_poke 后, 可以使用戳一戳代替 准备阶段加入游戏 操作 和 游戏内的 stop 命令

  • 其他交互参考游戏内提示

游戏内容

[!note]

插件的游戏规则参考了网络上的相关资料

如有疑问欢迎提出

插件中保存了一份 职业预设, 内容如下

总人数 狼人 神职 平民
6 1 2 3
7 2 2 3
8 2 3 3
9 2 4 3
10 3 4 3
11 3 5 3
12 4 5 3

职业预设可以通过命令 狼人杀预设 职业 ... 修改

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

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


对于狼人神职的职业分配,默认有如下优先级:

  • 狼人: 狼人, 狼人, 狼王, 狼人
  • 神职: 女巫, 预言家, 猎人, 守卫, 白痴

职业分配优先级可以通过命令 狼人杀预设 狼人/神职 修改

示例

命令 狼人杀预设 狼人

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

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

命令 狼人杀预设 神职

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

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

[!note]

以上两条命令均支持交互式输入

例:向机器人发送命令 狼人杀预设 狼人,在接下来的一条消息中发送 狼人 狼王 狼人 狼人

其效果等同于以上描述中的单条命令 狼人杀预设 狼人 狼人 狼王 狼人 狼人


对于 小丑 职业,当预设中的平民数量大于或等于 2 时,将有 一定概率 将其中一个平民替换为小丑。

小丑属于第三方阵营,胜利条件为在投票阶段被票出,在预言家查验及游戏进程判断时视作平民。

小丑生成概率可以通过命令 狼人杀预设 小丑 <概率> 设置,默认值为 0 (不生成小丑)。

已知问题

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

📝 更新日志

更新日志
  • 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

    • 插件开源

鸣谢

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nonebot_plugin_werewolf-1.1.7.tar.gz (32.8 kB view details)

Uploaded Source

Built Distribution

nonebot_plugin_werewolf-1.1.7-py3-none-any.whl (39.6 kB view details)

Uploaded Python 3

File details

Details for the file nonebot_plugin_werewolf-1.1.7.tar.gz.

File metadata

File hashes

Hashes for nonebot_plugin_werewolf-1.1.7.tar.gz
Algorithm Hash digest
SHA256 3b7e4d0a501b971b2ee082af85e02423b1d20d2d7dc1db61d00265d9ac48fcc0
MD5 0f3eee6fffaee276dade00953f172f35
BLAKE2b-256 b01eee55598b93fd305d647154e480cef3f197d200833f8b7188dcbb613ed605

See more details on using hashes here.

Provenance

The following attestation bundles were made for nonebot_plugin_werewolf-1.1.7.tar.gz:

Publisher: GitHub
  • Repository: wyf7685/nonebot-plugin-werewolf
  • Workflow: pypi-publish.yml
Attestations:
  • Statement type: https://in-toto.io/Statement/v1
    • Predicate type: https://docs.pypi.org/attestations/publish/v1
    • Subject name: nonebot_plugin_werewolf-1.1.7.tar.gz
    • Subject digest: 3b7e4d0a501b971b2ee082af85e02423b1d20d2d7dc1db61d00265d9ac48fcc0
    • Transparency log index: 145572564
    • Transparency log integration time:

File details

Details for the file nonebot_plugin_werewolf-1.1.7-py3-none-any.whl.

File metadata

File hashes

Hashes for nonebot_plugin_werewolf-1.1.7-py3-none-any.whl
Algorithm Hash digest
SHA256 08affa65271d7bf33892ec07e4a846783f386724ea0f671f2e16496db5e95c52
MD5 741b0d1d3ad94a4af9f8caf8d585951e
BLAKE2b-256 ce17445c1e5f6852625eeaec427429d780305e572505caa27b0cff37fd6c5569

See more details on using hashes here.

Provenance

The following attestation bundles were made for nonebot_plugin_werewolf-1.1.7-py3-none-any.whl:

Publisher: GitHub
  • Repository: wyf7685/nonebot-plugin-werewolf
  • Workflow: pypi-publish.yml
Attestations:
  • Statement type: https://in-toto.io/Statement/v1
    • Predicate type: https://docs.pypi.org/attestations/publish/v1
    • Subject name: nonebot_plugin_werewolf-1.1.7-py3-none-any.whl
    • Subject digest: 08affa65271d7bf33892ec07e4a846783f386724ea0f671f2e16496db5e95c52
    • Transparency log index: 145572567
    • Transparency log integration time:

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page