Satisfactory国区社群MOD开发环境准备指引
置顶
幸福工厂


本稿件首发于踩蘑菇社区Satisfactory版区,未经许可,请勿转载。。!

 

各位厂长大家好,本猫是可爱的乖猫猫Liwers,这次给大家带来的是Satisfactory国区社群MOD开发环境准备指引。。

 

在进入教程之前,请允许本猫感谢以下为本教程提供技术支持与帮助的玩家们:

- 崩坏3的BWIKI行政员,【小鸟游六花】,帮助下载工厂官方定制版虚幻引擎4

- 踩蘑菇翻译组,【ttonmg】,提供指引内容初翻文件

- 踩蘑菇MOD组,【枫雨】,提供Wwise启动器安装程序与新手项目压缩包文件

- 踩蘑菇技术外援,【woshimj001】,提供工厂MOD加载工具汉化版安装程序

 

〇、前言

 

Satisfactory作为一款机制创新游戏,在开发过程中,为了将资源偏向机制的稳定性测试,其内容缺失可以视为正常情况。好在官方也深知这一情况,专门派出两个程序员,建立了Satisfactory官方MOD平台,用于指导MOD制作者和使用者、同时收录各个MOD作品、并提供最新的技术支持服务。

需要注意的是,由于MOD由制作者们独立开发,在获得技术支持以外,基本所有和MOD制作有关的技术,制作者都要懂——用十项全能来形容并不为过,制作者不仅要有模型、声效和视效经验,还要能够独立完成MOD的逻辑编写、封包、测试、关联与上传宣发工作。。

 

为了方便MOD制作者们开启MOD制作之旅,官方专门撰写了MOD开发环境准备指引。。然而,该指引中有非常多的坑,字里行间中的指代不清、指向不明十分常见,对MOD新手有着很强的迷惑性和误导性。。

 

如此,为了达到本猫撰写教程方案的合格标准,本猫趟过了所有这些坑。。!本篇教程会事无巨细地将MOD开发环境准备流程中的每一个步骤,都清楚地展现在各位面前。。

 

一、准备工作

 

首先需要明确的是,Satisfactory的MOD开发,建立在一系列特定的开发环境之中。官方定义了需要用到的软件的特定版本和设置方法,如果不按照这一特定方案完成安装,可能导致制作出来的MOD无法在游戏中运行、无法载入游戏、甚至游戏直接崩溃的问题。。

 

你的计算机需要准备10个G的硬盘空间,将会用到如下5方面的软件:

① Visual Studio

推荐使用VS 2019 Community。。这是微软推出的开发工具包,主要的编程工作都在该软件中进行

 

②官方定制版虚幻引擎4

需要注册GITHUB并在EPIC Games的账户管理中与其关联才能下载,注册完成登陆后点击以下链接下载链接:https://GitHub.com/SatisfactoryModdingUE/UnrealEngine/releases

需要下载的文件名称UnrealEngine-CSS-Editor-Win64.exe

 

③Wwise启动器

Satisfactory使用的商用音效引擎启动与集成工具,可以登录 https://wwise.com/ 注册下载

 

④新手项目

为方便MOD制作新手快速上手MOD制作,官方发布了一个新手项目

https://GitHub.com/satisfactorymodding/SatisfactoryModLoader/releases

找到其中最新发布的文件,下载以下名称的文件

SML-Shipping-Dev-Win64.zip

 

⑤SML与Bootstrapper

这两项文件可以通过咱发布的MOD加载工具汉化版中自动完成安装

 

具体的安装步骤将在下文详细说明。。

 

二、MOD唯一名称

 

MOD制作者可以按自己的心意,随意给自己的MOD取怎样五花八门的名字都可以。。但是对于计算机而言,MOD文件必须按照一特定方案命名,相关软件才能够识别和读取,关联MOD才能够互相调用和稳定运行。。

官方将该唯一名称,叫做MOD reference,即MOD引用名。。其有如下规则:

- MOD引用名中不允许出现空格和特殊字符,如@#$%^等。

- 从使用虚幻引擎开发该MOD开始,MOD引用名就用于源文件夹、MOD文件名、MOD文件类型名、乃至上传MOD至MOD平台。。

