thecampagnards/loup-garou

!https://github.com/thecampagnards/LoupGarou/workflows/CI/badge.svg

目录

• 目录
• 关于
• 轻松游玩
• 安装
  • 所需依赖
  • 常规安装
  • Docker安装（替代方案）
    • 启动服务器
      • Docker Compose
      • Docker
• 命令
• Credits
• 帮助
  • 常见问题
• 开发者指引
  • 添加角色
    • 常用类
  • 发布角色

关于

狼人杀模式灵感来源于桌游《Thiercelieux的狼人》，保留其玩法和规则，但无需主持人，游戏流程完全自动化：

• 自动运行游戏流程
• 包含基础角色及新增角色
• 可在任意地图使用

轻松游玩

我们提供了一个公共服务器，方便您快速与朋友或陌生人游玩狼人杀。只需创建房间邀请好友，或加入公共房间即可。

IP: lg.leomelki.fr
版本: 1.9.4

安装

所需依赖

• https://www.spigotmc.org/resources/protocollib.1997/

常规安装

需要Minecraft 1.15.1版本。
安装插件请遵循以下步骤：

1. 下载Spigot 1.15.1并启动一次服务器
2. 在plugins文件夹中放入https://www.spigotmc.org/resources/protocollib.1997/%E5%92%8Chttps://github.com/leomelki/LoupGarou/releases
3. 重启服务器，然后在控制台使用/op <您的游戏名>获取管理员权限
4. 进入地图，在每个方块上添加出生点：/lg addSpawn
5. 连接服务器，使用/lg roles set <角色> <数量>设置要使用的角色
   ⚠️ 角色数量需与玩家数量一致才能启动游戏
6. 使用/lg start <游戏名>启动游戏
   ⚠️ 请填写您的游戏名，例如：/lg start leomelki

发布版本链接：https://github.com/leomelki/LoupGarou/releases

Docker安装（替代方案）

您的机器需已安装docker

启动服务器

每次重启机器后需先执行以下命令

Docker Compose

sh
docker-compose up -d

Minecraft相关文件将存放在minecraft_data文件夹中

Docker

sh
docker run --name loup-garou -v "$(pwd)/minecraft_data:/minecraft" -p 25565:25565 -e EULA=true -d thecampagnards/loup-garou:latest

Minecraft相关文件将存放在minecraft_data文件夹中

命令

• /lg roles：返回当前游戏的角色列表
• /lg roles set <ID> <数量>：设置某角色的玩家数量
• /lg addSpawn：添加出生点（玩家位置）
• /lg start <游戏名>：启动游戏
• /lg end <游戏名>：结束游戏
• /lg reloadConfig：重新加载配置
• /lg joinAll：修改角色后使用此命令

Credits

• 项目负责人：Shytoos
• 开发：Leomelki
• 地图制作：Cosii

帮助

由于时间限制，我们无法提供一对一支持，但您可以加入我们的***服务器，从社区获取帮助。

常见问题

• 显示问题（头顶投票卡住等）怎么办？
  这通常是在游戏中执行reload后出现的，有问题的玩家需重新连接服务器。

• 为什么游戏无法启动？
  需使用/lg start <游戏名>命令，并填写参与游戏的玩家名。若仍无法启动，可能是角色数量与玩家数量不匹配，需确保两者一致。修改角色后请执行/lg joinAll。

• 出生点放置错误或想换地图怎么办？
  打开plugins\LoupGarou\config.yml文件，删除现有出生点即可。

• 同一角色能否多次使用？
  狼人、村民、猎人角色支持多次使用。其他角色未测试过多次使用的情况，使用需自行承担风险。

• 黑狼（或其他狼人类型）回合未进行？
  当添加其他类型狼人时，至少需要一名普通狼人。

开发者指引

该狼人杀插件经过多次修改，部分代码可能不够整洁且缺乏文档。

修改项目需使用Lombok和Maven，并通过https://www.spigotmc.org/wiki/buildtools/%E5%AE%89%E8%A3%85%60Spigot%60%E4%BB%93%E5%BA%93%E3%80%82

若您想修改或使用本项目的部分/全部代码，请注明Credits给Leomelki和Shytoos。

添加角色

插件基于事件系统组织，事件位于fr.leomelki.loupgarou.events包中。建议参考已有的角色代码进行修改。

⚠️ 项目设计时确保角色（几乎）完全独立于核心代码（LGGame、LGPlayer等），开发新角色时请尽量使用事件，若缺少事件可自行创建。

常用类

• LGGame：游戏核心类，尽量少修改！
• LGPlayer：与玩家交互及存储数据的类，尽量少修改！
• LGVote：投票管理系统
• RoleSort：夜间角色出现顺序的排序类

发布角色

若您创建了新角色，欢迎提交PR到本仓库，与社区分享您的成果！