Windows Native Toolkit | Configuration Library

Wildcard config values, arrays, encryption, asset paths, and config file utilities for Unreal projects.

Use this library to read and write Unreal config files with wildcard Blueprint pins, native config arrays, encrypted strings, and path-safe config file utilities.

Want Advanced Config Features?

Configuration Toolkit is a dedicated plugin for advanced Unreal config management, supporting wildcards, encryption, and cross-platform workflows.

View on Fab

Project Settings

Configure config-file behavior in Project Settings > Plugins > Windows Native Toolkit, under the Config Files category.

Windows Native Toolkit Project Settings - Config Files

File Name Behavior

Most nodes expose an optional File Name pin.

File Name	Result
Empty	Uses the default file name from WNT config settings.
`Game`	Resolves Unreal's generated `Game.ini`.
`Engine`	Resolves Unreal's generated `Engine.ini`.
`Profiles/UserA`	Resolves under Unreal's generated config directory and appends `.ini` if needed.
Absolute `.ini` path	Uses that exact file path.

Typical Editor Output

Saved/Config/WindowsEditor/

Typical Packaged Output

Saved/Config/Windows/

Write Config Value

Field	Details
Purpose	Writes one Blueprint value to a config key. The `Value` pin is a wildcard pin, so the connected pin type controls serialization.
Gives	`bool` return value
Needs	`Section`, `Key`, `Value`, `File Name`.

C++ Equivalent

FString SerializedValue = TEXT("600.0");
GConfig->SetString(TEXT("Player"), TEXT("Speed"), *SerializedValue, GGameIni);
GConfig->Flush(false, GGameIni);

Read Config Value

Field	Details
Purpose	Reads one config key back into the connected wildcard output pin type.
Gives	`bool` return value; output pin(s) `Value`
Needs	`Section`, `Key`, `Value`, `File Name`.

C++ Equivalent

FString SerializedValue;
if (GConfig->GetString(TEXT("Player"), TEXT("Speed"), SerializedValue, GGameIni))
{
    const float Speed = FCString::Atof(*SerializedValue);
}

Write Config Array

Field	Details
Purpose	Writes a Blueprint array using Unreal's native repeated config key format.
Gives	`bool` return value
Needs	`Section`, `Key`, `Values`, `File Name`.

C++ Example

TArray<FString> Items = { TEXT("Sword"), TEXT("Shield") };
GConfig->SetArray(TEXT("Inventory"), TEXT("Items"), Items, GGameIni);
GConfig->Flush(false, GGameIni);

Read Config Array

Field	Details
Purpose	Reads a native config array back into the connected Blueprint array type.
Gives	`bool` return value; output pin(s) `Values`
Needs	`Section`, `Key`, `Values`, `File Name`.

C++ Example

TArray<FString> Items;
const int32 Count = GConfig->GetArray(TEXT("Inventory"), TEXT("Items"), Items, GGameIni);

Add Unique To Config Array

Field	Details
Purpose	Adds one value to a config array only if an equivalent serialized value does not already exist.
Gives	`bool` return value
Needs	`Section`, `Key`, `Value`, `File Name`.

C++ Example

TArray<FString> Items;
GConfig->GetArray(TEXT("Inventory"), TEXT("Items"), Items, GGameIni);
Items.AddUnique(TEXT("Potion"));
GConfig->SetArray(TEXT("Inventory"), TEXT("Items"), Items, GGameIni);
GConfig->Flush(false, GGameIni);

Remove From Config Array

Field	Details
Purpose	Removes all matching values from a config array.
Gives	`bool` return value
Needs	`Section`, `Key`, `Value`, `File Name`.

C++ Example

TArray<FString> Items;
GConfig->GetArray(TEXT("Inventory"), TEXT("Items"), Items, GGameIni);
Items.Remove(TEXT("Potion"));
GConfig->SetArray(TEXT("Inventory"), TEXT("Items"), Items, GGameIni);
GConfig->Flush(false, GGameIni);

Write Encrypted String

Field	Details
Purpose	Encrypts one string with the AES key from WNT config settings and stores it as Base64 text.
Gives	`bool` return value
Needs	`Section`, `Key`, `Value`, `File Name`.

C++ Example

const bool bSuccess = UConfigurationLibrary::WriteEncryptedString(TEXT("Auth"), TEXT("Token"), TEXT("SecretValue"), TEXT("Game"));

Read Encrypted String

Field	Details
Purpose	Reads a Base64 config value and decrypts it with the AES key from WNT config settings.
Gives	`bool` return value; output pin(s) `Value`
Needs	`Section`, `Key`, `Value`, `File Name`.

