Getting Started with Mapping (Killing Floor 2): Difference between revisions
Delta-ranger (talk | contribs) |
Delta-ranger (talk | contribs) |
||
Line 420: | Line 420: | ||
|- | |- | ||
|Performance: SkeletalMeshActor Skeletal Mesh component 'SkeletalMeshActor' not using a light environment or custom lighting channels - this will be inefficient and have incorrect lighting | |Performance: SkeletalMeshActor Skeletal Mesh component 'SkeletalMeshActor' not using a light environment or custom lighting channels - this will be inefficient and have incorrect lighting | ||
|Can safely ignore, will | |Can safely ignore, will unlikely to have an noticeable impact on performance | ||
Can fix it by Enabling ''"Skeletal Mesh Actor > Light Environment Component > Enabled"'' | Can fix it by Enabling ''"Skeletal Mesh Actor > Light Environment Component > Enabled"'' | ||
|- | |- |
Revision as of 16:04, 15 February 2022
Introduction
This page includes a comprehensive guide on getting started with the Killing Floor 2 SDK for creating Maps and uploading them to the Steam Workshop. It is recommended that any new Level Designer should begin by looking at Official Maps and seeing how they approach particular scenarios.
Installation and First Launch
To install the SDK:
- Open up Steam, hover over 'Library' and select the 'Tools' option.
- From here locate 'Killing Floor 2 - SDK' and install it as you would any game on Steam
- Once the download is complete, launch it as you would any other game.
Note: | If an opt-in Beta/preview is happening at the time, both the game and the SDK need to be on the same branch. Otherwise the SDK will crash on launch. i.e. If you are in the opt-in Beta for an update, the SDK also needs to be on the opt-in Beta. |
Interface Guide
Important: | The SDK Interface is very laggy on launch - using up a lot of resources on your computer. To prevent the UI lag, simply create an empty save file or open up an existing map e.g. KF-TempMapName |
First Launch and Glance
On first launch you may be prompted with a couple of dialogs. They are things that don't affect the editor or its performance so you can ignore and click past them. See Figures 3.1. Past all the error dialogs your Editor should look something like Figure 3.2 below.
|
SDK and Viewport Overview
Below is a breakdown of the core elements that you will be using in the SDK
There are 2 crossed out buttons on the side menu:
- The Terrain Tool - Obsolete, use the Landscape tool instead.
- Foliage Paint Tool - Not supported, will crash the Editor when you build Lighting.
Content Browser Overview
The Content Browser is large enough to break it down in its own image. The Content Browser is where you will be grabbing all Assets (Actors, Meshes, Materials, Sounds, Decals, etc). It also serves as a tool for managing and organising your map's own individual assets, and also organising assets into Layers.
Common Hotkeys
Hotkey | Function | Hotkey | Function |
---|---|---|---|
Left Click | Select actor | Spacebar | Toggle between Movement/Rotation/Scaling |
Right Click | Open Context Menu | ~ | Toggle between World and Local space transforms |
Ctrl + Left Click | Multiple select | N | Toggle Pathnodes |
Right Click + Scroll Wheel | Change movement speed around viewport | P | Toggle Paths |
Alt+Drag with Widget | Duplicate and move with widget | T | Toggle Lanscape/Terrain |
Ctrl+Z | Undo | O | Toggle Volumes |
Ctrl+Y | Redo | B | Toggle Builder Brush |
H | Hide selected actors | Alt+C | Toggle Collision Wireframes |
Shift + H | Hide all but selected actors | ] | Increase grid snap size |
Ctrl + H | Unhide all actors | [ | Descrease grid snap size |
G | Toggle Game View mode in viewport | Ctrl + number | Set a bookmark |
F4 | Open actor properties | number | Snap to bookmark |
Ctrl+B | Find selected asset in the Content Browser |
There are a lot more hotkeys for the editor, these are the main ones people usually have issue with when first starting out. You can check for others here: https://sites.google.com/site/lessonsdarrenmckinsey/udk-hotkeys
Additional Preferences
These are some additional options you may or may not want to use based on your personal preferences:
- Preferences > Flight Camera Controls
- Default is 'Use WASD for Camera Controls' - Standard FPS controls
- 'Never use WASD for Camera Controls' - KF1 Editor Controls
- Preferences > Highlight Objects Under Mouse Cursor
- Preferences > Editor Language
- View > Change Autosave Options > Autosave Interval
Your First Map
Naming
Your first map can be named anything however a Killing Floor 2 map MUST be prefixed with 'KF-'. If it isn't, it cannot be played or recognized within the game.
Your map file name should also match your map's name.
If your map name has spaces, it is common naming convention to use UpperCamelCase. Avoid using underscores or dashes to represent spaces.You should also avoid publishing a map with numbers or 'versions' at the end, this can be a pain for server owners if they want to host your map on their server.
Map Name | Good File Name | Bad File Names |
---|---|---|
Burning Paris | KF-BurningParis.kfm | KF-Burning_Paris.kfm
KF-Burning-Paris.kfm KF-Paris.kfm |
Zed's Diner | KF-ZedsDiner.kfm | KF-Zeds_Diner.kfm
KF-Zeds-Diner.kfm KF-ZesDinner.kfm KF-ZedsDinerTestingV3.kfm |
File Save Location
You can save and load your map from any location. However the best recommended location is:
C:\Users\UserName\Documents\My Games\KillingFloor2\KFGame\Unpublished\BrewedPC
The main reason is, when you plan to upload your map to the workshop, the Workshop Front-End will look specifically in only this location for files to upload. Additionally if you plan to cook your map, it needs to be in this location for it to successfully cook.
I would avoid placing your working map file under the steam game directory as well (C:\Program Files (x86)\Steam\steamapps\common\killingfloor2\KFGame\BrewedPC\Maps
). This directory may confuse your editor if you plan to import, move, rename or edit assets within your map's own directory.
World Settings
World Settings can set important information for your map such as: Map Name, Map Author, Spawning Modifiers, Objectives and Collectibles, What game mode is played in the Editor, what in-game music the game uses and Optimization options.
To access it go to: View > World Properties.
For the moment, just leave most of the variables default, but you can:
- Input your map name and your user name in the appropriate areas under the 'World Info' section.
- Change the 'Default Game Type' and 'Game Type for PIE' to "KFGameInfo_Survival" under the 'Game Type' section.
Further information on World Info can be found here: Setting Up World Info (Killing Floor 2)
Important Tip Before Moving Forward
The SDK is stable for the most part, but it is not uncommon to encounter crashes at any point in its usage. In fact its something you need to be prepared for and goes without saying that:
Important: | YOU SHOULD SAVE AS FREQUENTLY AS POSSIBLE |
While the auto-save function is useful for beginners, most users that become familiar opt to turn it off as it can interrupt workflow, bloat your game directory and also on large maps, take a long time to save.
Here are some recommended times to save:
- After any minor, moderate to large changes done in any aspect to your map
- Every 10 minutes
- If you plan to step away from the computer for a bit (e.g. going to the toilet)
- Before every Build (Lighting, Pathing, etc.)
- Planning to use or work with BSP Brushes
- Before importing new Assets (textures, meshes, sounds, etc.)
- Before placing down any newly imported Mesh
- Before moving/copying/duplicating assets in your map's directory
- Before combining meshes and/or applying collisions from the Builder Brush
After losing significant progress once or twice, saving frequently will become second habit.
Placing Assets and Props
Using the Content Browser
The Content Browser is where you will get all the meshes, textures/materials and any other assets needed to make your map. The general process of using the content browser is drag and drop or selecting and asset and right clicking in the scene to place or replace assets.
The Content Browser can be located at "View > Browser Windows > Content Browser"
The Important Tabs to other Windows in the image above is important to remember, you can quickly navigate between important windows that will aid in understanding maps.
Tab | Description |
---|---|
Content Browser | What you currently see |
Actor Classes | All placeable classes, usually if you need a specific KFActor to place in your scene you can look for it here. |
Levels | Will show the currently loaded level and its sublevels on official maps |
Scene | Contains all the actors/assets in the scene. If you are looking for a specific actor and cant find it look here. |
Layers | Works just like in Photoshop, allows you to assign specific assets to layers to organize and hide. A lot of official maps have some layers turned off (such as Skylights in Burning Paris) by default when you load the map. Simply turn them on to make the assets visible in the scene. |
Most of the assets you see are default user interface and cosmetic items that cannot really be used for mapping. Assets for mapping are located in the Package/File Directory in the "KFGame > BrewedPC > Packages > Environment" subfolders.
Note: | Assets are not located in the "Maps" subfolder - with exception to Biolapse and Desolation assets which will be unusable for you project unless you migrate them into your map package |
To load assets you wish to use in your project right click on the "ENV_" package and right click "Fully Load". This will take a second as the SDK loads in the assets into memory. If you want to use assets from maps simply locate the corresponding "ENV_" package and load it or alternatively open the map which will also load the assets and any other assets it uses not contained in its own ENV_ package. To get started fully load the "ENV_Modular_StaticSet" package.
Warning: | It is usually not a good idea to fully load the entire "Environment" folder as it will often crash the Editor. |
Using the Modular Static Mesh Set
All maps in KF2 start from and are built from the Modular Static Mesh Set instead of BSP Brushes like in traditional Unreal Engine maps. The meshes are very carefully modelled and texture unwrapped to work with tiling textures without any seams.
You can find resources on how to use the Modular kit here:
Comprehensive Wiki Guide: Setting Up Modular Static Set (Killing Floor 2)
Community Tutorial Playlist (by Kuebic): Killing Floor 2 SDK Tutorials
C:\SteamLibrary\steamapps\common\killingfloor2\KFGame\BrewedPC\Maps\SDK\Mod_Tools_Modular_Template C:\SteamLibrary\steamapps\common\killingfloor2\KFGame\BrewedPC\Maps\SDK\Mod_Tools_Demo_Map
Important: | Tips for working with the Modular Kit
|
Important: | Advice from an Experienced Mapper
When you first start using the modular kit, you may feel compelled to have corners perfectly aligned with the corresponding Corner-In and Corner-Out pieces. But this is a waste of time. It is good to understand how these pieces work together, but in practice you often do not need to worry about them. When we start to add pillars, set-dressings and other assets to make the map visually interesting you will find that corners often get hidden. The time spent meticulously getting corners set up correctly is often wasted or never noticed by players; it is better to spend time elsewhere. If the corner is bare or where players will spend a lot of time, then it would be appropriate to use them correctly. But otherwise do not worry about it too much until you start to polish the map. |
Changing Materials (Textures)
To change the look of the modular mesh pieces (or any mesh in the SDK), you apply a Material Instances onto them. A Material is a shader that combines the textures (diffuse, normal, specular, etc) so it can be applied onto a mesh within the editor. The SDK already has a large library of materials that you have access to:
You can also create custom variations of the MICs specifically for your map!
You may notice that some props have more than one slot for a material, just experiment to see which areas the materials affect.
|
Creating Interesting Levels with Props
If you are just starting out, it is highly recommended that you go and spend some time looking at the official maps to see how they place props, materials and lighting around the level. You can mix and match and even copy+paste assets directly from those maps into yours. If you want a comprehensive guide on how to place props and change materials the video below does an amazing job:
Community Tutorial (by Seanchaoz): KF2 SDK - Guide to making interesting room geometry
Note: | When you copy objects in the Editor, it copies it as plaintext. You can paste this into notepad just in case the editor crashes when you load another level. |
Creating Landscapes
Warning: | Currently Landscapes are bugged and official Materials and MIC are not working for custom maps and a workaround is required. This is a intermediate/advanced workaround and knowledge of a 3D Modelling program is required. More details are available in the link below. |
If you are just starting out, I recommend making a map out of the modular kit first. The below guide will tell you everything about how to add one to your map if you wish to procede:
Comprehensive Wiki Guide: Setting Up Landscapes (Killing Floor 2)
World Lighting
If you have just been working with the Modular Kit you have most likely been in Unlit mode (Alt+3) which is unaffected by lighting. If you go to Lit mode (Alt+4), you will notice the scene is completely black. This is because there is no lighting set up in the map yet.
Adding Ambient Light - Skylights
To get basic environmental/ambient light we need to add SkyLights.
- Go to the "Actor Classes" Tab from the Content Browser
- Navigate to "Actor > Light > SkyLight"
- Drag and drop a Skylight into the scene (Do not use the SkyLightToggleable)
If you are in Lit Mode then you will see your scene light up. As a general rule, ambient lights should be rather subtle and not as powerful as the default value of '1'. Official Maps have values that range from 0.05 (Volter Manor) to 0.15 (Outpost) for their skylights. So values between 0.01 and 0.2 are good ranges.
So lets change the value to be what is usually more acceptable for KF2 maps:
- Select the SkyLight and Press F4 to open the Properties
- Under "Light > Light Component > Light Component > Brightness" (should be open by default), change the value to something like '0.1'
- You can also change the tint of the lighting to align with your map's mood by changing the "Light Color" under the Brightness setting
- If your ceilings are too dark you can change the "Light > Light Component > Sky Light Component > Lower Brightness" to something around '0.01'
- Again you want to use very low numbers here
KF2 Maps can have a total of 2 SkyLights; 1 for Outdoors and 1 for Indoors. You can select which SkyLight affects each area in the properties:
- Set "Light > Light Component > Light Component > Override Auto Lighting Channels" to True/Enabled
- Selecting which Channel to affect under "Light > Light Component > Light Component > Lighting Channels"
- Without the 'Override Auto Lighting Channels' property enabled, the SkyLight will default to whatever volume it is in. We just enable it to have greater control.
A secondary requirement for multiple Skylights is that you need a TWIndoorLightingVolume or TWOutdoorLightingVolume. The LightingVolumes tell the editor that the assets (Props and Lights) within this volume are either Indoor or Outdoors, and will build the lighting accordingly. Since Indoors are usually contained within Outdoor environments, in most cases we just need to specify an Indoor Volume to save time.
To create lighting volumes:
- Select the Builder Brush (The Red Wireframe Cube in the scene)
- Press 'B' if you cannot see it (it may be hidden)
- Move the Builder Brush somewhere indoors to test
- On the right toolbar select "Volumes > Add Volumes" and click a TWIndoorLightingVolume (See Figure 6.1)
- Move the Builder Brush somewhere and you will see a pink cube left behind - this is your Volume
- You can change the general size of the volume by clicking Geometry Mode (Shift+2) and selecting the Volume faces and moving them where you want them
- You can shift back into Camera Mode with Shift+1
- Press the Build Geometry button to recalculate the Volume (See Figure 6.1)
- Press the Build Lighting button, a prompt will appear but just click OK
- You should notice after the game has finished building that all the meshes that intersect the Indoor Volume should be lit by the Indoor SkyLight (if you had set them up already)
General Lighting
Lighting from this point onwards is pretty easy. There are 2 main types of light you can place into a scene. Both these lights have properties such as Brightness, Radius, Light Color which you can be creative with, you can even add flickering behaviors to them.
- PointLights - Which provide light in a sphere like radius
- You can place a light in the scene by holding 'L' and left clicking.
- SpotLights - Which provide a cone of light in the direction it is facing
- You can convert a PointLight to a SpotLight by right clicking the PointLight and selecting "Convert Light > SpotLights > SpotLight"
Warning: | LIGHTING HAS THE LARGEST IMPACT ON PERFORMANCE |
Important: | Tips for working with Lighting Performance:
|
Lighting Documentation
Excellent Community Tutorial (by Seanchaoz): KF2 SDK Guide - Basic Lighting Tutorial
Shadow System Technical Documentation: Shadow System Technical Documentation (Killing Floor 2)
Building (Baking)
At this point you are probably putting down lots of props and lighting, but you may notice that objects are not looking correct within the editor. When we want to update the map after lots of edit, we have to 'Bake' or 'Build' our map. Building takes time and scales with size and complexity of your map. It is not required to do all the time, only when you need to update certain aspects of your map to verify and test. Figure 7.1 shows their location.
There are 5 sorts of Builds we are often concerned with:
- Build Geometry - When we make any changes to Volumes or Brushes created with BSP Brushes/Geometry mode, the changes will not be updated until we actually rebuild the geometry
- This is particularly important to remember when we are making/editing Blocking Volumes for Players and Zeds
- Build Lighting - As we change Skylights, Pointlights and SpotLights in our scene, we want to check how they look, whether they accept the right lighting and specifically with this build, shadow map creation.
- This will be the main build that we do to check for visual quality as we build our map
- This build process takes the longest based on the map size
- Build Paths - Used to build pathing that Zeds/AI/Trader Paths use
- Build Splatter Maps - A KF2 specific build that generates unique maps for persistent blood on meshes as you play the game
- Build All - Builds all of the above in one Bake
Note: | "Cooking" is another term you may hear. It is the same as Baking except it will package the map and some additional shader files in a non-editable Map file in C:\Users\username\Documents\My Games\KillingFloor2\KFGame\Published . It is done automatically by the SDK Upload Tool when you upload to the Workshop. It also has more advanced use when testing custom materials which required a packaged map. It is not recommended that you cook your map within the Editor. Stick with standard baking. |
Common Errors and Issues from Building
Error | Fix |
---|---|
Warning: Maps not built with production lighting | This warning will always occur and you can safely ignore it. You cannot get rid or fix it. |
Warning: Map should have KillZ set - set this to something sensible so that the player doesn't fall forever | Set a value in "View > World Properties > Zone Info > Kill Z" to something like -10000 |
Warning: 'Actor' - CanBecomeDynamic Actor has BlockActors Enabled <PostLoad> | Can safely ignore this warning. Pops up on Actors that usually get knocked around by Physics and Players. Does not impact gameplay.
If you really want to get rid of it, go to the actor's properties and disable the option at "Actor > Actor Component > Collision > Block Actors" |
Error: No shadowmap generated for 'ActorName' of owner 'ActorName'. Check if mesh has lightmap UVs | This occurs when actors that don't have Lightmap UVs (UV1) try and build Shadow maps. May not have a visual impact.
You can fix this by either creating new Lightmaps for the mesh in an external 3D Program or by Disabling "Actor > Actor Component > Lighting > Precomputed Shadows" or Disabling Shadow Casting entirely for it. |
Warning: DecalActor : Decal actor does not have any overlapping actors | Can safely ignore this warning, has no impact on performance or gameplay. Occurs when you have 2 or more Decals projecting ontop of each other.
You can try and fix it by adjusting Decals so they do not overlap. |
Warning: Volume/Brush : Brush has non-coplanar polygons | May cause gameplay issue and even SDK crashes. Occurs when a face of a Brush is not flat/planar from editing it at some point
Easiest fix is to delete it and rebuild the Brush |
Performance: SkeletalMeshActor Skeletal Mesh component 'SkeletalMeshActor' not using a light environment or custom lighting channels - this will be inefficient and have incorrect lighting | Can safely ignore, will unlikely to have an noticeable impact on performance
Can fix it by Enabling "Skeletal Mesh Actor > Light Environment Component > Enabled" |
Error: PathNode : Navigation point not on valid base or too close to steep slope
Warning: PathNode : has no paths, and is not inside the navmesh! (If this is a destination or something for players only set bDestinationonly=TRUE) |
Pathnode may be floating in air, too far from ground or cannot find adequate place to snap to, inside a mesh or blocked from other pathnodes. Just move it around until it is fixed |
Warning: KFSpawnVolume ValidatePathingFromMarkers finished but there are no spawn positions! for KFSpawnVolume
Warning: KFSpawnVolume ValidatePathingFromMarkers: KFSpawnVolume can't find an anchor from marker 1 |
Spawn Volume cannot place spawn positions due to no ground being present or a prop blocking it from having enough space, just shift the volume or props around. |
SDK Bugsplat when Building Lighting | Could be a large number of things, but the most common issue is building lighting on BSP Brushes
To fix, select all Brushes in the Scene Window, delete them and rebuild Geometry. Save and try again. If error continues, it could be something else. You can check the Crash Logs located at |
Using the BSP Brush and Creating Volumes
We used the Builder Brush when we created the Lighting Volumes earlier but it is used for a lot more. Formally it is known as a BSP (Binary Space Partitioning) Brush and uses the CSG (Constructive Solid Geometry) modifiers located on the right tool bar. We can create a lot more than just cubes and rectangles as well. When we are Geometry mode we get a dialog window that allows us to use the Edit or Extrude Modifier (See Figure 8.1). If you select a face and drag it out with the transform gizmo, you can create additional space to the Brush while in Extrude mode. You can also grab the Edges of the Brush and move them. These actions will be enough to get you 95% of the way with using the BSP Brushes.
There are certain circumstances where you will need more unique shapes, such as shapes with a hole. To achieve such shapes we need to use the CSG Add and Subtract Modifiers. These will create physical meshes within the Editor that you can interact with. We should not use these to make out maps and instead use them to create unique shapes for our Brush. This is done with the Intersect Modifier and with the resulting shape you can add your volume. Using this method can leave behind "Brush" actors which can only be removed through the Scene Tab, once removed make sure to rebuild the Geometry of the map.
The video below shows how to use brushes in 2 ways:
Technique 2 is typically better in the long run as it is less buggy and requires less clean up. However if you make a mistake and Ctrl+Z prone to crashing the editor, you need to remake the brush. Community Tutorial (by Delta): KF2 SDK - Making Volumes 2 Ways |
Important Volumes
Volume Name | Description |
---|---|
PawnBlockingVolume
KFPawnBlockingVolume |
Does exactly as the name suggests, blocks Players, Zeds/AI and PlayerZeds from passing through them.
KFPawnBlockingVolume is different as it has options for Versus mode. You can use either for creating blocking volumes for your map. |
KFSpawnVolume | This is where Zeds will spawn, allows you to specify amount of spawn points, spawn delays and active areas.
Further Documentation: Setting Up Navigation (Killing Floor 2) |
TriggerVolume | These are used to activate Portal Spawns (Zeds popping out of vents and sewers). It is also used for scripted Kismet and Level events if Players or Zeds are in the area. |
KFReverbVolume | Affects how the sound will reverberate when the player is in that volume. Eg: In a open outside area or in an indoor small room.
Further Documentation: Setting Up Map Audio (Killing Floor 2) |
KFDialogEnvironmentVolume | When a player enters these volumes it will play a piece of dialog based on the character and sort of environment state you set in the volume. |
Setting Up Gameplay
Player Spawns (KFPlayerStart)
When players start a game or respawn at the end of the round they spawn on these nodes. They also act like regular path nodes for Zeds and Trader arrows.
There is Kismet in Official Maps to choose which set of KFPlayerStarts they spawn on at the start of the game, but this will not be used again on respawning at the end of a round. The game will select the first set of PlayerStarts it has in memory.
You will want at least 6 for standard maps. If you are making a Holdout/Objective Map, probably include more for servers that run more the 6p.
Customization Points (KFCustomizationPoint)
Customization Points are used at the start of the game where player need to ready up. They are usually hidden far away from the main playable space of the map (either really high up or below the map). The easiest way to find them on official maps is to search for the actor in the Scene Tab.
Wiki Documentation: Setting Up Navigation (Killing Floor 2)
Tips:
- N will toggle node visibility.
- P will toggle path line visibility.
- Use "KFPathNodes" rather than "PathNodes". But regular PathNodes will still work.
- Generally we want a nice grid of pink navigation lines between the nodes. Whites paths are fine. If you are getting a lot of green and blue lines you may want to look at changing the location of props and nodes.
- For very tight areas in maps, such as narrow doors, or tight sections around props, you will want to add "KFTrigger_ChokePoint"
- These will shrink the collision of Zeds so they do not get stuck on props or each other.
- It's advisable to try and orient path nodes in straight lines, as zig-zagging zed pathing is fun for no one.
- Spacing between nodes is subjective but any distance between 320-640 is good.
- Closer together is considered overkill; but it is fine to increase density around props that Zeds need to path around.
- Further apart will not really be dense enough for smooth navigation for the Gameplay
- Just checkout how official maps orient their nodes.
- There is 1024 a limit for PathNodes that you can have on a map; having more will significantly increase build time and pathing/trader trails will not work properly.
Zed Spawning (KFSpawnVolume)
Wiki Documentation: Setting_Up_Spawns_(Killing_Floor_2)
Spawning Zeds is rather straight forward. Create a KFSpawnVolume, adjust its size and put a path node in the volume.
Portal Spawns (KFSpawners)
Wiki Documentation: Setting_Up_Spawns_(Killing_Floor_2)#KFSpawner
The easiest way to get these into your map is to simply copy and paste them from an existing map. Requirements for them are linked below.
Make sure you read and add the Kismet Requirements documented below. If you do not, Zeds will not spawn.
Traders
The easiest way to get a trader into your map is to copy and paste a trader from an existing map. Traders are made up of 2 actors so make sure you copy both:
- A KFTraderTrigger
- A Trader SkeletalMesh
The KFTraderTrigger is what the players actually interact with, when they are inside it's collision radius they can use it. The SkeletalMesh is just the Prop representation of the Trader and can be basically anything (eg: Infernal Realms).
Important: | The KFTraderTrigger also acts as a path node so the Trigger itself needs to not be blocked by the actual Trader Mesh. For trader arrows to path to the correct trader make sure the following is correct:
|
Ammo and Weapon/Armor Spawns
Wiki Documentation: Setting Up Pickups (Killing Floor 2)
Note: | Standard sized maps utilized between 14-20 Ammo and 14-20 Weapon Pickups around the map |
Doors
Wiki Documentation: Setting Up Doors (Killing Floor 2)
Important: | Doors have a VERY specific set of requirements for them to work correctly, make sure you carefully read the documentation above. |
Testing Your Map
You can play your map directly in the editor by pressing the "Play level in editor button"/Play in Editor (PiE), F8, or you can right click anywhere on the map and select "Play from Here".
By default no game mode will be active but you can test things like general feel of the map, lighting, collisions and so forth.
To test gameplay, open the console (~) in game and use these commands:
Command | Function |
---|---|
ToggleSpawning | Will allow you play the default game listed in your WorldInfo in the Editor |
EnableCheats | Will open up most commands |
God | Toggles God Mode |
DemiGod | Will take damage but will never die |
Ghost | No clip mode |
Fly | Can fly around the map with collision enabled |
Walk | Disables Ghost/Fly mode |
Chris | Will give you, God, Loaded (all weapons), UberAmmo (unlimited ammo), ToggleSpawning |
Stat FPS | Will show you your fps while in game. Our go to for performance checking. |
Full List of Console Commands: Useful Console Commands (Killing Floor 2)
What should I be testing for?
TL;DR - TEST EVERYTHING
- Performance - Do we have stable frames on every part of the map?
- Walk around the map and take note of where FPS drops as you look at it at different angle - Is the FPS changing drastically?
- FPS is very dependent on your own PC. To get a baseline of what you should be aiming for, open up Official Maps that are similar to yours and enable stat fps:
- If you have a open outside map, check performance against Black Forest
- If you have a rather indoor map check performance against Biotics Lab
- If you have a combination of both, check performance against Burning Paris or Outpost
- Remember that lighting plays a very big part in performance!
- Collisions - Do players or Zeds get stuck?
- Run around your map and hug corners, make sure you do not get caught on anything.
- Play the game as you would normally and watch how you and the Zeds walk around objects and props
- Are you or Zeds getting caught on anything?
- Are Blocking Volumes working as intended?
- Zed Spawning and Pathing
- Play the game in exclusively in specific areas to test how Spawning, Pathing and Performance are
- Are spawns slow or too fast?
- Are the portal spawns working?
- Are trader arrows navigating to the right traders?
- Exploits and Bugs
- Can the players jump on top of anything they shouldn't be able to?
- Can Zeds get to the players wherever they are?
- Can the player leave the map?
- Is the Gameplay Fun?
Important: | Testing in Editor VS Base Game VS On a Server
|
Map Optimization
Map Optimization is the arguably one of the most important steps when completing a map. Aside from having good playable spaces, the map needs to perform well on all machines; maintaining stable Frames per Second (FPS). The following guide is a comprehensive list of areas that should be addressed before publishing a map. EVERY step should be evaluated and addressed as they will all add to performance.
Comprehensive Wiki Guide: Map Optimization Guide (Killing Floor 2)
Publishing to the Workshop
KFWorkshopMapSummary.iniBy default, maps natively support Survival, Weekly, and Endless game modes; If you were to upload the map directly with the Workshop Upload Tool, your map would be playable in these game modes. Objective mode is set to false so the map will not show up in selection in Objective Gamemode. To enable this you have to create and bake an additional .ini file into the map during upload. Additionally if you had a map which didn't support a game mode (eg: Progression or Holdout not being supported in Endless) this .ini will allow you to remove map selection when that game mode is active. Create a KFWorkshopMapSummary.ini within the following location: C:\Users\UserName\Documents\My Games\KillingFloor2\KFGame\Config\Config
Copy and paste the following into the KFWorkshopMapSummary.ini [KF-MAPNAME KFMapSummary] MapName=KF-MAPNAME MapAssociation=0 ScreenshotPathName=UI_MapPreview_TEX.UI_MapPreview_Placeholder bPlayableInSurvival=True bPlayableInWeekly=True bPlayableInVsSurvival=True bPlayableInEndless=True bPlayableInObjective=False
Custom Map PreviewIf you want a custom map preview you will need to include a map preview image in the map:
Uploading using the Workshop Upload ToolTo access the Upload Tool, open up your Steam Library Tools and right click on the Killing Floor SDK and select 'Workshop Upload Tool'. The upload steps are pretty straight forward:
Figure 12.2 shows what the Upload tool looks like with the provided .INI and MapPreview package.
|
|