- MOD引用名有如下示例。。

-- MOD名称: Example Mod

--- MOD引用名称: ExampleMod

-- MOD名称: Fart’s very aweful Mod

--- MOD引用名称: FartsVeryAwefulMod

 

如无特别说明,则本教程中所称的MOD名称,皆为MOD引用名。。

 

三、VS 2019 Community 安装流程

 

对于不知知么么是VS的玩家完全不需要担心,只需要去搜索引擎里,搜索VS2019,显示绿色的网址中为microsoft,就是VS2019的正版下载网页。。

 

 

进入网页后,可以看到网页中间有一个倒三角下拉选项,点开来,将出现三个选项。。咱选择第一个,Community 2019。。

 

 

跳转到下载页面,会自动唤起浏览器的下载功能,此时按你自己的习惯选择下载路径即可完成下载。。

 

 

下载完成后,咱可以看一眼这个安装包的属性。。实际上下载下来的,是一个在线安装器,它可以根据用户的配置方案,自行完成所需安装包的下载工作。。

 

 

双击该安装器,会出现一个隐私声明与软件许可条款提示窗口,点击继续。。

 

 

接着,安装器会把基础安装工具远程下载到你的电脑上。。

 

 

下载完毕后,就会提示一切即将准备就绪。。

 

 

完成基础安装工具下载的安装器,会显示具体的安装内容控制界面。。

 

 

在这之中,咱需要勾选【使用C艹的桌面开发】和【使用C艹的游戏开发】。。右侧的安装详细信息无需理会,不是本安装流程的内容。。

 

 

点击安装,来到语言包选择界面。。默认情况下,安装工具自动选择了中文(简体)。。如果你有需求,比如说为了更好地适应英文版的教程,可以多选择一个英语语言包。。并不会增加多少硬盘空间的占用。。

 

 

继续点击安装,就到了安装位置的选择界面。。为了方便各位学习如何完成安装步骤,本猫所有的安装位置都选择了默认,即不作出任何改动。。

 

 

再次点击安装,安装工具就开始自动从服务器上远程下载配置所需的安装文件了。。这需要等待一段时间,按照指引原文的意思,“你可以趁此时间去领养一只蜥蜴多哥”。。

 

 

下载的同时,安装工具会把先完成下载的文件进行安装。。

 

 

安装完成后,VS 2019会要求你进行重启。。须知,不重启将无法完成安装,亦无法完成配置工作。。

 

 

那么重启完后,VS 2019的安装流程结束。。

 

四、官方定制版虚幻引擎4安装流程

 

这一流程,简单来说就是注册【GitHub】和【Epic Games】的账号,然后将两者关联起来,就可以下载工厂官方定制好的虚幻引擎4了。。但由于GitHub的界面是全英的,为了方便各位玩家快速完成注册,本猫还是对整个流程进行了全部截图。。

 

首先,和VS 2019一样,百度搜索GitHub,进入网站,就可以看到其注册界面。。

 

 

填入登录用的昵称、邮箱和密码后,点击Sign up to GitHub,就会跳转到账号验证界面。。这方面就不用多说了,如果已被注册,就会提示换一个昵称或邮箱;如果验证通过了,就会显示一个打√的页面。。有时候你可能会遇到一个奇葩的验证方式,按照提示完成验证即可。。

 

 

验证完成后,点击√下方的Join a free plan,就会跳转到GitHub欢迎页面了。。在这个页面中,会要你选择你的编程背景,其实随便选就可以了。。

 

 

选择完以后,就会进入到邮箱验证环节。。点击Send verification email,接着进入到你自己的邮箱中查看验证邮件就可以了。。

 

 

邮箱验证通过后,会跳转到“你想先开始干个啥。。?”的页面。。这里咱点击下方的Skip this for now >。。

 

 

GitHub账号的注册到这里就完成了。。接下来是Epic Games账号的注册,其流程大致与GitHub相仿,只不过界面是中文的,就更加方便各位完成注册。。注册完成后,下载安装Epic Games Launcher,也就是Epic平台,登录注册时使用的邮箱与密码,完成登录后,点击平台界面左下角的账号头像,接着选中弹出窗口中的【管理账户】。。

 

 

