Skip to content

RE_Kenshi Features

Bryden Frizzell edited this page May 12, 2023 · 14 revisions

RE_Kenshi Features

This page contains descriptions for all features in RE_Kenshi 0.2.8

Player Features

Force save on crash

RE_Kenshi's crash handler can attempt to force the game to save when a crash is detected.
It is possible for this to fail in some cases, but it should usually generate working save files, allowing you to keep your progress when a crash occurs.

Emergency save

RNG bug fix

Fixes a bug in Kenshi's random number generation code.
Enabling this causes the following side-effects:

Randomized recruits will actually be random
Randomized item spawns will actually be random
Some foliage spawns will be randomized

Custom game speed controls

Set the game to any speed (up to 1000x, also supports slow-motion/speeds under 1x)

game_speed_tutorial

Increase max camera height

Doubles the maximum camera height.
Note: zooming the camera out too far can cause visual bugs (most notably with shadows)

Shader cache

Cache precompiled shaders.
This reduces load time to get into the game, and may occasionally reduce stuttering when moving around the map.

Change mod-controlled values in-game

Supported values:

  • Attack slots (1-5)
  • Max. squad size (1-1000)
  • Max. faction size (1-1000)
  • Max. squads (1-1000)

If you drag the slider to 0, these will default back to the value set by mods.

There is unofficial support for setting these to out-of-range values by manually editing RE_Kenshi's config file RE_Kenshi.ini
Some visual bugs occur in the UI if the player has over 256 characters in a squad, but gameplay seems to work correctly.

Heightmap compression

Compress Kenshi's heightmap.
Kenshi reads the heightmap in a way that causes significant performance issues on HDDs.
Enabling this setting can often halve load time on HDDs, but usually causes little to no difference on SSDs, and can hurt performance in some situations (mostly fixed in 0.2.9).
The current implementation caches decoded heightmap values in RAM, which can use up to 500MB of extra RAM.
The "compress heightmap" option must be enabled when installing RE_Kenshi in order to use this setting. The install option is enabled by default when installing to an HDD, and disabled by default when installing to an SSD.

Font size bugfix

Fix Kenshi's font size bug, which prevents the font size setting from being applied correctly when the game starts.
This feature is only supported on Steam 1.0.55 and GOG 1.0.59 as the bug was fixed in 1.0.60.

Modder Features

File rebinding/mod hard-coded files

The file rebinding system can be used to redirect file paths from one location to another. This can be used, for example, to redirect a hard-coded file path in Kenshi's install directory to a path in a mod's directory.
Tutorials and documentation for this feature can be found on the following pages:

Sound modding

The soundbank loading system allows mods to load new sound banks, allowing you to add new sounds and replace existing sounds.
The documentation for this is still a work-in-progress as the community is still figuring out the best way to use this.
More information can be found here:

Undocumented settings/features

Performance notes

The following settings negatively impact performance and should be left off unless you are actively using them:

Log file I/O
Log audio IDs/events/switches/states
Viewing the Debug Log tab (I recommend staying on "Settings" or closing the window)
On some high-end SSDs, the compressed heightmap can hurt performance vs vanilla, but this is largely fixed in 0.2.9 onwards

Preload heightmap

If heightmap compression is enabled, this forces the entire heightmap to be loaded + decompressed into RAM when the game starts. This isn't well-tested and it is recommended to keep this disabled.
If you want to enable this, set "PreloadHeightmap" to true in RE_Kenshi.ini

Disable font size fix

The font size fix can be disabled by setting "FixFontSize" to false in RE_Kenshi.ini

Game speeds above 1000x

Speeds above 1000x can be added by manually typing them into the UI, but this isn't officially supported

Disable save on crash

To disable the save on crash system, set "EnableEmergencySaves" to false in RE_Kenshi.ini