Home

BlockOffensive Wiki

欢迎来到 BlockOffensive 文档。BlockOffensive 是面向 Minecraft 1.20.1 Forge 的战术竞技模组，基于 FPSMatch 比赛框架实现接近 Counter-Strike 的回合制对局、队伍经济、C4 目标、击杀反馈、HUD、Overlay 与 TAB 展示能力。

文档导航

面向玩家与服务器管理员

• 快速开始：安装依赖、进入游戏、基础检查。
• 用户指南：玩法概览、爆破模式、死斗模式、队伍、商店、C4、旁观与常用操作。
• 配置说明：客户端与观战显示、Ping、C4、加时、投票、游戏规则和 Web API。
• 故障排查：常见启动、依赖、商店、C4、Web API 与构建问题。

面向开发者

• 开发者从零开始教程：克隆项目、准备 JDK、运行客户端/服务端、构建、联动 FPSMatch。
• 架构说明：主入口、地图系统、客户端、兼容层、资源与持久化结构。
• API 与接口文档：命令、配置、Web API、Forge 事件、地图类型、扩展入口。
• 网络包文档：BlockOffensive 自定义网络通道和 C2S/S2C 数据包。
• 演出、死亡镜头与观战：入场/换边演出、统一镜头接入、死亡到观战交接与管理指令。

当前版本基线

项目	当前源码基线
Minecraft	1.20.1
Forge	47.4.10
Java	运行与源码目标为 17；完整源码构建另需 Java 21 toolchain
Gradle Wrapper	8.14.5
BlockOffensive	1.3.0 snapshot
FPSMatch	1.3.0+
Modern UI	3.12.0.1
TaCZ	1.1.7-hotfix

主要能力

模块	说明
对局流程	基于 FPSMatch 的 CS 风格回合生命周期
队伍系统	CT/T 队伍、旁观队伍、比分、换边与阵营状态
经济系统	起始经济、回合奖励、击杀奖励、商店区域与购买阶段
目标玩法	C4 放置、爆炸、拆弹工具、目标点胜负判定
战斗反馈	击杀消息、爆头反馈、死亡信息、MVP、HUD、TAB
比赛协作	队友 Ping、加时策略、暂停与投票同步
兼容集成	FPSMatch、TaCZ、Modern UI、KubeJS、Physics Mod、CounterStrikeGrenade 等
外部数据	可选客户端 Web Server，向直播覆盖层/外部工具输出当前比赛状态

相关链接

• GitHub：https://github.com/SSOrangeCATY/BlockOffensive
• Releases：https://github.com/SSOrangeCATY/BlockOffensive/releases
• Modrinth：https://modrinth.com/mod/blockoffensive
• CurseForge：https://www.curseforge.com/minecraft/mc-mods/blockoffensive
• FPSMatch：https://github.com/SSOrangeCATY/FPSMatch

维护说明

本 Wiki 基于当前仓库源码整理。若后续修改地图设置项、网络包字段、配置键、命令或事件，请同步更新对应页面。