User Guide

用户指南

本页面面向玩家、服务器管理员与整合包作者，解释 BlockOffensive 的核心玩法与常用操作。

玩法概览

BlockOffensive 在 FPSMatch 框架上提供两类地图类型：

类型	名称	说明
cs	爆破模式	CT/T 阵营回合制对抗，包含经济、购买阶段、C4 放置与拆弹、换边和胜利判定。
csdm	死斗模式	面向连续战斗的死亡竞赛模式，可配置 TDM、比赛时间和重生保护。

爆破模式

爆破模式接近 Counter-Strike 的核心规则：

• T 阵营负责进攻并放置 C4。
• CT 阵营负责防守目标点并拆除 C4。
• 回合内玩家死亡后通常进入旁观，等待下一回合。
• 每回合根据胜负原因、击杀、队伍表现结算经济。
• 到达胜利回合数后结束比赛。
• 达到半场或指定条件时会发生攻防转换。

主要回合阶段

阶段	说明
等待阶段	玩家加入地图、选择队伍、等待比赛开始。
热身/倒计时	自动开始倒计时或管理员准备阶段。
购买阶段	玩家可在商店区域打开商店购买装备。
正式回合	双方进行对抗，T 可尝试放置 C4。
C4 引信阶段	C4 放置后进入倒计时，CT 需要拆弹。
回合结算	结算胜负、经济、击杀反馈和 MVP。
暂停/投票	可通过地图内命令发起暂停或取消暂停投票。

胜利条件

常见胜利方式包括：

• CT 消灭所有 T。
• T 消灭所有 CT。
• T 成功引爆 C4。
• CT 成功拆除 C4。
• 回合超时后根据 C4 状态与阵营规则判定。
• 比赛达到胜利回合数或加时规则结束。

死斗模式

csdm 适合快速对枪、热身或团队死斗：

• 支持 isTDM 设置切换个人死斗或团队死斗。
• matchTimeLimit 控制比赛时长。
• spawnProtectionTime 控制重生保护。
• 玩家死亡后会快速重生。
• TAB 显示更偏向得分、K/D、击杀、死亡、助攻等统计。

队伍与旁观

BlockOffensive 基于 FPSMatch 队伍系统，典型队伍包括：

• CT
• T
• spectator

普通玩家加入 CT/T 后参与比赛；旁观者可使用旁观切换键观察队友或比赛状态。部分旁观逻辑会触发击杀回放、队友附身和玩家轮换视角。客户端可在配置中分别关闭观战时的 C4 倒计时 HUD 和观战者名单侧栏。

死亡后会先播放短暂的死亡镜头，然后切换到当前可用的观战目标。若目标尚未同步，客户端会等待一段时间，再降级到受限死亡位置视角。入场和换边时可能播放队伍演出；详细行为和管理员配置见演出、死亡镜头与观战。

商店与经济

商店系统建立在 FPSMatch 的队伍商店能力上。爆破模式和死斗模式都会注册 cs/csdm 商店类型。

常见商店分类包括：

• 装备
• 手枪
• 中级武器
• 步枪
• 投掷物

玩家能否打开商店取决于：

• 是否已经加入地图。
• 游戏是否已经开始。
• 当前地图是否支持商店。
• 是否仍处于购买时间。
• 是否位于商店区域内。

C4 与拆弹

T 阵营玩家可携带 C4 并在指定爆破区域内放置。C4 放置失败常见原因：

• 不在爆破区域。
• 地图没有定义爆破区域。
• 玩家未加入爆破模式地图。
• 比赛尚未开始。
• 玩家未加入正确队伍。

CT 阵营玩家可使用拆弹键执行拆弹。拆弹进度会同步到客户端 HUD 和 Web API。

HUD、TAB 与击杀反馈

BlockOffensive 会注册 cs 与 csdm HUD：

• 比分与时间。
• 存活人数。
• C4 状态与拆弹进度。
• 商店状态。
• 击杀消息与爆头信息。
• MVP 动画和音乐。
• TAB 统计面板。

客户端配置可控制击杀消息 HUD 和击杀图标是否启用。

队友 Ping 与投票

战术电台键会打开六选项的 Ping 菜单：普通、敌人、危险、进攻、防守和支援。选定类型后，客户端将准星落点发送给服务端，服务端只向同队玩家同步世界标记。标记时长与最大显示距离由服务器的 pingTtlSeconds 和 pingMaxDistance 控制。

暂停、取消暂停和加时会使用投票状态。除聊天点号命令外，客户端还注册了同意与反对投票的按键；投票 HUD 会显示赞成、反对、未投票人数、门槛和剩余时间。具体投票策略见 配置说明。

常用命令

命令	说明
/fpsm help	查看 FPSMatch 与扩展命令帮助。
/cs2 <action>	将 action 转发给当前所在 CSGameMap 的地图内命令处理器。
/fpsm mvp <targets> <sound>	给目标玩家设置 MVP 音乐。

爆破模式内置 action

这些 action 可通过 /cs2 <action> 执行，也可在地图聊天中使用点号形式，例如 .a、.da。

action	别名	说明
pause	p	请求或设置暂停。
unpause	up	发起取消暂停投票。
agree	a	同意当前投票。
disagree	da	反对当前投票。
drop	d	执行丢弃/切刀相关逻辑。

管理员 debug action：

• debug_1
• debug_2
• debug_3
• debug_4

这些 action 需要权限等级 2 或在实现中显式检查权限。

常用按键

按键可在 Minecraft 控制设置中修改：

分类	功能
方块攻势	打开枪械商店
方块攻势	拆除炸弹
方块攻势	打开队伍聊天
方块攻势	打开战术电台/Ping 菜单
方块攻势	同意或反对投票
方块攻势	MVP 本地音乐选择
方块攻势观察者	切换上一个队友
方块攻势观察者	切换下一个队友

与外部工具联动

如果启用 Web Server，旁观者客户端会在进入比赛时开放本地 HTTP API：

GET http://localhost:8080/api/data

该接口适合直播覆盖层、计分板工具或本地调试工具读取当前比赛状态。详情见 API 与接口文档。