Special K keeps track of configuration parameters and their values (often called the ‘profile’) on a game-by-game basis and stores these in easily accessible and editable *.ini
files that the user can double-click to edit directly in Notepad or another text editor of choice. The tool also logs relevant diagnostics data also on a game-by-game basis in logs\*.log
files located below the game-specific configuration file(s).
<path-to-SpecialK>
in the below tables refers to the installation folder of Special K, while<game-specific>
refers to either the title of the game (Steam releases) or the executable filename of the game (other platforms).
All paths shown on the wiki can be assumed to be relative to the install folder of Special K unless specified to be relative to a local game-specific install. Special K is set up to store all of its global user data in or below its install folder, in particular global, profiles, macros, keybindings, and plugins related data.
Special K has used a few different install locations over the years, but it is usually one of the following:
Type of install | Default Location |
---|---|
Modern (current user; non-elevated) | %LOCALAPPDATA%\Programs\Special K |
Modern (all users; elevated) | %PROGRAMFILES%\Special K |
Legacy | %USERPROFILE%\Documents\My Mods\SpecialK |
Where the SK configuration for a game is stored depends on what type of install Special K is using to interface with the game.
Type of install | Location |
---|---|
Global | <path-to-SpecialK>\Profiles\<game-specific>\SpecialK.ini |
Local (converted from global / centralized profile) | <path-to-SpecialK>\Profiles\<game-specific>\<DLL-name>.ini |
Local (manual / custom mod) | <path-to-game>\<DLL-name>.ini |
Some older game-specific mods use a separate
*.ini
file to store the configuration for game-specific tweaks, such asFAR.ini
for the FAR (Fix Automata Resolution) mod for NieR: Automata.
Configuration for some modules (e.g. achievements, macros, OSD, widgets) are stored in
<path-to-SpecialK>\Global\*.ini
A full list of supported parameters and their description can be found in the source code.
Below is a table of what the tab-based columns of the source code correspond to.
Column | Comment |
---|---|
1 | Internal parameter name. |
2 | Description of what the parameter does. |
3 | Lists what configuration file the parameter resides in:
|
4 | Lists the section of said configuration file (e.g. [Input.Cursor] ). |
5 | Lists the key for the parameter used in the configuration file (e.g. UseHardwareCursor ) |
The configuration of a game can be reset by either of the following methods:
Hold down Ctrl + ⇧ Shift while launching the game to open the Special K Compatibility Layer window, then click on [Reset Config].
Close the game and delete the existing configuration file from the appropriate location:
Type of install | Location |
---|---|
Global | <path-to-SpecialK>\Profiles\<game-specific>\SpecialK.ini |
Local (converted from global) | <path-to-SpecialK>\Profiles\<game-specific>\SpecialK.ini |
Local (manual / custom mod) | <path-to-game> or in the game executable folder. Filename mirrors DLL file, e.g.dxgi.ini . |
If any default or master presets exists and are applicable for the type of install and injection method being used for the game, they will still be applied for the game until those relevant files are also removed.
Since sometimes during the first half of 2022 the global injector of Special K automatically defaults to using relative paths based on the location of the SpecialK[32|64].dll
DLL files to manage the global Special K settings and profile folders. Local injections, however, uses the registry key HKEY_CURRENT_USER\Software\Kaldaien\Special K
and the Path
value to identify where to look for and store the global configuration.
On 16 August, 2022 Special K received support for overridding the registry key for local injections if an environmental variable SPECIALK_PATH
is set in the context that the game process gets launched in. This allows redirecting global settings on a game-by-game basis provided local injection is used.
On October 25, 2020 Special K gained the ability to set default settings (either global or game-specific) using a default_<DLL-name>.ini
that will automatically be applied the first time a game is launched or after resetting the Special K config for the game.
Type of Install | Location |
---|---|
All games | <path-to-SpecialK>\Global\ |
Game-specific (global injection) | <path-to-SpecialK>\Profiles\<game-specific> |
Game-specific (local injection) | <path-to-game> |
Game-specific (local injection; converted from global / centralized profile) | <path-to-SpecialK>\Profiles\<game-specific> |
default_<DLL-name>.ini
where <DLL-name>
is replaced with the injection method the settings should apply for:Global injection: | <DLL-name> |
---|---|
Global injection | SpecialK |
Local injection: | <DLL-name> |
---|---|
OpenGL | OpenGL32 |
DirectX 12 | DXGI |
DirectX 11 | DXGI or D3D11 |
DirectX 9 | D3D9 |
DirectX 8 | D3D8 |
DirectDraw | DDRAW |
DirectInput 8 | DInput8 |
The all games defaults are loaded first followed by the game-specific defaults if one exists. This allows the use of global defaults combined with specific overrides for those games that might need it.
The more parameters are being set, the more likely it is that things will break.
Special K supports setting “master overrides” that enforces parameter values and overrides any automatically adjusted or user adjusted values. These can either be used to force a specific parameter value for a single game, or across all games. It is best to keep these as limited as possible, because of the aforementioned inability for the user to adjust the parameters unless they remove or edit the applicable master preset directly.
Shared master settings overrides any and all unique game-specific configurations that may otherwise be set, including those set by any default or game-specific master presets that might exist. Use at your own risk!
On June 13, 2020 Special K gained the ability to set master settings using master_<DLL-name>.ini
that will automatically be applied for all games, always.
Browse to <path-to-SpecialK>\Global\
Create a new file called master_<DLL-name>.ini
where <DLL-name>
is replaced with the name of the DLL the settings should be used for:
Should apply for | <DLL-name> |
---|---|
Global injection | SpecialK |
OpenGL | OpenGL32 |
DirectX 12 | DXGI |
DirectX 11 | DXGI or D3D11 |
DirectX 9 | D3D9 |
DirectX 8 | D3D8 |
DirectDraw | DDRAW |
DirectInput 8 | DInput8 |
The more parameters are being set, the more likely it is that things will break.
Type of Install | Location |
---|---|
Game-specific (global injection) | <path-to-SpecialK>\Profiles\<game-specific> |
Game-specific (local injection) | <path-to-game> |
Game-specific (local injection; converted from global / centralized profile) | <path-to-SpecialK>\Profiles\<game-specific> |
custom_<DLL-name>.ini
where <DLL-name>
is replaced with the name of the DLL the settings should be used for:Should apply for | <DLL-name> |
---|---|
Global injection | SpecialK |
OpenGL | OpenGL32 |
DirectX 12 | DXGI |
DirectX 11 | DXGI or D3D11 |
DirectX 9 | D3D9 |
DirectX 8 | D3D8 |
DirectDraw | DDRAW |
DirectInput 8 | DInput8 |
Special K settings can be set on a global scale as described in Master presets; below is a non-exhaustive list of notable settings to use this way.
Please note that there are also settings described here that are global by default.
This setting warns you when multiplane overlay support isn’t working on your system.
[Display.Monitor]
WarnIfNoOverlayPlanes=true
Add this to your master_SpecialK.ini
as described in Master presets to use it in all games.
This setting descreases the default 10ms audio buffer to the lowest your hardware supports.
Using this requires a special audio driver, see Low Latency Audio for more information.
[Sound.Mixing]
MinimizeLatency=true
Add this to your master_SpecialK.ini
as described in Master presets to use it in all games.
This setting lets you disable Special K’s iconic sound when a game crashes.
[SpecialK.System]
NoCrashSound=true
Add this to your master_SpecialK.ini
as described in Master presets to use it in all games.
This setting lets you set a custom path for screenshots captured with Special K and is stored in <path-to-SpecialK>\Global\osd.ini
.
[Screenshot.System]
OverridePath=
Important: The path must exist, or Special K will use the default per-profile path.
This can be done from the DLSS Control Panel, or can be done manually
This option lets you auto-load an updated DLSS DLL from SK’s Plug-In Directory.
Create the directory: SpecialK\PlugIns\ThirdParty\NVIDIA
Place an updated version of nvngx_dlss.dll
there
Set the following in SpecialK.ini
:
[NVIDIA.DLSS]
AutoRedirectDLL=true
If you want this by default, you can set it in default_SpecialK.ini
, as described in Default Presets, after setting up the correct file location.
Please be aware that doing this in multiplayer titles (e.g. Diablo 4) could have you run into issues if the game treats any DLL replacement as a sign of tampering.
Command | Function |
---|---|
TargetFPS *** |
Sets the FPS limiter to the specified target FPS (replace the asterisks with a number) |
TargetFPS ++ TargetFPS -- |
Increases or decreases the FPS limiter |
TargetFPS ~ |
Toggles the FPS limiter |
BackgroundFPS *** |
Sets the background FPS limiter to the specified FPS (replace the asterisks with a number) |
BackgroundFPS ++ BackgroundFPS -- |
Increases or decreases the background FPS limiter |
Window.BackgroundRender toggle |
Toggles the ‘Continue Rendering’ option, which may keep the game rendering in the background (may keep gamepad input in the game) |
Window.BackgroundMute toggle |
Toggles the ‘Mute Game’ (audio) option for when the game is rendering in the background |
Window.Center toggle |
Toggles the ‘Center’ option to center the game’s window |
Window.Borderless toggle |
Toggles the ‘Borderless’ option for the game’s window |
Window.Fullscreen toggle |
Toggles the ‘Fullscreen Borderless’ option for the game’s window (requires using the Borderless option first) |
Window.ConfineCursor toggle |
Toggles the option to keep the mouse cursor inside the game’s window |
Window.UnconfineCursor toggle |
Toggles the option to unrestrict the mouse cursor so that it may go outside the game’s window |
Input.Mouse.DisableToGame toggle |
Toggles mouse input for the game |
Input.Keyboard.DisableToGame toggle |
Toggles keyboard input for the game |
Input.Gamepad.DisableToGame toggle |
Toggles gamepad input for the game |
HDR.Visualization ++ HDR.Visualization -- |
Iterates through the available HDR visualizations |
HDR.AdaptiveToneMap toggle |
Toggles the HDR ‘Adaptive Tone Mapping’ option |
HDR.Bypass_sRGB * |
Enables or disables HDR Bypass sRGB Gamma (replace the asterisk with the number 1 to enable it or 0 to disable it) |
HDR.Enable * |
Enables the scRGB HDR option (replace the asterisk with the word false to disable HDR or true to enable scRGB HDR — may still need a game restart) |
HDR.EnableHDR10 toggle |
Toggles the HDR10 option (may still need a game restart) |
HDR.EnableSCRGB toggle |
Toggles the scRGB HDR option (may still need a game restart) |
Macros can be set up to issue command consoles using custom keybindings through a global configuration file.
Open <path-to-SpecialK>\Global\macros.ini
Add a new section like the below to the file:
[Macro.RelevantNameOfYourChoice]
<modifier-key>+<regular-key>=Console-command-to-execute
Customize the section to your liking and any add desired keybindings for console commands.
Macro.SpecialK_OSD_Toggles
section:[Macro.SpecialK_OSD_Toggles]
Ctrl+Shift+O=OSD.Show toggle
Ctrl+Shift+M=OSD.Memory.Show toggle
Ctrl+Shift+T=OSD.Clock.Show toggle
Ctrl+Shift+I=OSD.IOPS.Show toggle
Ctrl+Shift+F=OSD.FPS.Show toggle
Ctrl+Shift+G=OSD.GPU.Show toggle
Ctrl+Shift+R=OSD.Shaders.Show toggle
Ctrl+Alt+Shift+D=OSD.Disk.Show toggle
Ctrl+Alt+Shift+P=OSD.Pagefile.Show toggle
Ctrl+Alt+Shift+S=OSD.SLI.Show toggle
Ctrl+Shift+C=OSD.CPU.Show toggle
Alternatively, you could also have macros in a game specific configuration file (such as in a SpecialK.ini or in a dxgi.ini).
Log files are located in one of the following locations, based on the type of install of Special K being used:
Type of install | Location |
---|---|
Global | <path-to-SpecialK>\Profiles\<game-specific>\logs\*.log |
Local (converted from global / centralized profile) | <path-to-SpecialK>\Profiles\<game-specific>\logs\*.log |
Local (manual / custom mod) | <path-to-game>\logs\*.log |
The crash handler of Special K will move all logs related to a crash to a time-specific
<path-to-game>\logs\crash\<timestamp>\*.log
folder if it manages to capture data about the crash.
Important log files are marked as such.
Log file | Purpose |
---|---|
crash.log |
Stores captured crash data if the crash handler of Special K were able to capture data related to the crash. |
SpecialK.log or <DLL-name>.log |
(Important) Main log file for Special K, stores injection, render pipeline, and other related events. |
dxgi_budget.log |
Stores aggregated DXGI memory statistics over the play session at the time of shutdown. |
game_output.log |
Stores everything the game outputs to the standard output stream of the operating system. |
modules.log |
(Important) Stores detected loaded/injected DLL files of the game. Note that tools or applications using more obscure ways of injecting themselves to avoid detection will not listed in this log file. |
ReShade.log |
If used, stores logs related to the custom ReShade plug-in of Special K. |
steam_api.log |
Stores logs related to the Steam API and enhancements. |
The below sections details general keybindings and functionality not related to a specific topic covered elsewhere on the wiki. For keybindings related to e.g. audio management, see the Audio page.
Keybinding | Function |
---|---|
Keyboard: Ctrl + ⇧ Shift + ← Backspace Controller: Back / Select + Start |
Toggle Control Panel |
Ctrl + ⇧ Shift + O | Toggle On Screen Display (OSD), might require a game restart |
Hold Ctrl + ⇧ Shift while launching the game | Opens the Injection Compatibility Options |
Unless otherwise noted, W/A/S/D can substitute the arrow keys.
Keybinding | Function |
---|---|
Keyboard: ⇪ Caps Lock Controller: Hold Back / Select for 0.5 seconds |
Toggle Exclusive Input Mode (game vs. control panel) |
Keyboard: ↑, ↓, ←, → Controller: ↑, ↓, ←, → |
Cycle Through UI Items |
Keyboard: ↵ Enter Controller: A / × |
Activate Selected Item |
Keyboard: Ctrl + ⇧ Shift + ← Backspace Controller: B / ○ |
Exit Menu |
Exclusive Keyboard Mode: Ctrl + Alt + ↑, ↓, ←, → Controller: X / □ + Left Analog Stick |
Move the Control Panel |
<path-to-SpecialK>\Global\osd.ini
<path-to-SpecialK>\Global\macros.ini
Keybinding | Function |
---|---|
Ctrl + ⇧ Shift + O | Toggle On Screen Display (OSD) |
Ctrl + ⇧ Shift + + / - | Resize |
Ctrl + ⇧ Shift + F | Toggle Framerate Counter |
Ctrl + ⇧ Shift + T | Toggle Clock / Version |
Ctrl + ⇧ Shift + G | Toggle GPU Monitor |
Ctrl + ⇧ Shift + C | Toggle CPU Monitor |
Ctrl + ⇧ Shift + M | Toggle Memory Monitor |
Ctrl + ⇧ Shift + I | Toggle I/O Monitor |
Ctrl + ⇧ Shift + Alt + D | Toggle Disk Monitor |
Ctrl + ⇧ Shift + Alt + P | Toggle Page File Monitor |
Ctrl + ⇧ Shift + R | Toggle D3D11 Shader Analytics |
Keybinding | Function | Comment |
---|---|---|
Ctrl + ⇧ Shift + Tab ↹ | Command Console | See documentation for commands |