GSH - GRAPHICS SETTINGS HOTKEYS - Kingdom Come Deliverance 
--------------------------------------------------------------------------------------------------------

DESCRIPTION
---------------------
After the 1.3.1 patch, while trying to adjust certain graphics settings within the Advanced Graphics section of KCD, I noticed that the WH 'fix' for the slider bars was causing a new issue; overriding the default settings for each effect, which in effect caused a new slider bug issue, version 2 :) . The original way the slider bars worked in v1.2.5 was that selecting a detail level for a graphics setting would make the slider bars return to a default level to match the graphics settings. This ensured the values were loading properly for the given setting. Only then would the sliders override the values once they were adjusted. This is no longer the case.

Selecting Object Details, Vegetation etc no longer uses the default values and makes it impossible to use the default values for a specific detail level (Medium, Ultra etc) within this menu (since the sliders do not reset and override any default setting that was justed selected). This results in distance/lod settings that are not intended with values that are too low or high. 

As a result of this issue, I starting using a basic hotkey config file that allows important vanilla graphics settings detail levels to be adjusted quickly in-game while bypassing the Advanced Graphics Menu and avoiding the issues mentioned above. Using these hotkeys is also a great way to quickly switch detail levels so you can see the performance impact each setting has on your system (the default values of each graphics detail level). 

I wasn't able to make a hotkey for every Graphics Setting or Detail Level available in the game, so for details that don't impact performance very much, I chose the Medium and Ultra detail levels for the hotkeys (for example, Quality setting, AO, Water, Vegetation, Object Detail and Post Processing). If you want to see a value that's something in-between Medium or Ultra, simply select one of the games default overall presets (F1 to F5) and then use the relevant hotkey to adjust the individual setting and see the effect it has on your system. You can also easily edit the hotkey.cfg file to test and switch between any graphics setting. 

The graphics settings that have the greatest performance impact have four hotkeys assigned that cycle from Medium through to Ultra High (for Light effects, Shadows and Shading). Each setting is also rated on the overall performance impact, 1 having the lowest impact, through to 5 having the highest performance impact, with average fps percentage loss when going Low to Ultra settings. Even though the performance was rated based on my PC system, the 'impact ratings' should be universal.

I also use these graphics hotkeys during certain areas of the game that drops my performance below 60 fps. For example in Rattay, or indoor areas at night, where Shadows and Light detail can quickly be reduced from High to Medium to bring the fps up without using any menus (which as stated above, isn't working properly in the Advanced Graphics settings anyway!).

Here are the hotkey values and which settings they adjust. They can easily be changed through the GSH_hotkeys.cfg file;

HOTKEY SETTINGS 
------------------------------
F1  LOW overall detail (default preset)

F2  MEDIUM overall detail (default preset)

F3  HIGH overall detail (default preset)

F4  VERY HIGH overall detail (default preset)

F5  ULTRA HIGH overall detail (default preset)

QUALITY effects (tied to the SHADING preset normally, only 3 levels, performance impact = 1/5) 2%
F6  High (2)
F7  Ultra High (3)

AMBIENT OCCLUSION effects (On/Off; proper default values in vanilla KCD were missing, performance impact = 1/5) 3%
3  SSDO off
4  SSDO on

WATER effects (Medium OR Ultra_High; only when water is visible performance impact = 1/5) 3% 
5  Water Medium
6  Water Ultra High

VEGETATION effects/lod (Medium OR Ultra_High; performance impact = 1/5) 3%
7  Vegetation Medium
8  Vegetation Ultra High

OBJECT DETAIL effects/lod (Medium OR Ultra_High; performance impact = 2/5) 6%
9  Object Detail Medium
0  Object Detail Ultra High

POST PROCESSING effects (Low OR Ultra_High; performance impact = 2/5) 5%
-  Post Processing Medium
= Post Processing Ultra High

NUMBER PAD Section Hotkeys
LIGHT effects (Medium to Ultra_High; INTERIOR performance impact = 3/5) 12%
NumPad 0  Light Medium
NumPad 1  Light High
NumPad 4  Light Very High
NumPad 7  Light Ultra High

SHADOWS effects (Medium to Ultra_High; overall performance impact = 4/5) 8-18%
NumPad 2  Shadows Medium
NumPad 5  Shadows High
NumPad 8  Shadows Very High
NumPad /  Shadows Ultra High

SHADING effects/global illumination (Medium to Ultra_High; overall performance impact = 5/5) 30%
NumPad 3  Shading Medium
NumPad 6  Shading High
NumPad 9  Shading Very High
NumPad *  Shading Ultra High

LOAD custom config file from your KCD Config directory, use default custom settings or create your own :)
F8  Load custom config (default is 'GraphicsSettings(1)LowCustom', edit within Config directory)
F9  Load custom config (default is 'GraphicsSettings(2)High-UltraCustom', edit within Config directory)

LOAD user.cfg file from your KCD directory 
F10 Reload 'user.cfg' file, useful if you want to make sure the game is using your cfg values and selected graphics cfg file

