使用虚幻引擎进行《噬血代码》本地化的操作指南

Инструкция по работе с UE для локализации VEIN. Для работы можно создать свой файл локализации или взять за основу другой. Далее на примере уже готового .pak с локализацией. Качаем UnrealEngine (любую версию, у VEIN 5.4.0, но можно и 5.6) в Epicgames, в нём есть UnrealPak.exe, дополнительно качаем UE4localizationsTool. Открываем командную строку Win+R->cmd В командной строке отправляем команду(Все директории должны быть предварительно созданы и пути у вас могут быть свои): & "C: Program Files Epic Games UE_5.6 Engine Binaries Win64 UnrealPak.exe" - Путь до UnrealPak.exe   "C: Temp Vein_RU_P.pak" - Путь до нужного ,pak для распаковки -Create="C: Temp paklist.txt" - Лист понадобиться для обратной упаковки Распакованный .pak будет содержать Game.locres, который нужно открыть через UE4localizationsTool и появиться доступ к редактированию строк. Могут быть проблемы с уже добавленными строками и их Hash. если оно вроде бы на русском языке в UE4localizationsTool, но в игре нет. Для этого понадобятся UE4SS и FModel, UE4SS скачать и закинуть по пути ...Steam steamapps common VEIN VEIN Binaries Win64 В UE4SS-settings.ini нужно изменить параметры: MajorVersion = 5 MinorVersion = 4 ; Для UE5.4 ConsoleEnabled = 1 GuiConsoleEnabled = 1 GuiConsoleVisible = 1 ; Чтобы видеть GUI UE4SS GraphicsAPI = dx12 ; Или dx11, если dx12 не работает (проверь в настройках игры, какой API используется) Запустить игру и в консоли UE4SS перейти во вкладку Dumpers и нажать Generate .usmap file. Файл Mappings.usmap(Он нужен будет для Fmodel для открытия .uasset) появится в той же папке Win64, рядом с exe. Запускаем FModel переходим в Settings, в строке Local Mapping File ставим крест и Mapping File Path указать путь до сгенерированного файла Mappings.usmap, это позволит открывать .uasset файлы игры. Чтобы открыть .uasset файлы игры, их нужно получить полностью распаковав все .pak игры по пути ...Steam steamapps common Vein Vein Content Paks Создайте .txt файл в папке с .pak в ...Steam steamapps common Vein Vein Content Paks Закиньте баш скрипт @echo off set UNREALPAK="C: Program Files Epic Games UE_5.4 Engine Binaries Win64 UnrealPak.exe" set OUTPUT="C: Temp VEIN_unpack_full" for %%f in (*.pak) do ( echo Распаковка %%f... %UNREALPAK% "%%f" -extract %OUTPUT% %AES% ) pause Переименуйте файл .txt в .bat и запустить от имени администратора баш скрипт, он распакует все .pak в нужную директорию OUTPUT. После этого переходим в FModel, выбираем раздел Directory->Selector, нажимаем на две стрелки (вниз-вверх) ADD UNDETECTED GAME, указываем путь до директории с распакованными файлами игры, имя любое по желанию. Далее в главном окне FModel, в разделе Archives выбрать Loading Mode - All, ниже нажать Load и у вас загрузит все директории с .uasset файлами. Теперь двойным кликом их можно открыть, найти нужны Key для UE4localizationsTool и нужный текст строки. Копировать нужно key и SourceString в UE4localizationsTool без ковычек при создании строки(Add New Row) "Namespace": "", "Key": "A5E755DE451DFD803C14B380180A3303", - Отсюда нам нужно A5E755DE451DFD803C14B380180A3303 "SourceString": "Bandana", - Отсюда нам нужно Bandana "LocalizedString": "Bandana" В UE4localizationsTool, когда мы уже открыли Game.locres мы может нажать на верхней панели Locres Operations и добавить новую строку через Add New Row в Namespace если он пустой в .uasset оставляем поле пустым, при этом нажимаем C, чтобы задать нулевой(0) Hash, далее из .uasset копируем key и вставляем его, нажимаем C генерируется нужный Hash, далее также с Value, копируем фразу без ковычек из SourceString или LocalizedString, нажимаем C генерируем Hash и нажимаем Add. В уже созданной строке мы можем менять текст как угодно, нужный Hash указан и текст в игре измениться, если не делать как выше, то с неверным Hash, текст не измениться в игре. Также есть проблема с текстом в .uasset для UE4localizationsTool, что к примеру длинная фраза и будет иметь формат ... flashing images, even if they have no history of epilepsy or seizures. r n r nThis game may contain flashing lights. r n r nIf you may be susceptible to photosensitive ... - r n r n значит нужно отступить, сделать абзац. Закиньте данную строку в блокнот и нажмите Enter удалив символы r n r n, скопируйте из блокнота текст и вставьте текст в Value при создании строки. Instruction for working with UE for localizing VEIN. You can create your own localization file or use an existing one as a base. Next, using an example of a ready-made .pak with localization. I apologize for any incorrect English for English-speaking users. Download Unreal Engine (any version; VEIN uses 5.4.0, but 5.6 works too) from the Epic Games Launcher. It includes UnrealPak.exe. Additionally, download UE4LocalizationsTool. Open the command prompt with Win+R -> cmd. In the command prompt, run the command (all directories must be created beforehand, and paths may vary): & "C: Program Files Epic Games UE_5.6 Engine Binaries Win64 UnrealPak.exe" - Path to UnrealPak.exe "C: Temp Vein_RU_P.pak" - Path to the .pak file to unpack -Create="C: Temp paklist.txt" - The list will be needed for repacking The unpacked .pak will contain Game.locres, which can be opened via UE4LocalizationsTool to access and edit strings. There may be issues with already added strings and their Hash. If it appears in Russian in UE4LocalizationsTool but not in the game. For this, you'll need UE4SS and FModel. Download UE4SS and place it in ...Steam steamapps common VEIN VEIN Binaries Win64 In UE4SS-settings.ini, change the parameters: MajorVersion = 5 MinorVersion = 4 ; For UE5.4 ConsoleEnabled = 1 GuiConsoleEnabled = 1 GuiConsoleVisible = 1 ; To see UE4SS GUI GraphicsAPI = dx12 ; Or dx11 if dx12 doesn't work (check the game's settings for which API is used) Launch the game, and in the UE4SS console, go to the Dumpers tab and click Generate .usmap file. The Mappings.usmap file (needed for FModel to open .uasset) will appear in the same Win64 folder, next to the exe. Launch FModel, go to Settings, check Local Mapping File, and in Mapping File Path, specify the path to the generated Mappings.usmap. This will allow opening the game's .uasset files. To open the game's .uasset files, unpack all .pak files from ...Steam steamapps common Vein Vein Content Paks Create a .txt file in the .pak folder at ...Steam steamapps common Vein Vein Content Paks Paste the batch script: @echo off set UNREALPAK="C: Program Files Epic Games UE_5.4 Engine Binaries Win64 UnrealPak.exe" set OUTPUT="C: Temp VEIN_unpack_full" for %%f in (*.pak) do ( echo Unpacking %%f... %UNREALPAK% "%%f" -extract %OUTPUT% %AES% ) pause Rename the .txt file to .bat and run the batch script as administrator. It will unpack all .pak into the OUTPUT directory. After that, in FModel, go to Directory -> Selector, click the two arrows (down-up) ADD UNDETECTED GAME, specify the path to the unpacked game files directory, name it anything you want. Then, in the main FModel window, in the Archives section, select Loading Mode - All, click Load below, and it will load all directories with .uasset files. Now, double-click to open them, find the necessary Key for UE4LocalizationsTool and the string text. You need to copy the key and SourceString into UE4LocalizationsTool without quotes when creating a string (Add New Row). "Namespace": "", "Key": "A5E755DE451DFD803C14B380180A3303", - From here, we need A5E755DE451DFD803C14B380180A3303 "SourceString": "Bandana", - From here, we need Bandana "LocalizedString": "Bandana" In UE4LocalizationsTool, once Game.locres is opened, you can click Locres Operations on the top panel and add a new string via Add New Row. If Namespace is empty in .uasset, leave the field empty, then press C to set zero (0) Hash. Next, copy the key from .uasset and paste it, press C to generate the needed Hash. Do the same with Value, copy the phrase without quotes from SourceString or LocalizedString, press C to generate Hash, and click Add. In an already created string, you can change the text as needed; the correct Hash is set, and the text in the game will change. If not done as above, with the wrong Hash, the text won't change in the game. There's also an issue with text in .uasset for UE4LocalizationsTool, for example, a long phrase might have the format ... flashing images, even if they have no history of epilepsy or seizures. r n r nThis game may contain flashing lights. r n r nIf you may be susceptible to photosensitive ... - r n r n means to make a line break, a paragraph. Paste this string into notepad and press Enter, deleting the r n r n symbols, copy the text from notepad, and paste the text into Value when creating the string.