Satisfactory國區(qū)社群MOD開發(fā)環(huán)境準備指引

*本文著作權歸屬于Satisfactory國區(qū)社群,由踩蘑菇社區(qū)Satisfactory版區(qū)首發(fā)。。未經許可,請勿轉載。。!
原貼地址為:http://www.caimogu.net/post/11827.html
各位廠長大家好,本貓是可愛的乖貓貓Liwers,這次給大家?guī)淼氖荢atisfactory國區(qū)社群MOD開發(fā)環(huán)境準備指引。。
?
在進入教程之前,請允許本貓感謝以下為本教程提供技術支持與幫助的玩家們:
- 崩壞3的BWIKI行政員,【小鳥游六花】,幫助下載工廠官方定制版虛幻引擎4
- 踩蘑菇翻譯組,【ttonmg】,提供指引內容初翻文件
- 踩蘑菇MOD組,【楓雨】,提供Wwise啟動器安裝程序與新手項目壓縮包文件
- 踩蘑菇技術外援,【woshimj001】,提供工廠MOD加載工具漢化版安裝程序
?
〇、前言
?
Satisfactory作為一款機制創(chuàng)新游戲,在開發(fā)過程中,為了將資源偏向機制的穩(wěn)定性測試,其內容缺失可以視為正常情況。好在官方也深知這一情況,專門派出兩個程序員,建立了Satisfactory官方MOD平臺,用于指導MOD制作者和使用者、同時收錄各個MOD作品、并提供最新的技術支持服務。
需要注意的是,由于MOD由制作者們獨立開發(fā),在獲得技術支持以外,基本所有和MOD制作有關的技術,制作者都要懂——用十項全能來形容并不為過,制作者不僅要有模型、聲效和視效經驗,還要能夠獨立完成MOD的邏輯編寫、封包、測試、關聯與上傳宣發(fā)工作。。
?
為了方便MOD制作者們開啟MOD制作之旅,官方專門撰寫了MOD開發(fā)環(huán)境準備指引。。然而,該指引中有非常多的坑,字里行間中的指代不清、指向不明十分常見,對MOD新手有著很強的迷惑性和誤導性。。
?
如此,為了達到本貓撰寫教程方案的合格標準,本貓?zhí)诉^了所有這些坑。。!本篇教程會事無巨細地將MOD開發(fā)環(huán)境準備流程中的每一個步驟,都清楚地展現在各位面前。。
?
一、準備工作
?
首先需要明確的是,Satisfactory的MOD開發(fā),建立在一系列特定的開發(fā)環(huán)境之中。官方定義了需要用到的軟件的特定版本和設置方法,如果不按照這一特定方案完成安裝,可能導致制作出來的MOD無法在游戲中運行、無法載入游戲、甚至游戲直接崩潰的問題。。
?
你的計算機需要準備10個G的硬盤空間,將會用到如下5方面的軟件:
① Visual Studio
推薦使用VS 2019 Community。。這是微軟推出的開發(fā)工具包,主要的編程工作都在該軟件中進行
?
②官方定制版虛幻引擎4
需要注冊GITHUB并在EPIC Games的賬戶管理中與其關聯才能下載,注冊完成登陸后點擊以下鏈接下載鏈接:https://GitHub.com/SatisfactoryModdingUE/UnrealEngine/releases
需要下載的文件名稱UnrealEngine-CSS-Editor-Win64.exe
?
③Wwise啟動器
Satisfactory使用的商用音效引擎啟動與集成工具,可以登錄 https://wwise.com/ 注冊下載
?
④新手項目
為方便MOD制作新手快速上手MOD制作,官方發(fā)布了一個新手項目
https://GitHub.com/satisfactorymodding/SatisfactoryModLoader/releases
找到其中最新發(fā)布的文件,下載以下名稱的文件
SML-Shipping-Dev-Win64.zip
?
⑤SML與Bootstrapper
這兩項文件可以通過咱發(fā)布的MOD加載工具漢化版中自動完成安裝
?
具體的安裝步驟將在下文詳細說明。。
?
二、MOD唯一名稱
?
MOD制作者可以按自己的心意,隨意給自己的MOD取怎樣五花八門的名字都可以。。但是對于計算機而言,MOD文件必須按照一特定方案命名,相關軟件才能夠識別和讀取,關聯MOD才能夠互相調用和穩(wěn)定運行。。
官方將該唯一名稱,叫做MOD reference,即MOD引用名。。其有如下規(guī)則:
- MOD引用名中不允許出現空格和特殊字符,如@#$%^等。
- 從使用虛幻引擎開發(fā)該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。。

