火卫一尤里的复仇引擎扩展

Github All Releases Docs status Workflow EditorConfig license

火卫一

…(Phobos,福波斯)是一个还在开发中的基于自定义 YRpp注射器的社区项目,旨在为尤里的复仇提供一些新功能或修复bug。这意味着它可以与战神 (Ares,火星,阿瑞斯)平台共同使用,而非替代,也因此并不会产生不兼容性。

尽管火卫一独立于/不需要Ares平台即可生效,火卫一仍完善了一些Ares中的功能,反之亦然。

你可以在Discord的C&C Mod Haven服务器中的特定频道讨论此平台。

下载

你可以选择以下方式:

每日生成须知

上列后两个版本是最最前沿的(因此不要在测试之外使用它们!)并且其中包含生成信息(提交和分支/标签),这些信息在游戏中常驻显示并且无法关闭。你可以通过任何最新的拉取请求中的自动注释获取其开发分支生成(上面的链接),该注释将包含该功能分支的最新成功编译的火卫一版本。此外,你也可以从 GitHub Actions 运行手动获取工件。你可以获得通过 GitHub Actions 工作流自动生成的特定提交的工件,只需点击绿色勾,打开工作流,找到并下载生成工件,仅限注册用户。

安装与使用

  1. 如果你的mod尚未安装注射器,可以与最新版的Ares包一同下载。只需将Syringe.exe拖入游戏根目录(即gamemd.exe所在的目录)。十分推荐安装Ares以得到完整的火卫一功能集,只需要把刚刚下载的文件中除了说明书以外的所有东西拖入游戏根目录即可。

  2. 获得一个火卫一“包”(官方版本可以在发布页面上找到;阅读下面的内容以了解如何获得每日生成)。你应该会得到两个文件:Phobos.dllPhobos.pdb

  3. 将这些文件放置在游戏根目录中。

  4. 要使用火卫一(及所有其他已安装的Syringe兼容引擎扩展,包括 Ares)启动游戏,您需要在命令行中执行Syringe.exe "gamemd.exe" [gamemd.exe的命令行参数](如果不需要,请省略参数)。Ares包中的RunAres.bat执行相同的操作,因此也可以直接使用它。

如果你的mod已经使用了Ares,那么直接将上文提到的火卫一文件拖入游戏根目录即可,注射器会自动载入火卫一。这也适用于使用XNA客户端和注射器的mod;如果你的mod没有使用注射器和Ares(或者只是尚未设置客户端),我们建议您使用 Starkku的CnCNet客户端mod基础,它开箱即用且与Ares和火卫一兼容。

可能会用到的其他的文件与工具在火卫一组件库中。

默认情况下,除了一些错误修正外,火卫一不会做任何非常明显的变化。要了解如何使用火卫一功能,请访问官方说明书。

说明书

您可以在左下角进行版本间(默认显示最新的开发分支生成)的切换,也可以下载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 the default value is not static - it's written and explained in a comment
UIDescription=<none> ; CSF entry key

手动生成

  1. 使用.vsconfig中列出的依赖项安装Visual Studio(建议2019,最低为2017)(打开项目时会提示安装缺少的依赖项,也可以运行VS安装程序并导入配置)。如果你更喜欢使用Visual Studio Code,也可以使用.vsconfig中的内容安装VS Build Tools。你也可以不使用任何代码编辑器或IDE,并通过项目中包含的命令行脚本进行构建。

  2. 通过你最喜欢的git客户端递归克隆此库(这也将自动克隆YRpp)。

  3. 生成扩展:

    • 在Visual Studio中:打开解决方案然后生成(推荐使用Debug生成配置);

    • 在VSCode中:打开项目文件夹然后点击运行生成任务Ctrl + Shift + B);

    • 其他:运行scripts/build_debug.bat

  4. 生成完成后,生成的Phobos.dllPhobos.pdb将放置在与执行的构建配置名称相同的子文件夹中。

工作人员名单表

开发者

  • Belonit (Gluk-v48) - project author

  • Kerbiter (Metadorius) - project co-author, current maintainer (Patreon)

  • Starkku - co-maintainer, developer (Patreon)

  • Uranusian (Thrifinesma) - 开发者,中国社区大使(Patreon, AliPay)

  • secsome (SEC-SOME) - 开发者

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

  • FS-21 - 开发者

  • Morton (MortonPL) - 开发者

  • Trsdy (chaserli) - developer

对于全部的贡献请见完整的工作人员名单表

感谢每一个使用火卫一,测试更新与反馈bug的人!你可以通过在客户端/启动器中显示logo(可以在此处)找到单色版本),链接火卫一库,以及通过上述链接贡献或对我们捐款来表达你对我们的赞赏和帮助。