[RELEASE] S3TextDataAssetEditor

[LemonHaze]

This is a tool to aid replacing S3TextDataAssets' contents, which is usually used for subtitles etc.

S3TextDataAssetEditor v1.1
==========================

Modes:
==========================
-e | --extract - Extract strings
-r | --replace - Replace strings


Optional flags:
==========================
't' - Dumps text strings to console while processing

Example usage:

    S3TextDataAssetEditor --extract <path to directory to extract> <output dir>
    S3TextDataAssetEditor --replace <original path> <output path> <CSV path>

GitHub Repo

 

[gladias9]

How would I go about getting these subtitles to read in-game?

 

[LemonHaze]

How would I go about getting these subtitles to read in-game?

This tool will replace text for you, so you simply have to make your own PAK files with just your modified files inside it and then have the game load it for you, by placing it in the PAKs directory in your install location. It's sort of become common practice to place your mod PAKs in a directory named "~mods" inside your PAKs folder, mainly for convenience.

 

[gladias9]

Thanks for the response. I'm trying to make a localization mod for the game.

I had a question.. maybe 2 of them actually.

#1. I don't understand the replace function paths.
Original path = where my uassets/uexps I originally extracted are? Output path = Where my .logs from the extraction are? CSV path = ???

#2. How are you creating .paks from scratch? Some games allow me to just name a folder .pak but Shenmue 3 isn't like that.

 

[LemonHaze]

#1. I don't understand the replace function paths.
Original path = where my uassets/uexps I originally extracted are? Output path = Where my .logs from the extraction are? CSV path = ???

Original path = Path to the original uassets/uexps you want to modify.
Output path = Path to where you want your modded files to be created.
CSV path = Path to a CSV file with your replacements.

Example CSV:

"Ryo","Nozomi"

In this example CSV, the tool will replace all occurences of "Ryo", with "Nozomi".

#2. How are you creating .paks from scratch? Some games allow me to just name a folder .pak but Shenmue 3 isn't like that.

I use UnrealPak with UE4.

 

[gladias9]

I was initially going to complain that I couldn't get it to work.. BUT I DID!
Thank you so much for this tool.

I've started work on re-writing many scenes of this game. I just want to clear up the inconsistencies with previous games and redundant information. Definitely rewrite a few characters. Maybe even take a few liberties in supporting certain fan theories for the story.