Beyond All Reason（BAR）

Beyond All Reason 是什么

Beyond All Reason（简称 BAR）是一款开源即时战略（RTS）游戏，构建在 Recoil RTS 引擎之上。它延续了经典 RTS 的玩法传统：采集资源、建造基地、生产单位、指挥大规模部队作战，并支持多人对战与 AI 对战。

项目由三个主要部分组成：

• 游戏逻辑（本仓库）：使用 Lua 编写的单位、武器、经济、AI 等游戏规则。
• 大厅 / 启动器 Chobby：负责登录、匹配、下载与启动游戏。
• Recoil 引擎：负责渲染、物理、网络同步等底层能力。

核心特点

1. 分层清晰的工程结构

游戏代码按职责划分目录，例如 luarules（规则逻辑）、luaui（界面）、gamedata（单位与武器数据）、common（公共库）等，便于定位与扩展。

2. 以 Lua 为主的开发体验

大部分玩法逻辑、单位行为与界面都使用 Lua 编写，修改后可直接在本地对局中生效，非常适合做 Mod 与平衡性实验。

3. 完整的开发与测试流程

仓库内置自动化测试支持，使用 Busted 作为测试框架，并可通过 Lux 包管理器管理依赖与执行类型检查。

# 安装依赖
lux --max-jobs=2 update

# 运行测试
busted

如何开始开发

1. 先从官网下载并安装完整的 BAR 客户端，确保游戏可以正常运行。
2. 打开启动器，点击 “Open install directory” 找到安装目录。
3. 在安装目录中创建 devmode.txt，启用开发者模式。
4. 在 games 子目录下克隆本仓库，目录名需以 .sdd 结尾，例如：

git clone --recurse-submodules https://github.com/beyond-all-reason/Beyond-All-Reason.git BAR.sdd

5. 启动完整游戏，在 Settings > Developer > Singleplayer 中选择 Beyond All Reason Dev。
6. 之后正常开始对局，游戏就会加载你本地的开发版本代码。

适用人群

• 想学习大型开源游戏项目架构的开发者
• 希望为 RTS 游戏制作 Mod 或调整平衡性的玩家
• 对 Lua 游戏逻辑、实时同步与 AI 行为感兴趣的研究者

注意事项

项目文档与社区交流以英文为主，中文资料相对有限；同时由于涉及引擎、大厅与游戏逻辑多个仓库，初次配置开发环境需要一定耐心。建议先按官方指南跑通一次本地开发对局，再逐步深入具体模块。