跳轉到下載頁面,會自動喚起瀏覽器的下載功能,此時按你自己的習慣選擇下載路徑即可完成下載。。

下載完成后,咱可以看一眼這個安裝包的屬性。。實際上下載下來的,是一個在線安裝器,它可以根據用戶的配置方案,自行完成所需安裝包的下載工作。。

雙擊該安裝器,會出現一個隱私聲明與軟件許可條款提示窗口,點擊繼續(xù)。。

接著,安裝器會把基礎安裝工具遠程下載到你的電腦上。。

下載完畢后,就會提示一切即將準備就緒。。

完成基礎安裝工具下載的安裝器,會顯示具體的安裝內容控制界面。。

在這之中,咱需要勾選【使用C艸的桌面開發(fā)】和【使用C艸的游戲開發(fā)】。。右側的安裝詳細信息無需理會,不是本安裝流程的內容。。

點擊安裝,來到語言包選擇界面。。默認情況下,安裝工具自動選擇了中文(簡體)。。如果你有需求,比如說為了更好地適應英文版的教程,可以多選擇一個英語語言包。。并不會增加多少硬盤空間的占用。。

繼續(xù)點擊安裝,就到了安裝位置的選擇界面。。為了方便各位學習如何完成安裝步驟,本貓所有的安裝位置都選擇了默認,即不作出任何改動。。

再次點擊安裝,安裝工具就開始自動從服務器上遠程下載配置所需的安裝文件了。。這需要等待一段時間,按照指引原文的意思,“你可以趁此時間去領養(yǎng)一只蜥蜴多哥”。。

下載的同時,安裝工具會把先完成下載的文件進行安裝。。

安裝完成后,VS 2019會要求你進行重啟。。須知,不重啟將無法完成安裝,亦無法完成配置工作。。

那么重啟完后,VS 2019的安裝流程結束。。
四、官方定制版虛幻引擎4安裝流程
?
這一流程,簡單來說就是注冊【GitHub】和【Epic Games】的賬號,然后將兩者關聯起來,就可以下載工廠官方定制好的虛幻引擎4了。。但由于GitHub的界面是全英的,為了方便各位玩家快速完成注冊,本貓還是對整個流程進行了全部截圖。。
?
首先,和VS 2019一樣,百度搜索GitHub,進入網站,就可以看到其注冊界面。。

填入登錄用的昵稱、郵箱和密碼后,點擊Sign up to GitHub,就會跳轉到賬號驗證界面。。這方面就不用多說了,如果已被注冊,就會提示換一個昵稱或郵箱;如果驗證通過了,就會顯示一個打√的頁面。。有時候你可能會遇到一個奇葩的驗證方式,按照提示完成驗證即可。。

驗證完成后,點擊√下方的Join a free plan,就會跳轉到GitHub歡迎頁面了。。在這個頁面中,會要你選擇你的編程背景,其實隨便選就可以了。。

選擇完以后,就會進入到郵箱驗證環(huán)節(jié)。。點擊Send verification email,接著進入到你自己的郵箱中查看驗證郵件就可以了。。

郵箱驗證通過后,會跳轉到“你想先開始干個啥。。?”的頁面。。這里咱點擊下方的Skip this for now >。。

GitHub賬號的注冊到這里就完成了。。接下來是Epic Games賬號的注冊,其流程大致與GitHub相仿,只不過界面是中文的,就更加方便各位完成注冊。。注冊完成后,下載安裝Epic Games Launcher,也就是Epic平臺,登錄注冊時使用的郵箱與密碼,完成登錄后,點擊平臺界面左下角的賬號頭像,接著選中彈出窗口中的【管理賬戶】。。

管理賬戶會啟動瀏覽器,顯示你Epic賬戶的相關信息。??吹阶筮吥莻€導航欄,其中倒數第三項叫做【連接】。。

點擊連接,就可以看到一系列平臺賬號的關聯選項了。。咱這里需要的就是與GitHub賬號連接。。

點擊GitHub賬號連接,會提示要驗證電子郵件地址才可以進行關聯。。也可能不需要這一步,如果你之前有過其他的郵箱驗證行為的話。。

