Phobos-developers/Phobos

 [](https://github.com/Phobos-developers/Phobos/releases) [](https://phobos.readthedocs.io/en/latest/?badge=latest) [](https://github.com/Phobos-developers/Phobos/actions) [](https://github.com/Phobos-developers/Phobos/actions?query=workflow%3AEditorConfig) [](https://www.gnu.org/licenses/gpl-3.0.html) # Phobos ...这是一个社区引擎扩展项目，基于[修改版的 YRpp](https://github.com/Phobos-developers/YRpp)和[Syringe](https://github.com/Ares-Developers/Syringe)（用于允许注入代码），为《尤里的复仇》提供了一系列新功能和修复。它的目的是作为[Ares](https://github.com/Ares-Developers/Ares)的补充而非替代品，因此不会引入不兼容性。 虽然 Phobos 独立于 Ares 且并不强制要求 Ares 才能运行，但 Phobos 与 Ares 中的某些功能互为补充，反之亦然。 EA 未认可亦不支持此产品。 ## 下载 你可以选择以下方式之一： - [最新稳定分支构建](https://github.com/Phobos-developers/Phobos/releases/latest)（错误最少但新功能更新非常慢） - [最新开发分支构建](https://github.com/Phobos-developers/Phobos/releases)（错误稍多一些，devbuilds 会在功能完成后加入新功能） - [最新开发分支 nightly 版](https://nightly.link/Phobos-developers/Phobos/blob/develop/.github/workflows/nightly.yml)（增加了未发布的、将在下一个 devbuild 中出现的新功能） - 用于测试的单个新功能 nightly 构建可以在[拉取请求](https://github.com/Phobos-developers/Phobos/pulls)中找到 ### 关于 nightly 构建的说明 最后列出的两个版本属于前沿版本（请勿在测试之外分发！），其中包含构建信息（提交和分支/标签），这些信息会在游戏中显示且无法关闭。你可以通过自动机器人评论获取开发分支（上面的链接）和任何最新的拉取请求的构建，该评论会出现在其中，并包含该功能分支最新成功编译的 Phobos 版本。请注意，*仅当 PR 没有合并冲突时*才会生成构建。或者，你可以从 GitHub Actions 运行记录中手动获取构件。你可以获取针对特定提交自动构建的构件，只需点击绿色对勾，打开工作流，找到并下载构建构件即可。此操作仅限授权用户。 ## 安装与使用 0. 如果你的 Mod 尚未安装 Syringe，你可以将其与[最新的 Ares 包](https://launchpad.net/ares/+download)一起下载。要安装，只需将 `Syringe.exe` 放入你的游戏文件夹（即 `gamemd.exe` 所在的位置）。强烈建议同时**安装 Ares** 以获得完整的 Phobos 功能集，只需将归档中除文档文件夹外的所有文件放入你的游戏文件夹即可。 1. 获取 Phobos “包”（官方构建可在[发布页面](https://github.com/Phobos-developers/Phobos/releases)找到；请阅读下文了解如何获取 nightly 构建）。你最终应该得到两个文件：`Phobos.dll` 和 `Phobos.pdb`。 2. 将这些文件放入游戏文件夹（即 `gamemd.exe` 所在的位置）。 3. 要使用 Phobos（以及所有其他已安装的 Syringe 兼容引擎扩展，包括 Ares）启动游戏，你需要在命令行中执行 `Syringe.exe "gamemd.exe" [gamemd.exe 的命令行参数]`（如果不需要参数则省略）。Ares 包中的 `RunAres.bat` 执行的操作相同，因此你也可以使用它。 如果你已经在 Mod 中使用了 Ares，只需将上述 Phobos 文件放入游戏文件夹，Syringe 将自动加载 Phobos。这也适用于使用带 Syringe 的 XNA 客户端的 Mod；如果你的 Mod 尚未使用 Syringe 和 Ares（或者你尚未设置客户端），我们建议使用 [Starkku 制作的 CnCNet 客户端 Mod 基础包](https://github.com/Starkku/cncnet-client-mod-base)，它与 Ares 和 Phobos 开箱即用。 你可能需要的其他文件和工具位于 [Phobos 补充仓库](https://github.com/Phobos-developers/PhobosSupplementaries)。 默认情况下，除了一些错误修复外，Phobos 不会进行任何非常明显的更改。要了解如何使用 Phobos 功能，请前往官方文档。 ## 文档 - [官方文档](https://phobos.readthedocs.io)（也提供[中文版](https://phobos.readthedocs.io/zh_CN/latest)） - [社区中文文档](https://docs.qq.com/doc/p/dc3da1ce39a6e787b6e133f7d33d6aebef581cb4) - 由于官方文档的中文翻译目前尚不完善，目前建议中文用户使用社区文档。 你可以在右下角切换版本（默认显示最新的 develop nightly 版本），以及下载 PDF 版本。 文档分为几个主要类别，每个类别在侧边栏上都有一个页面。每个页面的内容分为多个子类别，无论是建筑、TechnoTypes、步兵、超级武器还是其他内容。 ### 如何阅读代码片段 ``` ; which section the entries should be in ; can be a freeform name - in this case the comment would explain what it is ; if no comment to be found - then it's a precise name [SOMENAME] ; BuildingType ; KeyName=DefaultValue ; accepted type with optional explanation ; if there's nothing to the right of equals sign - the default value is empty/absent ; if these keys have had their value set, they can only be set to their default ; unset state again by setting the value to , or none ; for list of values only clears the entire list ; if the default value is not static - it's written and explained in a comment UIDescription= ; CSF entry key ``` ## 手动构建 0. 安装 **Visual Studio**（最低要求 2022 版）以及 `.vsconfig` 中列出的依赖项（当你打开项目时它会提示你安装缺失的依赖项，或者你可以运行 VS 安装程序并导入配置）。如果你更喜欢使用 **Visual Studio Code**，可以改为安装 **VS Build Tools** 以及 `.vsconfig` 中的依赖项。不使用代码编辑器或 IDE 而通过项目中包含的**命令行脚本**进行构建也是一种选择。 1. 通过你喜欢的 git 客户端递归克隆此仓库（这也将克隆 YRpp）。 2. 构建扩展： - 在 Visual Studio 中：在 VS 中打开解决方案文件并构建它（推荐使用 `Debug` 构建配置）； - 在 VSCode 中：打开项目文件夹并点击 `运行生成任务...` (`Ctrl + Shift + B`)； - 基本方式：运行 `scripts/build_debug.bat`。 3. 构建完成后，生成的 `Phobos.dll` 和 `Phobos.pdb` 将被放置在与执行的 buildconfig 名称相同的子文件夹中。 ## 署名 你可以通过在客户端/启动器中显示徽标（单色版本可在[此处](https://github.com/Phobos-developers/Phobos/blob/develop/logo-mono.png)找到）来表达你的感谢并帮助提升项目知名度（使其成为一个可打开 Phobos GitHub 页面的按钮会显得更别致）。为了适应 Mod 风格，允许以非侵入性的方式对单色徽标进行风格化（例如，重新着色以匹配 Mod 主题），但不得对其进行其他更改。如果不确定，请先询问我们。 在宣传你使用 Phobos 实现的 Mod 功能时，请鸣谢 Phobos 及其贡献者。对 Phobos 的良好宣传应简洁且针对所展示的功能，例如：“此功能由 Phobos 实现”、“使用 Phobos 中的 XYZ 实现”等。这有助于最终用户了解 Phobos 的性质及其在 Mod 社区中的作用，并给予项目及其贡献者应有的认可。 ## 法律与许可 [](https://opensource.org/license/GPL-3.0) Phobos 项目是一个非官方的开源社区协作项目，旨在扩展《红色警戒2：尤里的复仇》引擎以用于 Mod 制作和兼容性目的。 作为一项修改，该项目遵守 [EA C&C Mod 指南](https://www.ea.com/games/command-and-conquer/command-and-conquer-remastered/news/modding-faq)；如果项目许可与 Mod 指南之间存在冲突，则指南规定的规则应优先适用（例如，项目不得商业化或用于盈利）。 本项目与 Electronic Arts Inc. 无直接关联。Command & Conquer、Command & Conquer Red Alert 2、Command & Conquer Yuri's Revenge 是 Electronic Arts Inc. 的注册商标。保留所有权利。

标签：Ares, C&C, DLL注入, DNS解析, MOD开发, Phobos, RTS引擎, Syringe, Windows游戏, YRpp, 云资产清单, 即时战略游戏, 尤里的复仇, 开源项目, 模组工具, 流量审计, 游戏修改, 游戏引擎扩展, 红警2, 逆向工程