let5see/OpenRA
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: 中文 README 并记录托管实现

Browse Source 
将 README.md 翻译为中文，并补充本分支关键实现：开局交还控制权给传统人机（BotTakeoverManager）与托管时镜头防守热点跟随（BotTakeoverCameraFollower），同时给出相关入口/配置文件路径。
This commit is contained in:
let5sne.win10
2026-01-11 23:39:03 +08:00
parent 9d80847a9a
commit d00ffa28f3
1 changed files with 64 additions and 41 deletions
Download Patch File Download Diff File Expand all files Collapse all files

103
README.md
View File

@@ -1,60 +1,83 @@
# OpenRA
# OpenRA（中文）
A Libre/Free Real Time Strategy game engine supporting early Westwood classics.
OpenRA 是一个自由/开源的即时战略（RTS）游戏引擎，支持早期 Westwood 经典作品的重制与扩展。
* Website: [https://www.openra.net](https://www.openra.net)
* Chat: [#openra on Libera](ircs://irc.libera.chat:6697/openra) ([web](https://web.libera.chat/#openra)) or [Discord](https://discord.openra.net) ![Discord Badge](https://discordapp.com/api/guilds/153649279762694144/widget.png)
* Repository: [https://github.com/OpenRA/OpenRA](https://github.com/OpenRA/OpenRA) ![Continuous Integration](https://github.com/OpenRA/OpenRA/workflows/Continuous%20Integration/badge.svg)
- 官网：https://www.openra.net
- 交流：Libera 上的 `#openra`（[web](https://web.libera.chat/#openra)）或 [Discord](https://discord.openra.net)
- 上游仓库：https://github.com/OpenRA/OpenRA
Please read the [FAQ](https://github.com/OpenRA/OpenRA/wiki/FAQ) in our [Wiki](https://github.com/OpenRA/OpenRA/wiki) and report problems at [https://github.com/OpenRA/OpenRA/issues](https://github.com/OpenRA/OpenRA/issues).
请先阅读 Wiki 中的 [FAQ](https://github.com/OpenRA/OpenRA/wiki/FAQ) 与开发文档，并在上游 Issues 反馈引擎问题：https://github.com/OpenRA/OpenRA/issues
Join the [Forum](https://forum.openra.net/) for discussion.
也可加入论坛讨论：https://forum.openra.net/
## Play
## 本仓库/本分支的关键实现记录
Distributed mods include a reimagining of
本分支围绕“开局将本地人类玩家控制权交还给传统人机（Classic Bot）并让比赛以人机 vs 人机方式运转”，以及“托管时镜头自动跟随防守热点”做了增强。
* Command & Conquer: Red Alert
* Command & Conquer: Tiberian Dawn
* Dune 2000
- 开局自动托管给传统人机：`OpenRA.Mods.Common/Traits/Player/BotTakeoverManager.cs`
- 作为 Player Trait，在 `WorldLoaded` 后为“本地人类玩家（LocalPlayer）”自动激活经典 `ModularBot(normal)`。
- 仅在主机侧生效，并避免在回放中启用（防止非权威端/回放污染世界状态）。
- 当前在 `mods/ra/rules/player.yaml` 默认开启：`BotTakeoverManager: AutoActivate: true`。
- 托管时镜头自动跟随（默认偏“防守保家”）：`OpenRA.Mods.Common/Traits/Player/BotTakeoverCameraFollower.cs`
- 通过 `INotifyDamage`/`INotifyBuildingPlaced` 收集“热点”（受击位置、建造落点等），按权重+时间衰减选取最佳焦点。
- 默认优先级：基地/MCV/矿车/矿厂受击 > 其它建筑受击 > 单位受击 > 新建筑落点。
- 多处战斗会使用“最短驻留时间 + 切换阈值”避免镜头频繁抖动；切换焦点可选择瞬移或限速平滑移动。
- 当前在 `mods/ra/rules/player.yaml` 默认开启，并且只在托管激活时生效（`RequireTakeoverActive: true`）。
- 游戏内托管开关按钮（用于取消/恢复托管）：
- UI：`mods/ra/chrome/ingame-player.yaml`（`Button@LLM_TAKEOVER`）
- 逻辑：`OpenRA.Mods.Common/Widgets/Logic/Ingame/LLMTakeoverLogic.cs`
EA has not endorsed and does not support this product.
## 游玩
Check our [Playing the Game](https://github.com/OpenRA/OpenRA/wiki/Playing-the-game) Guide to win multiplayer matches.
发行的内置模组包含对以下经典 RTS 的重制：
## Contribute
- Command & Conquer: Red Alert（红色警戒）
- Command & Conquer: Tiberian Dawn（泰伯利亚黎明）
- Dune 2000（沙丘 2000）
* Please read [INSTALL.md](https://github.com/OpenRA/OpenRA/blob/bleed/INSTALL.md) and [Compiling](https://github.com/OpenRA/OpenRA/wiki/Compiling) on how to set up an OpenRA development environment.
* See [Hacking](https://github.com/OpenRA/OpenRA/wiki/Hacking) for a (now very outdated) overview of the engine.
* Read and follow our [Code of Conduct](https://github.com/OpenRA/OpenRA/blob/bleed/CODE_OF_CONDUCT.md).
* To get your patches merged, please adhere to the [Contributing](https://github.com/OpenRA/OpenRA/blob/bleed/CONTRIBUTING.md) guidelines.
EA 未背书且不支持本产品。
## Mapping
多人对战入门可参考：[Playing the Game](https://github.com/OpenRA/OpenRA/wiki/Playing-the-game)
* We offer a [Mapping](https://github.com/OpenRA/OpenRA/wiki/Mapping) Tutorial as you can change gameplay drastically with custom rules.
* For scripted mission have a look at the [Lua API](https://docs.openra.net/en/release/lua/).
* If you want to share your maps with the community, upload them at the [OpenRA Resource Center](https://resource.openra.net).
## 编译与运行（Windows）
## Modding
- 编译（推荐）：`.\make.cmd all`
- 快速启动红色警戒模组（本仓库提供脚本）：`.\start-ra.cmd`
* Download a copy of the [OpenRA Mod SDK](https://github.com/OpenRA/OpenRAModSDK) to start your own mod.
* Check the [Modding Guide](https://github.com/OpenRA/OpenRA/wiki/Modding-Guide) to create your own classic RTS.
* There exists an auto-generated [Trait documentation](https://docs.openra.net/en/latest/release/traits/) to get started with yaml files.
* Some hints on how to create new OpenRA compatible [Pixelart](https://github.com/OpenRA/OpenRA/wiki/Pixelart).
* Upload total conversions at [our Mod DB profile](https://www.moddb.com/games/openra/mods).
更多开发环境配置请阅读：
- [INSTALL.md](https://github.com/OpenRA/OpenRA/blob/bleed/INSTALL.md)
- Wiki: [Compiling](https://github.com/OpenRA/OpenRA/wiki/Compiling)
## Support
## 贡献
* Sponsor a [mirror server](https://github.com/OpenRA/OpenRAWebsiteV3/tree/master/packages) if you have some bandwidth to spare.
* You can immediately set up a [Dedicated](https://github.com/OpenRA/OpenRA/wiki/Dedicated-Server) Game Server.
- 请阅读并遵守：[Code of Conduct](https://github.com/OpenRA/OpenRA/blob/bleed/CODE_OF_CONDUCT.md)
- 提交补丁请遵循：[CONTRIBUTING.md](https://github.com/OpenRA/OpenRA/blob/bleed/CONTRIBUTING.md)
- 引擎架构概览（可能已过时）：[Hacking](https://github.com/OpenRA/OpenRA/wiki/Hacking)
## 地图制作（Mapping）
- 教程：[Mapping](https://github.com/OpenRA/OpenRA/wiki/Mapping)
- Lua 脚本任务相关：[Lua API](https://docs.openra.net/en/release/lua/)
- 分享地图：OpenRA Resource Center：https://resource.openra.net
## 模组开发（Modding）
- Mod SDK：https://github.com/OpenRA/OpenRAModSDK
- 指南：[Modding Guide](https://github.com/OpenRA/OpenRA/wiki/Modding-Guide)
- Traits 文档（自动生成）：https://docs.openra.net/en/latest/release/traits/
- 像素美术提示：[Pixelart](https://github.com/OpenRA/OpenRA/wiki/Pixelart)
- 发布大型模组（Total Conversion）：https://www.moddb.com/games/openra/mods
## 支持
- 赞助镜像下载服务器： https://github.com/OpenRA/OpenRAWebsiteV3/tree/master/packages
- 搭建专用服务器：[Dedicated Server](https://github.com/OpenRA/OpenRA/wiki/Dedicated-Server)
## 许可证
## License
Copyright (c) OpenRA Developers and Contributors
This file is part of OpenRA, which is free software. It is made
available to you under the terms of the GNU General Public License
as published by the Free Software Foundation, either version 3 of
the License, or (at your option) any later version. For more
information, see [COPYING](https://github.com/OpenRA/OpenRA/blob/bleed/COPYING).
OpenRA 使用 GNU GPLv3（或更高版本）授权发布，详见 [COPYING](https://github.com/OpenRA/OpenRA/blob/bleed/COPYING)。
# Sponsors
Free code signing on Windows provided by [SignPath.io](https://about.signpath.io/), certificate by [SignPath Foundation](https://signpath.org/).
## 赞助方
Windows 平台的免费代码签名由 [SignPath.io](https://about.signpath.io/) 提供，证书来自 [SignPath Foundation](https://signpath.org/)。