驗證完郵箱后,頁面會提示你選擇虛幻引擎許可協議中的一個。。Publishing指的是發(fā)售,Creators則是制作。。由于各位是MOD制作者,則選Creators這一項就可以了。。

選擇好后,又是習以為常的條款同意界面,點擊【我同意】即可。。

繼而顯示的是你之前幾個動作的信息確認。。點擊關聯賬戶。。

最后就完成關聯了,這時GitHub連接選項會從藍色變成深灰色。。就表示關聯成功了。。

回到GitHub頁面來,你會收到來自Epic Games的組織邀請。。點擊Join Epic Games,就能夠加入其GitHub開發(fā)群組。。

當頁面頂部顯示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的動態(tài)博客主頁。。如果你真的想看的話,右上角可以調整博客的顯示語言。。

點擊上部導航欄中的WWISE,進入Wwise版本控制界面。。如果你沒有安裝過任意版本的Wwise,啟動器將會調取服務器上的所有版本信息。。

調取完以后,就可以看到其提示的版本以及安裝按鈕了。。

注意在這個時候可別手賤直接點擊Install了。。工廠是用的是一個特定版本的Wwise,點擊Latest打開下來菜單,里面出現了All,和不可選擇的Special。。

點選All,在右側的大版本控制項中選擇2019.1,再繼續(xù)選擇2019.1.7.7135。。這個就是工廠是用的Wwise版本。。

點擊Install,Wwise啟動器就會向安裝服務器發(fā)送請求。。

從安裝服務器上獲取信息后,就會進入Wwise安裝配置界面。。在這里,選中左側選項中的Authoring和SDK(C艸),選中后者時會提示沒有選擇deployment Platforms,那就繼續(xù)到右側選項中,選中Apple-macOS、Microsoft-Windows-Visual Studio 2015/Visual Studio 2017。。再下方是安裝路徑,以及整個安裝所需的硬盤空間。。

點擊Install,接著又一次向安裝服務器發(fā)送請求。。

在開始正式安裝前,Wwise啟動器會詢問,是否要安裝PLUG-INS。。這里不需要安裝任何的plug-ins,如果你看到啟動器自動勾選了Wwise Convolution,請把其后面的√消去。。

再次點擊Install,出現的就是條款信息了。。此處點擊Accept即可。。

這時終于開始了Wwise 2019.1.7.7135的安裝了。。就如本貓上述所說,這個慢兮兮的云安裝,耗了接近4個鐘的時間。。

Wwise安裝完成以后,就會顯示綠色的安裝成功提示了。。

六、新手項目的集成、編譯、修改與打包測試
?
好了,終于到了MOD開發(fā)環(huán)境中的重頭戲了。。!
?
為了方便玩家制作MOD,官方搭建了一個完整的MOD項目文件樹,用于給玩家進行MOD創(chuàng)作與內容添加。??梢岳斫鉃?,這是一個文件結構完整但內容為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的文件夾。。

由于每一個新手項目在進行創(chuàng)作前,這一步集成Wwise的過程都是一樣的。。那么咱可以保留這個集成過的文件夾不變,下次直接復制這個文件夾修改,就可以省去Wwise集成這一步了?!,F在,復制一整個集成后的新手項目文件夾,然后改個名字——就按本教程第二章中【MOD唯一名稱】的規(guī)則來改,比如說本貓這里就改為了TestMod。。

而剛才集成完成后,除了新生成的Wwise集成文件夾外,該集成文件夾下還生成了兩個包含新手項目文件夾名稱的文件。。


既然現在咱把這個項目文件夾復制了一份且改了名,那么其中的集成文件夾和兩個集成文件也當然需要改名了。。

記住哦,MOD唯一名稱設立之后,你的電腦將只認這一個名稱。。千萬記得別再改成其他名稱了,否則可能會發(fā)生無法識別MOD組件甚至文件數據丟失的事故。。
?
之前說過,MOD開發(fā)的主要編程工作都是在VS里進行的。。但是現在這個空的uproject文件是無法在VS中編輯的,因此,咱需要為它生成對應的VS文件。。
?
通過你所設置的虛幻引擎4安裝路徑,找到虛幻引擎4的安裝目錄。。打開Engine-Binaries-DotNET,看到UnrealBuildTool.exe。。