管理账户会启动浏览器,显示你Epic账户的相关信息。。看到左边那个导航栏,其中倒数第三项叫做【连接】。。

 

 

点击连接,就可以看到一系列平台账号的关联选项了。。咱这里需要的就是与GitHub账号连接。。

 

 

点击GitHub账号连接,会提示要验证电子邮件地址才可以进行关联。。也可能不需要这一步,如果你之前有过其他的邮箱验证行为的话。。

 

 

验证完邮箱后,页面会提示你选择虚幻引擎许可协议中的一个。。Publishing指的是发售,Creators则是制作。。由于各位是MOD制作者,则选Creators这一项就可以了。。

 

 

选择好后,又是习以为常的条款同意界面,点击【我同意】即可。。

 

 

继而显示的是你之前几个动作的信息确认。。点击关联账户。。

 

 

最后就完成关联了,这时GitHub连接选项会从蓝色变成深灰色。。就表示关联成功了。。

 

 

回到GitHub页面来,你会收到来自Epic Games的组织邀请。。点击Join Epic Games,就能够加入其GitHub开发群组。。

 

 

当页面顶部显示You are now a member of Epic Games!,就说明关联流程如期完成了。。

 

 

这时候,进入到上文所说的官方定制版虚幻引擎4下载页面中。。

https://GitHub.com/SatisfactoryModdingUE/UnrealEngine/releases

 

 

如果之前你没有完成两边账号的关联,那么当前的这个下载页面是找不到的,会显示404错误。。如果显示正常,那么点击UnrealEngine-CSS-Editor-Win64.exe,开始下载。。

 

 

这个引擎安装包挺大的,有1.1G。。

 

 

双击虚幻引擎4安装包,就开始了4.22.3版本的安装步骤。。

 

 

选择安装路径、选择是否要在桌面生成快捷方式、以及确认这两个选项的信息正误。。都选好后,就开始进行安装。。还是那句话,“趁此时间去给蜥蜴多哥找个古莓吃吃吧”。。

 

 

安装完成后,会提示你是否要立即启动虚幻引擎4。。本猫建议你暂时不要启动,也就是把√去掉,再点击Finish完成安装。。

 

 

五、Wwise安装流程

 

好了,现在到了喜闻乐见的Wwise安装阶段了。。需要各位知知的是,Wwise的服务器连接速度非常的慢,这不仅表现在其网页上,同时也体现在其重要的启动与加载工具上。。本猫完成这个安装用了4个多钟,为了不让各位再受一次这样的苦,本猫会放出已经提前下载好的本地安装包供各位直接使用。。

 

 

当然,流程咱还是要看一遍的。。和上述一样,搜索Wwise,进入其官方网站audiokinetic.com。。

 

 

点击右上角的登入,由于是第一次注册,这里点击验证框下方的【加入】。。

 

 

那又是一次账号密码的输入,这就不用再次赘述了。。

 

 

接着下载Wwise启动器,下载完以后就是这样一个名称。。

 

 

双击打开,会显示Wwise launcher载入界面。。

 

 

首先大家能看到的,是Wwise的动态博客主页。。如果你真的想看的话,右上角可以调整博客的显示语言。。

 

 

点击上部导航栏中的WWISE,进入Wwise版本控制界面。。如果你没有安装过任意版本的Wwise,启动器将会调取服务器上的所有版本信息。。

 

 

调取完以后,就可以看到其提示的版本以及安装按钮了。。

 

 

注意在这个时候可别手贱直接点击Install了。。工厂是用的是一个特定版本的Wwise,点击Latest打开下来菜单,里面出现了All,和不可选择的Special。。

 

 

点选All,在右侧的大版本控制项中选择2019.1,再继续选择2019.1.7.7135。。这个就是工厂是用的Wwise版本。。

 

 

点击Install,Wwise启动器就会向安装服务器发送请求。。

 

 

从安装服务器上获取信息后,就会进入Wwise安装配置界面。。在这里,选中左侧选项中的Authoring和SDK(C艹),选中后者时会提示没有选择deployment Platforms,那就继续到右侧选项中,选中Apple-macOS、Microsoft-Windows-Visual Studio 2015/Visual Studio 2017。。再下方是安装路径,以及整个安装所需的硬盘空间。。

 

 

