This is my unofficial modding guide for HumanitZ, as of the latest game update. During the course of this detailed text guide, you will learn how to make various types of mods, according to what I have learned so far! This guide will be updated as I learn more about modding this game, so stay tuned for updates!
Rozpoczęcie pracy
To start modding HumanitZ, you will need the following tools and software:
Unreal Engine 4.27x (Preferably 4.27.2)
Link do pobrania: https://www.unrealengine.com/en-US/download
UModel
Link do pobrania: https://www.gildor.org/en/projects/umodel#files
Unrealpak
Link do pobrania: https://www.fluffyquack.com/tools/
HumanitZ Modding Toolkit
Link do pobrania: https://www.nexusmods.com/humanitz/mods/2
I recommend you put all of these tools in a folder, so you can access them in a quicker, more organized manner. I have the game installed in my D: prowadzić, so I put all the tools under a folder named “HumanitZ Modding“.
Podstawy
There are a few things you must know about modding Unreal Engine games, and more specifically HumanitZ, before you get to making the actual modding part. Let’s go over them in detail!
We cannot add new files
W tej chwili, we are unable to add new, custom files to the game as part of a mod.
This means that no matter what mod you are working on, the only way to have your mod work is for each individual file to overwrite another file that exists in the game.
Even the file structure must be the same! More on that later.
Unpacking and Packing
You will have to do a lot of both to get a mod going. This is why we will need both UModel, and the Unreal Engine itself.
We need to unpack the game’s base files, and pack our custom mod files.
Adhering to the Rules
I cannot overstate this. Your mod will not work if you do not follow the file structure of the game to a T. I mean it. Pay extreme attention to this! Na przykład, if you unpack a file that is found in:
- […]\HumanitZ\TSSGame\Content\VehicleVarietyPack\Textures
On Unreal Engine, your file must be in:
- […]\YourProjectFolder\Content\VehicleVarietyPack\Textures
Setting up your Unreal Project
Since the game is made in Unreal, your mod will also most likely require an Unreal project so that compatibility is at its best state.
Pierwszy, create your Unreal Project. Remember that file structure must remain the same! A więc, to make things easier, we will also be adhering to this when naming the project itself.
Creating the Project
Let’s create a project called “TSSGame“. That’s the name of the project on the developers’ strona.
When creating your project, wybierać “Gry” pod “New Project Categories“. Like so!
Następny, select either a “Blank” template if you prefer organization and have some experience, lub, if you are new or don’t mind extra files, I recommend either Third Person lub Top Down.
Remember to name the project “TSSGame“! To jest ważne.
Configuring the Project
W porządku! You have successfully created your Unreal Engine project… What now?
The next step is to do some basic configuration! There’s just one little thing you want to change, so don’t panic just yet!
Open your project, and at the center of the top of the screen, you will see a big gear button called “Ustawienia“. Click that.
Następny, wybierać “Project Settings“. A new window will popup. You will find a scrollable list of items on the left.
Look for the huge header saying “Projekt“, and look for a smaller category called “Opakowanie“. Click it.
Once in the “Opakowanie” Kategoria, scroll all the way to the bottom until you find a tab called “Projekt“.
You are looking for the second option from top to bottom. It is a dropdown option called “Build Configuration“.
Click it, i wybierz “Shipping“. Po tym, simply close the window, and your project is good to go!
Unpacking the Game files
Świetnie. Keep your Unreal Project open. What now?
Dobrze, we need the files you want to modify, Pamiętać?
I hope you also remember I mentioned we have to unpack them. So how do we do that? Find out below!
The Methods
Są 2 methods to unpack game files. metoda #1 will unpack the ENTIRE game in a folder. That should take about ~32.5GB worth of disk space.
If you don’t have enough space, or don’t want to bother unpacking every new update and such, just head to metoda #2!
Creating your folder
Remember that folder I recommended you create, to keep all the tools and such? Create a new folder inside it called “Unpacked Files” lub cokolwiek chcesz.
The name is up to you, Naprawdę. This is where we will store the unpackaged game files!
metoda #1 – Unpacking Everything
For this method, thankfully, ZGal88 has got us covered! They have developed the amazing Modding Toolkit, which allows you to easily unpack the entire game! Wonderful!
After installing the toolkit, Otwórz to, and you will be greeted with a screen that asks for a “Źródło“, i a “Destination“. Source must be this exact directory:
- […]\HumanitZ\TSSGame\Content\Paks
Destination will be whatever folder you want to store the unpacked files. After selecting both directories, Kliknij “Początek” and wait for completion!
Otóż to! After the process is finished, będziesz miał WSZYSTKO the game files unpacked in a single folder.
metoda #2 – Unpacking Specific Files
For this method, you will need that UModel tool I mentioned earlier!
After installing it, Otwórz to, and you will be greated with a screen that asks for a “Path to game files“.
I tak, it will also open a prompt / CMD window. Ignore that. It’s just for showing logs of what’s going on!
Set the path to game files to be this exact directory:
- […]\HumanitZ\TSSGame\Content\Paks
AES Encryption Key
You will get a warning screen that mentions the app has found an encrypted file, and you will require an AES encryption key to view it.
Bez problemu! I have it right here for you, just paste this and hit “OK“: 0x321166CACD1E2BBEAC9794AAF468DE277001D2EF8F74A8D6B3CC6EDFE87945CA
Exploring the Game Files
You will now be greeted with a screen that contains ALL the game files, ready for unpacking.
It is here that you will select which folder or files you want to unpack.
Please tidy up the mess of the file hierarchy by closing the submenus of each folder so that it looks like this:
You want to head for the Gra teczka. Want to know something about this folder? DON’T read it as “Gra“. That’s just another name for “Content“.
Zgadza się. The “Gra” folder is actually the “Content” folder in both your game directory, and your unreal engine project directory!
To preview an asset, simply double click it. The app will then attempt to show you a preview of the asset. This works for meshes, materiały, tekstury oraz animations.
Other stuff isn’t recognized, Niestety. In the screenshot below I have found the mesh z white box truck!
Once you have found a file and clicked to preview it, you will be prompted by the app to select the version of the package, because it couldn’t find it on its own.
That’s normal. Select version 4.27 at the very bottom of the list. Like so:
Would you look at that! We are now previewing the truck mesh! W porządku, that’s what we want right there! Ale… how to go back?
That’s easy. On the lewy górny, Kliknij “Plik“, i wtedy “Open Package“. That will return to the window we were before, where you can select which files to handle.
Once you have isolated a file, or many files, or even a folder, just right click it and select “Export“.
You will be prompted to select a folder to put the extracted files in. Otóż to! That’s how you unpack specific things instead of everything!
Wreszcie… Modowanie!
W porządku. Let’s take a little break and review what we have done so far, czy powinniśmy?
You have installed all the necessary tools to mod the game, and made a informator where you placed all the tools.
Another directory you made was one to put all the files you have unpackaged w. Then you either unpackaged the entire game, or just a few specific files.
If you decided to use metoda #1 to unpack the game files, and you wish to preview files to know what the hell you are looking at, you can follow metoda #2, but open the unpackaged folder instead of the game folder. This means you will directly skip the step of the AES key.
Everything else remains pretty much the same!
W każdym razie… You have also made an Unreal Project, where you will be working with your mods.
Last but not least, you have gone up these messages and read THE BASICS Ponownie 👀
Więc, how do I actually mod now? WELL. It depends.
This guide is already big enough, so let’s split this up into different guides now, czy powinniśmy?
Nie martw się. It’ll just be for a moment. Each separate “mini” guide will explain how to mod a specific part of the game. Once you have reached the Packaging section of said guide, return here!
Modifying Materials (Reskins, itp.)
TAk. I said return PO reaching the last section of the specific guide for what you want to mod!
Packaging your Mod
W porządku. You have made your mod, you have cooked your files, you have found the folder where they are located.
Locate your files there, and copy them over to the directory where you put Unrealpak. W moim przypadku, I pasted them here:
- D:\HumanitZ Modding\Tools\Unrealpak
After doing that, I will remind you once more about following file structure to a T. Ale już. The original .pak file of HumanitZ, the one that contains all the files of the game, is called TSSGame-WindowsNoEditor. Remember that.
Inside your Unrealpak folder, create a new folder called TSSGame-WindowsNoEditor.
Dodać _P to it. This basically tells Unreal Engine to prioritize loading this directory.
The end result should be a folder named: TSSGame-WindowsNoEditor_P, located in the directory:
- […]\Unrealpak\TSSGame-WindowsNoEditor_P
Open the folder you have just created, and create another folder inside it, called the project name.
That is a folder called TSSGame.
Open this new folder, and make another folder, called Content. If you have been paying attention to the guide, you will notice a pattern here.
Głównie, we are copying the same file structure as the developers have on their end! Neat, huh?
Inside the Content folder, place your cooked files. W naszym przypadku, it would be our VehicleVarietyPack folder. Make sure the directory is as follows:
- TSSGame-WindowsNoEditor_P
- TSSGame
- Content
- Materiały
- BoxTruck
- M_BoxTruck_Body.uasset
- M_BoxTruck_Body.uexp
- Tekstury
- BoxTruck
- TX_Truck_Box_Diffuse.uasset
- TX_Truck_Box_Diffuse.uexp
- Materiały
- Content
- TSSGame
Now return to your Unrealpak folder. Click on your TSSGame-WindowsNoEditor_P, and gently drag it over to UnrealPak-With-Compression.bat.
A prompt / cmd window will appear, and it will convert your folder into a .pak file! Close the prompt.
Now your mod is ready! Yaay! Simply head to where the original .pak file of the game is located. That would be:
- […]\HumanitZ\TSSGame\Content\Paks
And paste your TSSGame-WindowsNoEditor_P tam plik! Proszę rename the file to whatever you want, but remember to keep the _P na końcu!
Otóż to! Boot the game and enjoy your mod! 🥳 💖
