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

将 README.md 翻译为中文,并补充本分支关键实现:开局交还控制权给传统人机(BotTakeoverManager)与托管时镜头防守热点跟随(BotTakeoverCameraFollower),同时给出相关入口/配置文件路径。
This commit is contained in:
let5sne.win10
2026-01-11 23:39:03 +08:00
parent 9d80847a9a
commit d00ffa28f3

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) - 官网: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) - 交流Libera 上的 `#openra`[web](https://web.libera.chat/#openra))或 [Discord](https://discord.openra.net)
* Repository: [https://github.com/OpenRA/OpenRA](https://github.com/OpenRA/OpenRA) ![Continuous Integration](https://github.com/OpenRA/OpenRA/workflows/Continuous%20Integration/badge.svg) - 上游仓库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 - 开局自动托管给传统人机:`OpenRA.Mods.Common/Traits/Player/BotTakeoverManager.cs`
* Command & Conquer: Tiberian Dawn - 作为 Player Trait`WorldLoaded` 后为“本地人类玩家LocalPlayer”自动激活经典 `ModularBot(normal)`
* Dune 2000 - 仅在主机侧生效,并避免在回放中启用(防止非权威端/回放污染世界状态)。
- 当前在 `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. EA 未背书且不支持本产品。
* 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.
## 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. ## 编译与运行Windows
* 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).
## 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. - [INSTALL.md](https://github.com/OpenRA/OpenRA/blob/bleed/INSTALL.md)
* There exists an auto-generated [Trait documentation](https://docs.openra.net/en/latest/release/traits/) to get started with yaml files. - Wiki: [Compiling](https://github.com/OpenRA/OpenRA/wiki/Compiling)
* 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).
## Support ## 贡献
* Sponsor a [mirror server](https://github.com/OpenRA/OpenRAWebsiteV3/tree/master/packages) if you have some bandwidth to spare. - 请阅读并遵守:[Code of Conduct](https://github.com/OpenRA/OpenRA/blob/bleed/CODE_OF_CONDUCT.md)
* You can immediately set up a [Dedicated](https://github.com/OpenRA/OpenRA/wiki/Dedicated-Server) Game Server. - 提交补丁请遵循:[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 Centerhttps://resource.openra.net
## 模组开发Modding
- Mod SDKhttps://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 Conversionhttps://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 Copyright (c) OpenRA Developers and Contributors
This file is part of OpenRA, which is free software. It is made OpenRA 使用 GNU GPLv3或更高版本授权发布详见 [COPYING](https://github.com/OpenRA/OpenRA/blob/bleed/COPYING)。
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).
# 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/)。