隨便找個地方新建一個記事本文件,把
"<虛幻引擎的工具路徑>"文檔名稱-projectfiles -project=".uproject文件路徑" -game -rocket -progress
這段命令復制進去。。
?
將剛剛獲知的UnrealBuildTool.exe的文件路徑替換掉這個<虛幻引擎的工具路徑>,雙引號不要刪掉。。同時打開你剛才新更名的新手項目文件夾,把其中的uproject文件路徑,也替換掉這個 .uproject文件路徑。。如果你全部都用的是默認安裝路徑,那么結果應該是這樣的。。

注意不要換行,否則無法正確使用。。
?
你可以使用搜索功能,或者直接按Win鍵+R啟動運行欄。。兩種都行,在輸入框中打進cmd,然后按回車,啟動命令提示符。。


命令提示符啟動后,可以看到一閃一閃的光標。。

將剛才的命令整句復制,然后粘貼到命令提示符內。。

按下回車鍵,命令提示符就會開始執(zhí)行命令,自動生成VS文件。。

用于編程的VS文件生產完畢以后,咱還要接著生成用于虛幻編輯器中的可編輯文件。。打開新手項目文件夾,可以發(fā)現其中新增了一個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社區(qū)推薦,圖標看起來像一只把身子藏進快遞箱的草泥馬。。

可以在虛幻編輯器的頂端導航欄找到這個工具,點開之后,首先它會讓你選中你工廠游戲的安裝根目錄。。

一般來說,如果是默認安裝,那么游戲是會放在Program Files的Epic Games文件夾中的。。
?

選擇根目錄后,Start Game是指打包完成直接啟動游戲,Copy Mods to Game是指把MOD文件自動復制到游戲文件夾中。。
?
下方的數組元素指的是你這個MOD有多少個關聯MOD,如果為1,就是指該MOD本身。。你這時候可以填入MOD的介紹信息。。Name中要填MOD唯一名稱,Display Name則是MOD的介紹名稱,比如本貓?zhí)畹木褪荰est。。
?
Description是MOD的簡短介紹,本貓寫的是 As you see, this is a test..。。接下來你還能設定該MOD的版本,以及作者是誰。。
?
注意:一蛋填寫并打包后,這些信息是無法更改的。。!

全部寫好以后,就點擊窗口右下角的Alpakit!。。虛幻編輯器就會自動提示,正在Cooking content。。打包好了以后,就會顯示Done的提示。。

如上就是新手項目的整一套基礎流程,但是在正式開始寫MOD之前,還有最后一步:單純把MOD項目打包復制到游戲文件夾是沒有用的,因為游戲讀不到你這個MOD。。
?
這時候就需要用到由工廠MOD社區(qū)自行開發(fā)的Satisfactory Mod Launcher,簡稱SML。。獲取這個組件的方法,已經寫在了Satisfactory漢化版MOD加載工具的使用教程里了,各位可以自行取用。。
?
http://www.caimogu.net/post/11032.html
?
想要讓游戲關聯上你新寫好的MOD,需要在MOD加載工具里的【選擇項目】中,選擇development,開啟開發(fā)者模式。。
?
然后,你隨便下載個mod,加載工具就會自動安裝SML和相關組件。。這時,你需要至少進入游戲一次,讓SML生效。。
?
SML生效后,就會在你工廠的安裝路徑中,生成一個configs文件夾。。該文件夾將包含所有MOD的配置文件,當然SML的配置文件也會在其中。。

用寫字板打開這個SML.cfg文件,看向developmentMode后面的false。。

將false改成true,然后按保存。。
如此,你的游戲就能順利識別到你的MOD,并在游戲中顯示相關的測試結果了。。
?
那么恭喜你,看到這里,說明你已經掌握了工廠MOD開發(fā)環(huán)境準備工作中的所有內容了。。!
?
七、總結
?
本教程中各步驟的總流程圖如下。。結果發(fā)現只能上傳100張圖。。所以傳不上來了。。
八、下載指南
?
由于下載過程實在是太麻煩太多坑了,為了方便各位能夠有更多的時間讓給新手入門,本貓已經將文中提到的各個安裝包上傳到了附件中。。
請訪問首發(fā)于踩蘑菇社區(qū)的原貼,于貼子正文底部的附件中獲取相關的文件。。
http://www.caimogu.net/post/11827.html
感謝各位耐心讀完整篇工廠MOD開發(fā)環(huán)境準備指引,歡迎各位玩家前來融入工廠MOD開發(fā)的大家庭中。。!
喵。。!