Skip to content

AcTePuKc/uelockit

Repository files navigation

layout page
title README
permalink /readme/

UELocKit

UELocKit is a small Unreal Engine localization modding toolkit for workflows based on existing game strings.

It is built around a few practical goals:

  • edit translations in a safe working format
  • rebuild translated .locres files
  • generate .locmeta
  • package localization mods for Unreal games that use .pak and optionally IO Store
  • document the process without redistributing original game files or third-party binaries

Prerequisites

Before using UELocKit, make sure you have:

  • Python 3.10 or newer
  • PowerShell
  • UnrealLocres
  • UnrealPak
  • retoc for IO Store games

See:

Scope

UELocKit is for translating existing localization keys that already exist in a game.

It is not a general framework for inventing brand-new localization keys and assuming every Unreal game will display them.

License

Repository structure

What users bring themselves

  • Their own game-specific extracted localization files
  • Their own local copies of external tools
  • A local Python installation for the helper scripts

External inputs

Users are expected to provide their own:

  • extracted game localization files
  • local copies of the required external tools

Start here

  1. Read docs/tools.md
  2. Read docs/quickstart.md
  3. Copy config/UELocKit.sample.config.psd1 to config/UELocKit.config.psd1
  4. Put your extracted source files in source/
  5. Point the config at your files and tools
  6. Choose one workflow:
    • start from scratch and generate empty working files
    • continue from an existing translation and convert or refresh it into the working format
  7. Edit the working JSON file
  8. On game updates, compare a new source/Game.<lang>.json against your existing working file
  9. Build and test