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

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

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

  3. 生成扩展:

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

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

  • 其他:运行scripts/build_debug.bat

  1. 生成完成后,生成的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) - project author

  • Kerbiter (Metadorius) - 项目合作作者,项目管理员,运维,技术文件撰稿人(Patreon)

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

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

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

  • FS-21 - 开发者

  • Starkku - 开发者

贡献者

  • 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) - Mind Control enhancement, custom warhead splash list, harvesters counter, promoted spawns, shields, death after dead fix, customizeable missing cameo, cameo sorting priority, placement mode responding of tab hotkeys fix, producing progress, custom ore gathering anim, NoManualMove, weapon target house filtering, DeathWeapon fix, re-enable obsolete JumpjetControls, overhauled Unicode font, docs maintenance, CN docs translation

  • secsome (SEC-SOME) - debug info dump hotkey, refactoring & porting of Ares helper code, introducing more Ares-derived stuff, disguise removal warhead, Mind Control removal warhead, Mind Control enhancement, shields, AnimList.PickRandom, MoveToCell fix, unlimited waypoints, Build At trigger action buildup anim fix, Undeploy building into a unit plays EVA_NewRallyPointEstablished fix, custom ore gathering anim, TemporaryClass related crash, Retry dialog on mission failure, Default disguise for individual InfantryTypes, PowerPlant Enhancer, SaveGame Trigger Action, QuickSave command, Numeric variables, Custom gravity for projectiles, Retint map actions bugfix

  • Otamaa (Fahroni, BoredEXE) - help with CellSpread, ported and fixed custom RadType code, togglable ElectricBolt bolts, customizable Chrono Locomotor properties per TechnoClass, DebrisMaximums fixes, Anim-to-Unit, NotHuman anim sequences improvements, Customizable OpenTopped Properties, hooks for ScriptType Actions 92 & 93, ore stage threshold for HideIfNoOre

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

  • FS-21 - Dump Object Info enhancements, Powered.KillSpawns, Spawner.LimitRange, ScriptType Actions 71, 72, 73, 74 to 81, 92, 93, 94, 95 to 98, 111, 112, MC deployer fixes, help with docs, Automatic Passenger Deletion

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

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

  • Xkein - 一般协助,YRpp编辑

  • thomassneddon - 一般协助

  • Starkku - Warhead shield penetration & breaking, strafing aircraft weapon customization, vehicle DeployFire fixes/improvements, stationary VehicleTypes, Burst logic improvements, TechnoType auto-firing weapons, Secondary weapon fallback customization, weapon target type filtering, AreaFire targeting customization, CreateUnit improvements, Attached animation & jumpjet unit layer customization, IsSimpleDeployer improvements

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

  • Morton (MortonPL) - XDrawOffset, Shield passthrough & absorption, building LimboDelivery, fix for Image in art rules

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

  • Damfoos - 广泛的深度测试

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

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

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