点击Install,接着又一次向安装服务器发送请求。。

 

 

在开始正式安装前,Wwise启动器会询问,是否要安装PLUG-INS。。这里不需要安装任何的plug-ins,如果你看到启动器自动勾选了Wwise Convolution,请把其后面的√消去。。

 

 

再次点击Install,出现的就是条款信息了。。此处点击Accept即可。。

 

 

这时终于开始了Wwise 2019.1.7.7135的安装了。。就如本猫上述所说,这个慢兮兮的云安装,耗了接近4个钟的时间。。

 

 

Wwise安装完成以后,就会显示绿色的安装成功提示了。。

 

 

六、新手项目的集成、编译、修改与打包测试

 

好了,终于到了MOD开发环境中的重头戏了。。!

 

为了方便玩家制作MOD,官方搭建了一个完整的MOD项目文件树,用于给玩家进行MOD创作与内容添加。。可以理解为,这是一个文件结构完整但内容为0的项目框架。。

 

同样的,该新手项目放在了GitHub上,不过和需要双账号关联的虚幻引擎4不同,这个新手项目只要进入指定网页就能够进行下载。。

 

https://github.com/satisfactorymodding/SatisfactoryModLoader/releases

 

 

点击SML-Shipping-Dev-Win64.zip就能启动该新手项目的下载了。。

 

 

下载完成后,可以看到是一个压缩包。。双击打开,可以看到其中一项文件叫做FactoryGame.uproject,这个就是新手项目的关键文件,下面的步骤将重点围绕其展开。。

 

在你的电脑里开一个专门用来存放和管理MOD文件的文件夹,比如说本猫,就在F盘中新建了一个SatisfactoryModdingContents文件夹。。将刚才的压缩包以文件夹形式解压进去。。

 

 

打开Wwise启动器,选择导航栏中的UNREAL ENGINE,在标题栏右侧的三道短杠上点击,展开下拉选项单。。

 

 

点选Browse for project,找到你刚刚解压出的项目文件夹,选中其中的uproject文件。。

 

 

接着Wwise启动器就会显示Wwise集成准备界面。。

 

 

点击界面中的蓝色长条,就可以转到Wwise集成进项目文件的配置选择界面。。

 

 

别忘了咱需要用那个特定的Wwise版本。。同样是点击Latest,出现版本控制选项。。

 

 

按照之前的方法,选择到2019.1.7.7135版本。。

 

 

在下方的Wwise Project Path后的倒三角上点击,选择New,以清空Path。。

 

 

同时,点击Copy of Wwise SDK files后的倒三角,选择Install,就会加载刚刚安装好的Wwise本地集成工具安装路径。。

 

 

点击Integrate,出现条款告知窗口。。

 

 

点击Accept,就会开始进行集成。。如果刚才没有选择本地集成工具,那么Wwise启动器就会尝试在线集成。。意思就是要等好久好久的那种。。

 

 

集成完成,就会显示成功信息。。

 

 

看到刚才新手项目解压所在的文件夹,可以看到,其中出现了一个新的写着Wwise的文件夹。。

 

 

由于每一个新手项目在进行创作前,这一步集成Wwise的过程都是一样的。。那么咱可以保留这个集成过的文件夹不变,下次直接复制这个文件夹修改,就可以省去Wwise集成这一步了。。现在,复制一整个集成后的新手项目文件夹,然后改个名字——就按本教程第二章中【MOD唯一名称】的规则来改,比如说本猫这里就改为了TestMod。。

 

 

而刚才集成完成后,除了新生成的Wwise集成文件夹外,该集成文件夹下还生成了两个包含新手项目文件夹名称的文件。。

 

 

既然现在咱把这个项目文件夹复制了一份且改了名,那么其中的集成文件夹和两个集成文件也当然需要改名了。。

 

 

记住哦,MOD唯一名称设立之后,你的电脑将只认这一个名称。。千万记得别再改成其他名称了,否则可能会发生无法识别MOD组件甚至文件数据丢失的事故。。

 

