Python library for working with Unreal Engine .locres translation files.
The library supports all versions of Locres
pip install pylocres
or instal from repository
from pylocres import LocresFile, Namespace, Entry, LocresVersion, entry_hash
# create locrese instance
locres = LocresFile()
# read locres file
locres.read("./path/to/file.locres")
# iterate over all Namespaces in locres
for namespace in locres:
print(namespace.name) # print namespace name
# Usually, the standard name is “” (empty text), so
# if the name is not displayed, everything is fine.
# iterate over all Entrys in Namespace
for entry in namespace:
print(entry.key) # cf433749-2e... (uuid4 or custom key)
print(entry.translation) # Hello world!
print(entry.hash) # 828975897
# entry.hash - source localization hash (default: English),
# we can create our own hash if necessary, but it should be
# replaced only when the problem is in the game itself.
entry.hash = entry_hash("Hello world!")
# set a new translation
entry.translation = "Привіт світ!"
# create new Entry
entry = Entry(key, translation, source_hash)
# add Entry to Namespace
namespace.add(entry)
# create new Namespace
namespace = Namespace("UI")
# add Namespace to file
locres.add(namespace)
# set namespace (default last version is CityHash)
locres.version = LocresVersion.CityHash
# save Locres file
locres.write("./path/to/file.locres")
# Donefrom pylocres import LocmetaFile, LocmetaVersion
# create locrmeta instance
locmeta = LocmetaFile()
# read locmeta file
locmeta.read("./path/to/file.locres")
print(locmeta.version)
print(locmeta.native_culture) # native language of game (en)
print(locmeta.native_locres) # native language locres file (en/Game.locres)
print(locmeta.compiled_cultures) # All compiled languages (["en", "de", "fr", ...])
locmeta.native_culture = "YOUR_CULTURE"
# write locmeta file
locmeta.write("./path/to/file.locres")
# Done