Phobos——尤里的复仇扩展引擎

Github 所有发布版本 文档状态 工作流程 编辑器配置 许可证

警告 项目目前的维护工作不够积极，因此我们正在寻找积极的维护者。请在 Discord 频道 留言给我们（或直接私信 Kerbiter）。

Phobos

…是一个社区引擎扩展项目，它基于 自定义 YRpp 与 Syringe 为《尤里的复仇》提供一系列新功能和修复。它旨在与 Ares 引擎搭配使用，而非取而代之，因此不会带来不兼容问题。

虽然 Phobos 独立于 Ares 且无需 Ares 即可运行，但 Phobos 补充了 Ares 的一些功能，反之亦然。

此产品不受 EA 官方认可及支持。

社区

由于这是一个国际性的项目而英语是目前最常用的第二语言，因此英语是该项目的主要语言。 不过我们知道很多人的英语可能不如母语那样好，而且／或者在访问 Discord 时可能会遇到困难，所以我们并不限制创建特定语言的社区群组。

下载

你可以选择以下版本：

关于自动构建版本的说明

后两个版本是前瞻版本（不要在测试之外重新分发它们！）并且它们会在游戏中显示无法关闭的版本构建信息（提交和分支／标签）。你可以通过开发分支（上方链接）获取一个构建版本以及在拉取请求中通过自动化机器人的评论获取其开发分支上任何最新成功编译的 Phobos 版本。注意只有当拉取请求没有合并冲突时才会生成。此外，你可以手动运行 GitHub Actions 来获取一个由工作流自动生成的工件。只需要点击绿色勾号，打开工作流页面，找到并下载对应的工件。这仅限于被授权的用户执行。

安装和使用

  1. 如果你的 mod 中还没有安装 Syringe，可以连同 最新版 Ares 软件包 一同下载。安装时，只需将 Syringe.exe 置入游戏根目录（即你 gamemd.exe 所在的位置）。强烈建议同时 安装 Ares 以获得完整的 Phobos 功能体验，只需将压缩包中除 Documentation 目录之外的所有文件放入游戏根目录即可。

  2. 获取 Phobos 「软件包」（可在 发布页面 找到官方构建版；阅读下文了解如何获取自动构建版本）。最终会生成两个文件：Phobos.dll 和 Phobos.pdb。

  3. 将这些文件放入游戏根目录（即你的 gamemd.exe 所在的位置）。

  4. 要使用 Phobos（以及所有其他已安装且兼容的 Syringe 拓展引擎，包括 Ares）启动游戏，你需要在命令行中执行 Syringe.exe "gamemd.exe" [gamemd.exe 的命令行参数]（如果不需要参数，请省略）。Ares 软件包中的 RunAres.bat 也有相同的功能，因此你也同样可以使用它来启动。

如果你已经在 mod 中使用了 Ares，只需将上述 Phobos 扩展引擎的文件放到游戏根目录中，Syringe 就会自动加载 Phobos。这也适用于使用 XNA 客户端和 Syringe 的 mod；如果你的 mod 尚未使用 Syringe 和 Ares（或者你尚未设置客户端），我们建议你使用 Starkku 的 CnCNet 客户端 mod 基底，它与 Ares 和 Phobos 兼容并且开袋即食。

你可能用到的其他文件与工具位于 Phobos 补充资源库。

在默认情况下除一些错误修复外 Phobos 不会作出任何非常明显的更改。若要了解如何使用 Phobos 功能，请通读本文档。

文档

你可以在右下角切换版本（默认显示开发分支最新一次提交对应的版本），也可以在官方英文文档下载 PDF 版本。

文档分为几个大类，每类在侧边栏上都有一个页面。每个页面的内容又分为多个子类别，包括建筑、科技类型（四大类通用）、步兵、超级武器或其他。

如何阅读代码片段

; 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 <default>, <none> or none
; for list of values only <default> clears the entire list
; if the default value is not static - it's written and explained in a comment
UIDescription=<none> ; CSF entry key

手动生成

  1. 使用 .vsconfig 中列出的依赖项安装 Visual Studio（至少安装 2022 版）（打开项目时会提示安装缺失的依赖项，也可以运行 VS 安装程序并导入配置）。如果你更喜欢使用 Visual Studio Code，也可以使用 .vsconfig 中的依赖项安装 VS Build Tools。也可以不使用代码编辑器或集成开发环境而是通过项目中包含的 命令行脚本 进行构建。

  2. 通过你最喜欢的 git 客户端递归克隆该仓库（也会同时克隆 YRpp）。

  3. 对于构建扩展：

    • 在 Visual Studio 中：在 VS 中打开解决方案文件并构建（建议使用 Debug 构建配置）；

    • 在 VSCode 中：打开项目目录，点击运行构建任务…（Ctrl+Shift+B）；

    • 其他：运行 scripts/build_debug.bat。

  4. 构建完成后，生成的 Phobos.dll 和 Phobos.pdb 将被放置在与执行的构建配置名称相同的子目录中。

鸣谢

开发者

  • Belonit (Gluk-v48) - 项目作者

  • Kerbiter (Metadorius) - 项目共同作者，BDFL，维护者（Patreon）

  • Starkku - 共同维护者，开发者（Patreon）

  • Uranusian (Thrifinesma) - 开发者，中国社区大使

  • secsome (SEC-SOME) - 开发者

  • Otamaa (Fahroni, BoredEXE) - 开发者（PayPal）

  • FS-21 - 开发者

  • Morton (MortonPL) - 共同维护者，开发者

  • Trsdy (chaserli) - 共同维护者，开发者

所有贡献者名单参见 完整致谢列表。

感谢所有使用 Phobos、测试更改和报告 Bug 的人！ 你可以将我们的 Logo（单色版本可在 此处 获取）在你的客户端／启动器中展示（使其能够打开 Phobos 项目的 GitHub 主页以显得更加豪华）、将其链接到 Phobos 仓库、通过上方链接想我没贡献代码或进行捐助等方式来表达你的感谢并为本项目提供助力。