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

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

警告 项目目前的维护工作不够积极,因此我们正在寻找积极的维护者。请在 Discord 频道 留言给我们(或直接 PM Kerbiter)。

Phobos

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

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

社区

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

下载

你可以选择下列方式

关于每夜构建版本的说明

后两个版本是前瞻版本(不要在测试之外重新分发它们!),并且在游戏中显示了版本构建信息(提交和分支/标签),无法关闭。你可以通过自动机器人的评论获取任何最新拉取请求的开发分支版本(上面的链接),这些评论会出现在对应页面中,并包含该分支最新一次成功编译的 Phobos 版本。此外,你可以手动从 GitHub Actions 运行中获取工件。你可以获取一个通过 GitHub Actions 工作流自动构建的特定提交的工件,只需要点击绿色对钩,打开工作流,找到并下载工件。这仅限于注册用户。

安装和使用

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

  2. 获取 Phobos “软件包”(可在发布页面找到官方构建版;阅读下文了解如何获取每夜构建版本)。最终会生成两个文件:Phobos.dllPhobos.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版,最低安装2019版)(打开项目时会提示安装缺失的依赖项,也可以运行 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.dllPhobos.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 的仓库、通过上方的链接向我们贡献代码或捐赠。