之前说过,MOD开发的主要编程工作都是在VS里进行的。。但是现在这个空的uproject文件是无法在VS中编辑的,因此,咱需要为它生成对应的VS文件。。

 

通过你所设置的虚幻引擎4安装路径,找到虚幻引擎4的安装目录。。打开Engine-Binaries-DotNET,看到UnrealBuildTool.exe。。

 

 

随便找个地方新建一个记事本文件,把

"<虚幻引擎的工具路径>"文档名称-projectfiles -project=".uproject文件路径" -game -rocket -progress

这段命令复制进去。。

 

将刚刚获知的UnrealBuildTool.exe的文件路径替换掉这个<虚幻引擎的工具路径>,双引号不要删掉。。同时打开你刚才新更名的新手项目文件夹,把其中的uproject文件路径,也替换掉这个 .uproject文件路径。。如果你全部都用的是默认安装路径,那么结果应该是这样的。。

 

 

注意不要换行,否则无法正确使用。。

 

你可以使用搜索功能,或者直接按Win键+R启动运行栏。。两种都行,在输入框中打进cmd,然后按回车,启动命令提示符。。

 

 

命令提示符启动后,可以看到一闪一闪的光标。。

 

 

将刚才的命令整句复制,然后粘贴到命令提示符内。。

 

 

按下回车键,命令提示符就会开始执行命令,自动生成VS文件。。

 

 

用于编程的VS文件生产完毕以后,咱还要接着生成用于虚幻编辑器中的可编辑文件。。打开新手项目文件夹,可以发现其中新增了一个sln文件。。

 

 

双击打开sln文件,第一次使用VS,它会引导你选择界面风格、配色这之类的。。如果初次选择完成后未成功加载的,那就关掉VS,重新再双击sln文件,直到打开这样一个界面。。

 

 

右侧显示出FactoryGame就代表该项目成功加载了。。此时看到顶部工具栏的两个选项,保证选择了Development Editor和Win64。。

 

 

看向右侧的解决方案资源管理器,点选其中的FactoryGame。。

 

 

对齐单击右键,在弹出的窗口中选择生成。。

 

 

这时候,VS会开始自动生成可编辑文件。。

 

 

生成完以后,可以看到在新手项目文件夹下,出现了一个.vs文件夹,其中就是刚刚生成的VS关联文件。。

 

 

接着,按下你的Win键,找到你安装好的Unreal Engine - CSS。。

 

 

点击运行这个程序,这个就是虚幻编辑器。。加载过程中,Windows防火墙可能会多次询问要给予虚幻编辑器如何的网络访问权限,按照你的使用习惯给予即可。。

 

 

需要注意的是,第一次使用虚幻编辑器,其会调用CPU进行着色器编译。。其结果就是,CPU瞬间跑满。。

 

 

顺利进入虚幻编辑器后,首先映入眼帘的是虚幻项目浏览器。。点击上方的【项目】标签卡,看向右下角的【浏览】按钮。。

 

 

点击浏览,找到你新手项目文件夹中的uproject文件。。

 

 

点击打开,就会把整一个新手项目中的可编辑文件,全部载入到虚幻编辑器当中。。

 

 

要方便管理你的MOD内容和各种素材,你需要一个与MOD唯一名称相同的管理文件夹。。点击左下的【新增】按钮,看到上方第二个【新增文件夹】。。

 

 

点击【新增文件夹】,虚幻编辑器会在下方的文件夹导航栏中直接新建一个文件夹出来,你需要将其改成你MOD的唯一名称。。而在新手项目文件夹中,可以看到,在Content文件夹中,是生成了这个新的管理文件夹的。。

 

 

那么截止这一步,你就已经可以对MOD进行编辑了,你想在其中加入么么内容,整个编辑器都供你随意使用。。

 

对于如何使用虚幻编辑器,本猫建议你看看编辑器右上方一直闪着绿色光圈的新手教程提示,或者可以去B站看看【虚幻编辑器官方】的教程视频。。

 

如果你做完了MOD,该如何打包整合进游戏进行测试呢。。?这就需要用到一个叫做Alpakit的工具。。它是由MOD社区推荐,图标看起来像一只把身子藏进快递箱的草泥马。。

 

 

