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

Github All Releases Docs status Workflow license

火卫一

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

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

安装与使用

  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和火卫一兼容。

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

获得每日生成

对于想要帮忙测试最新完成的Phobos功能的人来说,可以使用每日生成 (nightly build)。每日生成均为最新版本(切勿执行测试以外的用途),且在游戏内会显示生成信息(提交与分支/标签),此信息不可被关闭。有两种方法可以获得每日生成。

  • 通过nightly.link获得。这是GitHub提供的允许游客下载的自动生成服务。你可以通过这个链接得到最新的develop分支下的成功生成(标记为绿色√),也可以使用任何最新的拉取请求的自动评论中的链接。

  • 通过GitHub Actions手动获得。对于任何提交都会有一个自动的GitHub Actions工作流,你可以点击其绿色√,打开工作流并下载。这种方式限制必须拥有账号才能使用。

生成

  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将放置在与执行的构建配置名称相同的子文件夹中。

说明书

文档可以在这里@Read the Docs找到,并分为几个主要类别,每个类别都在侧边栏上显示一个页面。每个页面的内容又分为多个子类别,可以是建筑、通用类型、步兵、超级武器或其他东西。

您可以在左下角进行版本间的切换,也可以下载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

工作人员名单表

开发者

  • Belonit (Gluk-v48) - 项目作者(已退出)

  • Kerbiter (Metadorius) - 项目合作作者,当前维护人员(Patreon)

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

  • secsome (SEC-SOME) - 开发者 (Patreon)

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

  • FS-21 - 开发者

  • Starkku - 开发者

  • Morton (MortonPL) - 开发者

贡献者

  • Belonit (Gluk-v48) - 项目创始人,关闭载入图空白起始点,使用程序参数自定义游戏图标,全彩色PCX,视野弹,金币弹,PCX载入图,自定义镭射半径,扩展工具提示,建筑升级增强,隐藏血条,UI使用GDI位置,CellSpread扩展,Blowfish.dll相关错误修复,0大小地图预览,Locomotor代称,护盾,输入修复

  • Kerbiter (Metadorius) - SHP碎片阴影,建筑升级增强,扩展工具提示,选择优先级筛选,TurretOffset增强,自定义矿柱,选择下一个空闲矿车快捷键,拦截者增强,0大小地图预览,激光尾迹,激光修复,CI/CD,增强Unicode字体,说明书维护,VSCode配置,代码风格

  • tomsons26 - 全方位帮助,逆向工程方面协助与知道,YR解析

  • CCHyper - 全方位帮助,项目logo,逆向工程方面协助与知道,YR解析

  • Ares开发者 - YRpp和Syringe,存读档,Ares的项目基础与有助的代码,未完成的RadType代码,部署修复原型代码

  • ZΞPHYɌUS - 胜利失败音乐

  • ayylmao - 帮助书写说明书

  • SMxReaver - 帮助书写说明书,广泛的深度测试

  • 4SG - 帮助书写说明书

  • wiktorderelf - 增强Unicode字体

  • Uranusian (Thrifinesma) - 心灵控制增强,自定义弹头水花动画,矿车指示器,子机经验同步,护盾,重复死亡修复,自定义缺省图标,图标排序优先级,放置模式相应标签快捷键修复,生产进度条,自定义矿石采集动画,禁止手动移动,武器瞄准筛选所属方,死亡武器修复,重新激活废弃的JumpjetControls,AI触发识别建筑升级,围墙闸门连接,部署步兵使用全部武器,增强Unicode字体,说明书维护,中文说明书翻译

  • secsome (SEC-SOME) - debug信息输出快捷键,重构与移植Ares的帮助代码,引入了更多Ares衍生物,移除伪装弹头,移除心控弹头,心灵控制增强,护盾,AnimList.PickRandom,移动到坐标修复,无限路径点,将建筑建造于触发动作建造动画修复,反部署建筑播放EVA_NewRallyPointEstablished修复,自定义矿车动画,超时空相关崩溃修复,于重新开始任务对话框添加的读档按钮,步兵类型独立默认伪装,电厂增强,存档触发,存档快捷键,数字变量,自定义抛射体重力,重绘地图颜色修复

  • Otamaa (Fahroni, BoredEXE) - CellSpread扩展,移植并修复RadType代码,可开关的ElectricBolt电弧,自定义超时空Locomotor相关属性,DebrisMaximums修复,动画生成单位,NotHuman死亡动画增强,自定义可对外射击载具属性,92&93号脚本动作钩子,HideIfNoOre的矿石阶段限制,驻军建筑开火位置修复

  • E1 Elite - TileSet 255以上桥梁维修修复

  • FS-21 - debug信息输出增强,建筑断电子机坠毁,子机最大航程,脚本动作71到113,心灵控制部署修复,帮助书写说明书,自动乘客删除

  • AutoGavy - 拦截者逻辑,弹头暴击伤害系统

  • ChrisLv_CN - 拦截者逻辑,激光尾迹,激光修复,一般协助(协议部分请见库的声明

  • Xkein - 一般协助,YRpp编辑

  • thomassneddon - 一般协助

  • Starkku - 弹头护盾穿透与破坏,飞机扫射武器自定义,载具DeployFire修复与升级,静止载具,Burst逻辑升级,单位自动开火,副武器推算机顶一,武器瞄准类型筛选,AreaFire瞄准自定义,CreateUnit升级,附加动画和Jumpjet浮动图层自定义,IsSimpleDeployer增强,护盾修改弹头,弹头解除隐身开关

  • SukaHati (Erzoid) - 拦截者最小警戒距离

  • Morton (MortonPL) - XDrawOffset (X轴动画偏移),护盾穿透和吸收,虚拟投放建筑,art单位读取Image,电力变动指示器

  • mevitar - 荣誉护盾测试员三重奖章

  • Damfoos - 广泛的深度测试

  • 东方崛起社区 - 对开发中功能的广泛游戏测试

  • Chasheen (Chasheenburg) - 中文说明书翻译

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