Automation of mod assembly for Killing Floor 2 and some related actions.
- Build, brew, test and upload to Steam Workshop
- No need to edit KFEditor.ini at all
- Sources can be stored in any path
- Easily switch between different projects
- Killing Floor 2;
- Killing Floor 2 - SDK;
- git-bash. (*)
(*) Should also work fine on MSYS2 with git installed (pacman -S git). But I don't test it.
Make sure that the location of folders and files in your project as follows (Correct it if it's not):
/<PackageName>/Classes/*.uc
There are two ways to add KF2-BuildTools to your project:
1. As git submodule
Open git-bash and go to your project: cd <your_project_path>
Add submodule: git submodule add https://github.com/GenZmeY/KF2-BuildTools tools
updating build tools (manual)
Get updates: pushd tools && git pull origin master; popd
Commit the changes: git add tools && git commit -m 'update build tools'
Just create a tools folder and put builder there.
Since version 1.9.0 build script can update itself:
./tools/builder --update
if you have an older version you need to update once manually to start using this feature
Available commands can be found here: USAGE.md
If you have a simple mutator or game mode, then the usage is also simple: just use the commands to compile, test and upload to the steam workshop.
Compiled packages:
%USERPROFILE%\Documents\My Games\KillingFloor2\KFGame\Unpublished\
Brewed packages:
%USERPROFILE%\Documents\My Games\KillingFloor2\KFGame\Published\
Uploaded packages:
your steam workshop 🙃
If your project contains several mutators, *.upk files, external dependencies, or you want to customize the whole process in more details, then this section is for you.
When you run compilation for the first time or do ./tools/builder --init builder.cfg appears in your project folder.
Edit it to set build/test/upload options. The config contains the necessary comments inside.
Edit the files in the PublicationContent folder - they are responsible for the description in the Steam Workshop.
If you have *.upk or localization files, they must be in a specific location.
Change the filesystem of the project to such a form that everything works correctly:
📂 <ProjectName>
├── 📁 <SomePackageName1>
│ ├── 📁 Classes
│ │ ├── 📄 *.uc
│ │ └── 📄 *.upkg
│ ├── 📄 *.uci
│ └── 📦 *.upk
├── 📁 <SomePackageName2>
│ ├── 📁 Classes
│ │ ├── 📄 *.uc
│ │ └── 📄 *.upkg
│ ├── 📄 *.uci
│ └── 📦 *.upk
├── 📁 PublicationContent
│ ├── 🌆 preview.png
│ ├── 📄 description.txt
│ ├── 📄 tags.txt
│ └── 📄 title.txt
├── 📁 Localization
│ └── 📁 INT
│ └── 📄 *.int
├── 📁 Config
│ └── 📄 *.ini
├── 📁 BrewedPC
│ └── 📦 *.*
├── 📁 tools
│ └── ⚙️ builder
└── 📄 builder.cfg
Note: Use the BrewedPC folder for additional content such as sound files for your weapons or other stuff. This will be copied to the final BrewedPC before being uploaded to the workshop.
By the way, this allows you to use a script to upload maps (although this was not its original purpose). Just put the map(s) in BrewedPC (don't forget to edit the PublicationContent) and run ./tools/builder -u.
KFEditor.exe or KFGame.exe is running - they will interfere with the build. Running build separately will already allow you to avoid most problems.
The build is stuck but KFEditor.exe window doesn't disappear and shows successful compilation/brewing:
Make the KFEditor.exe window active and press CTRL+C.
The build is stuck at the "wait for the log" stage:
Stop the build, clear the logs folder:
%USERPROFILE%\Documents\My Games\KillingFloor2\KFGame\Logs\
Then repeat the build.
Simplest case (one mutator):
Mutator + Localization:
Two mutators are compiled, there are upk and localization:
Three mutators are compiled (one of them is a dependency),
two mutators are uploaded to the steam workshop:
- amione - bug fixes
- Build Tools works with the current version of the game (v1150) and I have implemented everything I planned.
- Development has stopped: I no longer have the time or motivation to maintain this tool. No further updates or bug fixes are planned.
GPL-3.0-or-later
