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_StringConstbytecode as string to a UberJSON file. - Ability to modify
EX_StringConstwith those specified replacement in the UberJSON file. - Corrects
EX_UnicodeStringConstnew offsets for correct work in the game. - Extract and modify each
StrPropetyandTextPropertystring. - Fallback extract and modify any other type, as
LocalizedSource,StringTable,DataTable, but with some risk.
Made with ❤️ for all translators and translation developers.
- Or download and drag & drop
(.uasset|.umap)to a command tool. - Or use
Kisse.exe <file_path>. - Do not use this in Windows Powershell.
Note
Logic of the work in CLI:
kisse <asset/folder_path> <json/null> <...args>
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
UFunctionin the asset.
Read .pak, .ucas or .utoc assets without unpacking the archive:
kisse "Paks\Game-WindowsNoEditor.ucas" "strings.json" -vir -v 4.27Replacement 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.
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.27For IoStore, use a .utoc output; the matching .ucas and companion .pak are created automatically:
kisse "MyMod" -pack="C:\Mods\Game_P.utoc" -v 4.27Apply 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"| 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. |
| 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) |
"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.
- 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.