可以在虚幻编辑器的顶端导航栏找到这个工具,点开之后,首先它会让你选中你工厂游戏的安装根目录。。

 

 

一般来说,如果是默认安装,那么游戏是会放在Program Files的Epic Games文件夹中的。。

 

 

选择根目录后,Start Game是指打包完成直接启动游戏,Copy Mods to Game是指把MOD文件自动复制到游戏文件夹中。。

 

下方的数组元素指的是你这个MOD有多少个关联MOD,如果为1,就是指该MOD本身。。你这时候可以填入MOD的介绍信息。。Name中要填MOD唯一名称,Display Name则是MOD的介绍名称,比如本猫填的就是Test。。

 

Description是MOD的简短介绍,本猫写的是 As you see, this is a test..。。接下来你还能设定该MOD的版本,以及作者是谁。。

 

注意:一蛋填写并打包后,这些信息是无法更改的。。!

 

 

全部写好以后,就点击窗口右下角的Alpakit!。。虚幻编辑器就会自动提示,正在Cooking content。。打包好了以后,就会显示Done的提示。。

 

 

如上就是新手项目的整一套基础流程,但是在正式开始写MOD之前,还有最后一步:单纯把MOD项目打包复制到游戏文件夹是没有用的,因为游戏读不到你这个MOD。。

 

这时候就需要用到由工厂MOD社区自行开发的Satisfactory Mod Launcher,简称SML。。获取这个组件的方法,已经写在了Satisfactory汉化版MOD加载工具的使用教程里了,各位可以自行取用。。

 

http://www.caimogu.net/post/11032.html

 

想要让游戏关联上你新写好的MOD,需要在MOD加载工具里的【选择项目】中,选择development,开启开发者模式。。

 

然后,你随便下载个mod,加载工具就会自动安装SML和相关组件。。这时,你需要至少进入游戏一次,让SML生效。。

 

SML生效后,就会在你工厂的安装路径中,生成一个configs文件夹。。该文件夹将包含所有MOD的配置文件,当然SML的配置文件也会在其中。。

 

 

用写字板打开这个SML.cfg文件,看向developmentMode后面的false。。

 

 

将false改成true,然后按保存。。

 

 

如此,你的游戏就能顺利识别到你的MOD,并在游戏中显示相关的测试结果了。。

 

那么恭喜你,看到这里,说明你已经掌握了工厂MOD开发环境准备工作中的所有内容了。。!

 

七、总结

 

本教程中各步骤的总流程图如下。。

 

 

八、下载指南

 

由于下载过程实在是太麻烦太多坑了,为了方便各位能够有更多的时间让给新手入门,本猫已经将文中提到的各个安装包上传到了附件中。。

 

如果你没有在本帖看到任何附件,是因为附件仍在上传当中。。

 

在此,本猫想提出一个工厂版区的《影响力管理标准 暂行方案》:

1、对于玩家可以凭借自身能力获得的附件内容,建议不要求任何影响力支付;

2、对于玩家难以凭借自身能力获得的附件内容,建议设置不少于1点影响力支付要求;

3、对于必须依靠其他玩家才可以获得的附件内容,建议设置多于1点影响力支付要求。。

 

以本帖为例:

1、先期上传的是 不需要影响力的 启动器与压缩包,这些安装包是玩家自己也能获取的;

2、二期上传的是 包含本地安装包 的启动器与Wwise预集成文件,节省了玩家等待下载和集成Wwise所需要的时间,该附件将设置需要1点影响力支付;

3、三期上传的是 编译好的VS文件 和 虚幻4可编辑文件,由于编译十分耗时,且对电脑配置要求稍高,特放出编译好的项目文件,方便各位玩家直接进行MOD创作。。该附件将设置需要3点影响力支付。。

 

感谢各位耐心读完整篇工厂MOD开发环境准备指引,欢迎各位玩家前来融入工厂MOD开发的大家庭中。。!

 

喵。。!


附件
包含了Wwise本地安装文件和已集成Wwise的项目文件的MOD开发环境安装包
1影响力
附件
MOD开发环境源安装包
免费
by 可爱的乖猫猫Liwers 发布于 2020-07-23
打赏后可直接下载附件 赠人玫瑰 手留余香
默认
最新
1