You can see the current value you just selected by pushing the ~ key to bring up the developer console(located beside the 1 key) .
Note: the dev console must be closed for the hotkeys to work.  


INSTALLATION
-----------------------
1. Extract all files to your Kingcome Come installation directory, for example your KCD Steam install is usually located here:
 ...\Program Files (x86)\steamapps\common\KingdomComeDeliverance\

2. If you don't have a user.cfg file located in your KCD directory, simply use the included -user-.cfg and rename the file to user.cfg by removing the - tags.

If you already have an existing user.cfg file simply copy and paste the following section into your user.cfg:      

--------------------------------------------------------------------------------

;  Loads GSH_Hotkeys; allows you to toggle graphics settings in-game to quickly see visual effects and performance impact
;  Also allows you to switch custom cfg profiles     
exec GSH_Hotkeys

;  Applies specific preset within your KCD\Config folder; the name after loadconfig can be any cfg file you create:
;  for example: GraphicsSettings(1)LowCustom or GraphicsSettings(2)High-UltraCustom
;  REMOVE ; value below to load this custom profile (or create your own)
; loadconfig GraphicsSettings(1)LowCustom

-------------------------------------------------------------------------------

3. Add this command line to your Launch options (right click the KCD game within Steam Library, then Properties). 
+exec user.cfg

For GOG users do the same but with your KCD shortcut, add this at the end of the target line after the " (quotation mark), for example;

Target section = ...\KingdomComeDeliverance\Bin\Win64\KingdomCome.exe" +exec user.cfg

4. Fire up the game and start using the hotkeys! Note that some details settings will take longer to load than others. The overall detail level presets (F1 through F5) tend to take the longest time while others like Shadows, ObjectDetails etc. change very quickly. 


LOADING A CUSTOM CONFIG FILE (optional)
--------------------------------------------------------------------
After you have settled on your graphics settings, you can load them up automatically every time you play KCD if you want to avoid the issues with the Advanced Graphics Settings menu.

Just place a cfg file in the Config directory of KCD, and add the name of your cfg to your user.cfg file under 'loadconfig .......

For example, create a cfg file called GraphicSettings.cfg and add this to your user.cfg (do not use the .cfg designation) 
loadconfig GraphicsSettings

Within this GraphicsSettings.cfg file you can set what level of detail you want for each setting; in this example I've used a combination of Ultra and Medium settings, while also turning on SSAO with the proper values, and a few other edits to ensure the game is loading the proper values within each detail level I set (and bypassing the buggy 'Advanced Graphics Details' sliders).

The nice thing about using this method (individual cfg files vs throwing everything in your user.cfg file) is that it allows you to quickly load several custom presets on the fly in-game, either for testing purposes, or for specific uses during gameplay, where performance can be dramatically reduced (such as during a large battle or walking through Rattay during a sunny day with many NPC's on screen).  

Example of custom GraphicsSettings.cfg file...
------------------------------------------------------------------------------------------------------------------------------
; The number after each graphics setting represents the detail level that will be used:
; 1=Low, 2=Medium, 3=High, 4=VeryHigh, 7=UltraHigh

; Custom HIGH-ULTRA Config
sys_spec_ObjectDetail=7
sys_spec_Shading=3
sys_spec_VolumetricEffects=7
sys_spec_Shadows=3
sys_spec_Texture=7
sys_spec_Physics=3
sys_spec_PostProcessing=7
sys_spec_Particles=7
sys_spec_Sound=7
sys_spec_Water=3
sys_spec_GameEffects=7
sys_spec_Light=3
sys_spec_TextureResolution=7
sys_spec_Vegetation=7
sys_spec_Quality=7

; SHADING Custom Settings (AO on); fixes improper values within vanilla KCD)
r_ssdo=1
r_ssdoAmountAmbient=0.8
r_ssdoAmountDirect=2.5
r_ssdoAmountReflection=1.8
r_ssdoHalfRes=2
r_ssdoRadius=0.3
r_ssdoRadiusMax=0.1
r_ssdoRadiusMin=0.1
e_svoTI_SSAOAmount=1.4

; my preferred AA mode
r_AntialiasingMode = 3

; this value prevents small objects from suddenly appearing, vanilla default value of 5 is way too low
;(for example, when set too low, walking into Alchemy station room in Rattay, some table props will just pop into view).
e_ViewDistMin=35

; this ensures all motion blur effects are turned off, even when selecting Ultra High for Particles and PostProcessing...
r_motionblur=0
e_ParticlesMotionBlur=0

End of EXAMPLE custom cfg graphics file contents
------------------------------------------------------------------------------

SPECIAL THANKS
----------------------------
A special thanks to OVNI. His 'Optimized Graphic Presets' inspired me to make this GSH hotkey.cfg file for the vanilla graphics settings after noticing the 'slider bug v2' issues in KCD (as of v1.3.1+).

And of course thanks to Warhorse Studios for making this amazing RPG!


CHANGE LOG
--------------------- 
v1.0 Initial release.
v1.1 More details added to GSH_Hotkeys.cfg, readme.txt moved to Config directory.