Backrooms-Games — 后室非对称对抗小游戏插件

以后室（Backrooms）为背景的非对称对抗小游戏，运行于 Paper 1.21.10 服务端。

• 实体（Entity） ×1：追捕方，以末影人形态（包级伪装）出现，空手 3 拳淘汰员工
• 员工（Employee） ×3-7：逃亡方，收集杏仁水、推进关卡，从下界合金块（Level 1）逃生

玩法流程

员工在迷宫中推进三阶段目标（放置方块自动生效，完成达标数即过）：

1. 发电机：烟熏炉，站在旁边推进进度（修好 3 台）
2. 电梯开关：拉杆，扳动激活（激活 2 个）
3. 铁门：在门边守 30 秒打开（1 扇）

大门开启后，踩到下界合金块即逃生胜利（一人逃出即胜）。

实体以末影人形态追猎，技能：

• 感官爆发：右击望远镜，暴露 30 格内员工（黑灯区除外）
• 黑暗：右击凋灵玫瑰，全场灯光熄灭 10 秒（只给实体夜视），冷却 60 秒

理智由环境亮度驱动：亮度 ≥9 回复、<5 消耗（中间稳定）；归零后无法奔跑且视野受限。

前置要求

依赖	版本	用途
Paper	1.21.10	服务端
Java	21	运行环境
PostgreSQL	任意	关键地点（出生点/猎手巢穴）存储
PacketEvents	2.13.0+	实体的包级伪装（末影人外观）

数据库访问使用 Hibernate ORM，运行时依赖由 Paper 根据 plugin.yml 自动下载。

构建

gradle build
# 产物：backrooms-game/build/libs/backrooms-game-0.1.0.jar

部署

1. 安装 Paper 1.21.10、PostgreSQL、PacketEvents（均放入 plugins/）
2. 把插件 jar 放入 plugins/
3. 在 plugins/BackroomsGame/config.yml 配置数据库连接与平衡参数
4. 管理员在创意模式标定出生点：/backrooms set spawn 1~8、/backrooms set hunter 0
5. /backrooms template 进入模板世界搭图，template done 保存

方块驱动的玩法元素无需标定：烟熏炉=发电机、拉杆=开关、铁门=大门、下界合金块=出口、木桶=杏仁水、无光源=黑灯区、屏障=无底坑。

命令

• 玩家：/game join /game leave /game list /hub
• 管理员：/backrooms start /backrooms stop（强制开局/中断）、/backrooms template template done（建图）、/backrooms reload、/backrooms light（光照诊断）

Git 提交规范（硬性标准）

本仓库的 git 提交受 hooks/pre-commit 钩子强制检查（规则见 docs/GIT-RULES.md）：禁止提交开发环境/凭据/构建产物/日志，扫描内容中的令牌与私钥。克隆仓库后必须执行一次：

git config core.hooksPath hooks

文档

• CONTEXT.md — 领域术语表
• docs/ARCHITECTURE.md — 模块边界、依赖方向与后续开发约定
• docs/adr/ — 架构决策记录
• docs/GIT-RULES.md — Git 提交硬性规范