Skip to content

About

Unreal Engine kismet strings extractor and replacer.

Topics

Resources

Stars

11 stars

Watchers

1 watching

Forks

Repository files navigation

Solicen.KissE

Englsih | Русский

KissE is a script/tool for processing and modifying EX_StringConst inside the Unreal Enigne Kismet bytecode. It allows you to both get all available for extraction strings EX_StringConst and replace them with EX_UnicodeStringConst by changing the instruction itself inside the bytecode.

UAssetAPI is used to work with Unreal Engine files and bytecode.

Key features of kissE:

  • Allows you to extract EX_StringConst bytecode as string to a UberJSON file.
  • Ability to modify EX_StringConst with those specified replacement in the UberJSON file.
  • Corrects EX_UnicodeStringConst new offsets for correct work in the game.
  • Extract and modify each StrPropety and TextProperty string.
  • Fallback extract and modify any other type, as LocalizedSource, StringTable, DataTable, but with some risk.

Made with ❤️ for all translators and translation developers.

Usage

  • Or download and drag & drop (.uasset|.umap) to a command tool.
  • Or use Kisse.exe <file_path>.
  • Do not use this in Windows Powershell.

Kis(met) s(tring) E(ditor)

Note

Logic of the work in CLI:

Extract: (From) Asset/Folder => (To) JSON/OrNull

kisse <asset/folder_path> <json/null> <...args>

Replace: (From) JSON/CSV => (To) Asset/Folder

kisse <json_path> <asset/folder_path> <...args>

Tip

If some EX_StringConst strings are missing, try the -sc argument.

  • This will extract them from all UFunction in the asset.

Virtual archives (PAK / IoStore)

Read .pak, .ucas or .utoc assets without unpacking the archive:

kisse "Paks\Game-WindowsNoEditor.ucas" "strings.json" -vir -v 4.27

Replacement uses the same virtual provider:

kisse "strings.json" "Paks\Game-WindowsNoEditor.ucas" -vir -v 4.27 --pack-folder="MyMod"

Modified assets are written as separate legacy files under the output folder. Source archives are never modified.

Creating PAK / IoStore mods

Pack an existing cooked mod root (preserve paths such as <Game>/Content/UI/Menu.uasset):

kisse "MyMod" -pack="C:\Mods\Game_P.pak" -v 4.27

For IoStore, use a .utoc output; the matching .ucas and companion .pak are created automatically:

kisse "MyMod" -pack="C:\Mods\Game_P.utoc" -v 4.27

Apply JSON/CSV translations and immediately build a mod from the processed assets:

kisse "strings.ru.json" "Paks\Game.ucas" -vir -v 4.27 -all -pack="C:\Mods\Game_P.utoc"

Main arguments:

Argument Short Description
--sconst -sc Extract strings EX_StringConst from all UFunction with ScriptBytecode.
--tprop -tp Extract fallback localization strings with TextProperty type.
--lsource -ls Extract fallback localization strings with LocalizedSource.
--dstable -dst Extract fallback localization strings from Data/String Table assets.
--alltypes -all Extract strings from all possible types (includes Table and LocalizedSource and TextProperty).
--no-filter -nf Disables string filter function while processing.
--no-backup -nobak Disables the creation of .bak backup files.
-no-underscore -un Excludes strings that contain the '_' character.
--all-directories -alldir Disables filter with specifed directory names for analyze and asset processing.
--namespace -ns Include name/key::value (e.g., "ENG::Gori") in output JSON
--mapping -map Specified .usmap nearby .exe as mappings for processing (e.g., -map="Gori_umap.usmap")
--mapping-auto -ma Uses the usmap file if it finds it nearby.
--patch-all-functions -paf Iterate the bytecode-replacement pipeline over every UFunction with a ScriptBytecode (not just ExecuteUbergraph_*). Needed for widget event handlers and other functions that hold their (EX_StringConst) outside the ubergraph.
--patch-assignments -pa Also replace (EX_StringConst) inside an AssignmentExpression in the ubergraph (off by default to avoid touching technical paths/keys; opt-in for game text hardcoded via 'Set Text' / 'Print String' Blueprint nodes).
--only-key -tok If key/name matches then include only this value to output (e.g., -tok=ENG)
--pack -pack Create a new .pak or .utoc/.ucas/.pak mod from a cooked folder or after JSON/CSV replacement; requires --version.
--pack-folder -pf Translate and pack assets into auto prepared folder (e.g., "ManicMiners_RUS")
--version -v Set the engine version for correct processing (e.g., -v=5.1)
--run -r Execute a command in the terminal after completion (e.g., --run=[CommandArgs])
--debug -d Write additional files for debug: Ubergraph.json
--virtual -vir Read PAK/UCAS/UTOC archives in memory; required for IoStore.
--no-oodle-download -noodle Disable Oodle downloads; require an embedded or local DLL.
--aes -a AES-256 key: 64 hex characters, optionally prefixed with 0x.
--help -h Show help information.

Translator arguments:

Argument Short Description
--endpoint -e Translation service endpoint (e.g., -e=router (yandex, google, microsoft, router as OpenRouter))
--api-key -api Key for OpenRouter api (e.g., -api=sk...)
--api-model -model Model for OpenRouter (e.g, -Model=tngtech/deepseek-r1t2-chimera:free)
--source-lang -sl Source language for translation (e.g., --sl=en)
--target-lang -tl Target language for translation (e.g., --tl=ru)

Real example of [CommandArgs] usage:

"A:\SteamLibrary\steamapps\common\Wigmund\RPG\Content\Paks\UI_Tooltip.csv" "A:\SteamLibrary\steamapps\common\Wigmund\RPG\Content\Paks\s_rus_NEW_P\RPG\Content\RPG\Blueprints\UI\Game\UI_Tooltip.uasset" [A:\SteamLibrary\steamapps\common\Wigmund\RPG\Content\Paks\UnrealPak-With-Compression.bat s_rus_NEW_P | start A:\SteamLibrary\steamapps\common\Wigmund\RPG\Binaries\Win64\RPG-Win64-Shipping.exe]
  • The process is fully automated here.
  • Start the process of replacing lines in the asset in a specific folder.
  • Inside [CommandArgs]: I connect to UnrealPak.exe and I hand over the folder that needs to be packed (the one with the asset)
  • After packing, the game starts next to check its performance. The commands are separated via '|'
  • Profit. The process is fully automated to test how the game and asset work after modification.

Contributions

  • You can create your own fork of this project and contribute to its development.
  • You can also contribute via the Issues and Pull Request tabs by suggesting your code changes. And further development of the project.

Thanks

About

Unreal Engine kismet strings extractor and replacer.

Topics

Resources

Stars

11 stars

Watchers

1 watching

Forks

Releases

Sponsor this project

Packages

Used by

Contributors

Languages