Killing Floor 2 supports custom maps from the Steam Workshop, on top of the maps that ship with the game. There are two ways to get one onto your server: an automatic Workshop download, or uploading the map file yourself. This guide covers both, plus the steps needed afterward to make the map actually playable.
Method 1: Steam Workshop (Automatic Download)
This is the official method: your server downloads the map itself once it's subscribed.
- Subscribe to the map on its Steam Workshop page and note the Workshop ID from the URL (the number after
id=). - Stop your server and open
KFEngine.iniinKFGame/Config. - Under
[OnlineSubsystemSteamworks.KFWorkshopSteamworks], add a line for the map:
- Confirm
[IpDrv.TcpNetDriver]listsDownloadManagers=OnlineSubsystemSteamworks.SteamWorkshopDownloadas its first entry, so players can download the map too. - Save and start your server. It will fetch the map on startup.
- Once downloaded, browse to
KFGame/Cache, then the folder matching your Workshop ID, then0/BrewedPC. You'll find the map's.kfmfile there — note its exact name, you'll need it for the next steps.
Method 2: Manual Upload (Fallback)
If the automatic download isn't working, you can grab the map file yourself and upload it directly.
- On your own computer, subscribe to the map on its Steam Workshop page and let Steam download it.
- Open your Steam installation folder and browse to
steamapps/workshop/content/232090/, then the folder matching the map's Workshop ID. - Inside, open the
BrewedPCfolder. You'll find the map's.kfmfile there. - On your MintServers panel, stop your server and go to the Files tab.
- Browse to
KFGame/BrewedPC/Mapsand upload the.kfmfile there.
Registering the Map
Whichever method you used, the server needs a matching entry in KFGame.ini before it recognizes the map or shows it in WebAdmin. Open the file and add a data store block using the map's exact name:
Replace KF-YourMapName with your map's actual name in both places, including the section header. Get this wrong and the server won't recognize the map.
Adding It to Your Map Cycle
Registering the map makes it available, but it won't be played automatically until it's in your map cycle. Add it to the GameMapCycles list in the same file, alongside your other maps:
Save the file and restart your server. For more on map cycles and other core settings, see our guide on configuring your Killing Floor 2 server.
🛠️ Troubleshooting
Map won't download automatically:Try Method 2 (manual upload) instead — this is the more reliable option if Workshop syncing is acting up.Map doesn't show in WebAdmin:Double-check you've added the data store entry inKFGame.iniwith the exact map name.Players get "downloading package failed" errors:The map name in your data store entry or map cycle likely doesn't exactly match the.kfmfilename. Names are case-sensitive.Too many maps causing instability:Keeping your server under roughly 500 maps in rotation helps avoid stability issues.
Once your map is registered and in the cycle, it'll show up right alongside the default maps. If you get stuck anywhere in the process, no worries! Just open a support ticket and our team will gladly help you get it working.