C++ Example

FString Value;
const bool bSuccess = UConfigurationLibrary::ReadEncryptedString(TEXT("Auth"), TEXT("Token"), Value, TEXT("Game"));

Convert Asset To Path

Field	Details
Purpose	Converts an asset object reference to a soft object path string without loading anything new.
Gives	`FString` return value
Needs	`Asset`.

C++ Example

const FString Path = UConfigurationLibrary::ConvertAssetToPath(Asset);

Convert Class To Path

Field	Details
Purpose	Converts a class reference to a soft class path string.
Gives	`FString` return value
Needs	`Class`.

C++ Example

const FString Path = UConfigurationLibrary::ConvertClassToPath(ActorClass);

Convert Path To Asset

Field	Details
Purpose	Converts a path string to a soft asset reference without loading the asset.
Gives	`bool` return value; output pin(s) `Asset`
Needs	`Path`, `Asset`.

C++ Example

TSoftObjectPtr<UObject> Asset;
const bool bSuccess = UConfigurationLibrary::ConvertPathToSoftAssetReference(TEXT("/Game/UI/WBP_Menu.WBP_Menu"), Asset);

Convert Path To Class

Field	Details
Purpose	Converts a path string to a soft class reference without loading the class.
Gives	`bool` return value; output pin(s) `Class`
Needs	`Path`, `Class`.

C++ Example

TSoftClassPtr<UObject> Class;
const bool bSuccess = UConfigurationLibrary::ConvertPathToSoftClassReference(TEXT("/Game/BP/BP_Enemy.BP_Enemy_C"), Class);

Clear Config Key

Field	Details
Purpose	Removes one scalar key or all repeated array entries for that key.
Gives	`bool` return value
Needs	`Section`, `Key`, `File Name`.

C++ Example

const bool bSuccess = UConfigurationLibrary::ClearConfigKey(TEXT("Player"), TEXT("Speed"), TEXT("Game"));

Clear Config Section

Field	Details
Purpose	Removes every key from one config section.
Gives	`bool` return value
Needs	`Section`, `File Name`.

C++ Example

const bool bSuccess = UConfigurationLibrary::ClearConfigSection(TEXT("Player"), TEXT("Game"));

Remove Config Section

Field	Details
Purpose	Removes a whole section and all keys stored inside it.
Gives	`bool` return value
Needs	`Section`, `File Name`.

C++ Example

const bool bSuccess = UConfigurationLibrary::RemoveConfigSection(TEXT("Player"), TEXT("Game"));

Delete Config File

Field	Details
Purpose	Deletes a generated project config file and unloads it from `GConfig` when possible.
Gives	`bool` return value
Needs	`File Name`.

C++ Example

const bool bSuccess = UConfigurationLibrary::DeleteConfigFile(TEXT("Profiles/UserA"));

Does Config Key Exist

Field	Details
Purpose	Checks whether a key exists in a config file. Leave `Section` empty to search every section in the file.
Gives	`bool` return value
Needs	`Section`, `Key`, `File Name`.

C++ Example

const bool bExists = UConfigurationLibrary::DoesConfigKeyExist(TEXT("Player"), TEXT("Speed"), TEXT("Game"));

Does Config File Exist

Field	Details
Purpose	Checks whether the resolved config file exists on disk.
Gives	`bool` return value
Needs	`File Name`.

C++ Example

const bool bExists = UConfigurationLibrary::DoesConfigFileExist(TEXT("Game"));

Get Config Sections

Field	Details
Purpose	Returns every section name currently known for the resolved config file.
Gives	`TArray<FString>` return value
Needs	`File Name`.

C++ Example

const TArray<FString> Sections = UConfigurationLibrary::GetConfigSections(TEXT("Game"));

Flush Config

Field	Details
Purpose	Forces the resolved config file to flush from `GConfig` to disk.
Gives	`bool` return value
Needs	`File Name`.

C++ Example

const bool bSuccess = UConfigurationLibrary::FlushConfig(TEXT("Game"));

Notes

Write Config Value and Read Config Value are Blueprint wildcard nodes. In native C++, use GConfig directly when you need exact typed serialization logic.
Soft object and soft class reads do not load assets. Use Unreal's async loading nodes when you need the loaded object or class.
Encrypted string nodes require a 32-character, 32-byte AES key in Project Settings > Plugins > Windows Native Toolkit, under Config Files.
For generated configs on UE 5.4+, make sure the target file allows saving sections when you expect writes to persist.

Configuration Library

Want Advanced Config Features?

On this page