diff --git a/README.md b/README.md index 9c21451..015dd61 100644 --- a/README.md +++ b/README.md @@ -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) -## 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). +## 地图制作（Mapping） -# Sponsors -Free code signing on Windows provided by [SignPath.io](https://about.signpath.io/), certificate by [SignPath Foundation](https://signpath.org/). +- 教程：[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) + +## 许可证 + +Copyright (c) OpenRA Developers and Contributors +OpenRA 使用 GNU GPLv3（或更高版本）授权发布，详见 [COPYING](https://github.com/OpenRA/OpenRA/blob/bleed/COPYING)。 + +## 赞助方 + +Windows 平台的免费代码签名由 [SignPath.io](https://about.signpath.io/) 提供，证书来自 [SignPath Foundation](https://signpath.org/)。