OpenRA 完整使用教程
分普通玩家游玩和开发者 / 模组制作者两大模块，基于 GitHub OpenRA 仓库文档。
一、下载与安装
- 官网
openra.net下载对应系统安装包
安装完成启动，选择模组：ra(红警)/cnc(泰伯利亚黎明)/d2k(沙丘2000) - 首次启动模组：弹出资源安装窗口，点【Quick Install】自动下载原版素材；网络异常可手动下载资源包放到对应目录OpenRA
说明：引擎开源 GPL3，但原版素材版权归 EA；EA 不背书本项目。
二、基础游戏操作 & 核心快捷键
鼠标
- 左键：选中单位、放置建筑
- 右键：移动 / 攻击（可在设置切换原版左键模式）
- 鼠标滚轮：缩放画面；中键拖拽平移视角
必记快捷键（可在设置自定义）
| 快捷键 | 功能 |
|---|---|
| A | 攻击移动（最重要！单位移动途中遇敌自动开火） |
| S | 停止当前行动 |
| H | 快速跳转回主基地 |
| 空格 Space | 跳转到最近警报事件（基地被攻击） |
| Ctrl + 数字 (1~9) | 编队；按数字快速选中，双击数字镜头切过去 |
| Shift | 批量选择单位、队列指令（连续移动 / 建造） |
| W | 选中屏幕内同类单位；双击 W = 全图同类单位 |
| Q | 选中屏幕全部作战单位 |
| R | 维修；L 变卖建筑 |
| D | 单位展开（MCV、火炮等） |
| E/R | 建筑建造完成后快速放置 |
小技巧：按住 Shift 连续排队生产单位；A 攻击移动是新手最需要养成的习惯，单纯移动单位不会主动反击敌人。
三、单机游玩（遭遇战 / 战役）
- 主菜单 → Skirmish（遭遇战）
- 选择地图、AI 难度、玩家数量、资金、游戏速度
- 开始游戏；也可以选择 Campaign 游玩官方战役任务
四、多人联机
1. 官方大厅联机（最简单）
Multiplayer → 进入大厅，直接加入公开房间；或者新建房间等待其他人加入。
- 别人加入你的房间时，如果缺少地图，会自动从 OpenRA 资源中心下载
2. 直连 IP（大厅刷不出服务器时用）
Multiplayer → Connect to Server，输入 IP:1234 直连自建服务器
3. 搭建独立专用服务器（Dedicated Server）
Windows：launch-dedicated.cmd
Linux/macOS：launch-dedicated.sh
- 启动参数指定模组：
Game.Mod=ra（红警） - 可设置服务器名称、密码、最大人数；
AdvertiseOnLocalNetwork开关局域网广播 - 端口默认 TCP 1234，云服务器需要放行端口；不开启 Advertise 则不会出现在官方大厅，只能 IP 直连
五、地图编辑器（内置，无需额外软件）
- 游戏主菜单：
Extras → Map Editor打开内置编辑器 - 新建地图：设置尺寸、地形主题、玩家出生点、资源（矿石 / 泰伯利亚）
- 编辑功能：放置地形、悬崖、道路、建筑、单位、资源、路径标记；新版本 Path Tiler 工具快速绘制海岸线、道路
- 保存地图：选择Packed 打包格式（.oramap），只有打包地图才能上传到资源中心
- 测试：保存后直接在游戏里加载地图游玩
- 分享地图：上传至 OpenRA Resource Center（资源中心 resource.openra.net），联机时其他玩家自动下载地图OpenRA Res...
Lua 脚本任务（战役自定义事件）
地图支持 Lua 脚本，用来写任务目标、援军触发、事件、胜利 / 失败条件。
- 在地图目录放入 lua 脚本，在地图 yaml 配置加载脚本
- 官方 Wiki 提供完整 Lua API 文档，可实现定时增援、AI 触发、弹窗简报等战役功能OpenRA
六、第三方模组 Mod 安装
- 下载社区 mod 压缩包，解压到 mod 目录
- 重启 OpenRA，在启动界面选择新模组即可。
知名社区模组：Shattered Paradise、RA2 复刻模组等；大型总转换模组可以发布到 Mod DB。
七、进阶：编译源码 & Mod SDK 模组开发
1. 编译 OpenRA 引擎源码
前提：安装.NET SDK
git clone https://github.com/OpenRA/OpenRA.git
cd OpenRA
- Windows：执行
make.cmd all编译；编译完成运行launch-game.cmd - Linux/macOS：
make all，./launch-game.sh
源码目录说明： OpenRA.Game游戏核心引擎OpenRA.Mods.Cnc/Common/D2k内置模组逻辑mods存放游戏素材与 yaml 规则文件OpenRA.Utility资源转换、地图 / 素材工具
2. Mod SDK 制作全新模组
官方提供 OpenRAModSDK，用来从零开发自己的 RTS 模组：
- 下载 Mod SDK 模板
mod.config设置模组 ID、引擎版本- 用 MiniYaml 编写单位、建筑、武器规则（缩进严格，4 空格 / Tab）
# MiniYaml简单示例
E1:
Inherits: ^Soldier
Buildable:
Queue: Infantry
Valued:
Cost:100
make.cmd/make编译模组，launch-game启动测试- 像素美术：制作符合引擎规范的 PNG 精灵，配合 utility 工具导入序列帧、调色板
文档：自动生成 Trait 特性文档，用来查询 YAML 所有可用属性。
八、常见问题排查
- 资源下载失败：手动下载素材包，放到 Content 对应 mod 文件夹
- 联机不同步 (Out of Sync)：双方游戏版本、模组版本、地图必须完全一致；在 Logs 目录查看 syncreport.log 日志
- 启动闪退：更新显卡 OpenGL 驱动；虚拟机容易出现图形问题
- 找不到自定义地图：确认地图放入
maps/ra（对应模组子目录），并且是 packed 打包格式 - 联机大厅空白：网络 DNS 问题，改用 IP 直连
九、社区与文档
- 官网：openra.net
- 交流：Discord / Libera IRC #openra / 官方论坛
- 问题反馈：GitHub Issues
- 文档：Wiki、The OpenRA Book（引擎 / 模组开发书籍）
- 地图分享：resource.openra.net
如果你需要，我可以单独精简一份：
① 新手快速上手极简版（只讲安装 + 遭遇战 + 快捷键）
或者
② Mod 制作入门（MiniYaml 从零写一个自定义单位）