Fate/stay night:Translate scripted files

Introduction

This program is make for manipulate scripted files of FSN and make easier the translation.

With it you can:

• Clean a .ks file from all marks and scripts;
• Clean a .ks file only from word-wrap marks;
• Clean a .ks file only from voice script;
• Clean a .ks file only from voice comment;
• Replace "double quote" by « French quotation mark »;
• Redo only word-wrap marks on a cleaned .ks file;
• Redo marks and scripts on a cleaned .ks file;

• Clean all .ks files of a directory from all marks and scripts;
• Redo marks and scripts on all files in a directory;
• Word-count all files in a directory.

This program was already use for translate the some days of the French version with success.

How to use

Installation

I wrote this program with .Net 3.5 so you need Windows (tested on XP, Vista and Seven) and the .Net Framework up-to-date on your PC. You can download it manually from Microsoft Official Website if you don't use Windows Update.

This tiny program don't need any installation to work, it's just automatically create a configuration file in your %USER%/AppData/CleanerFSN directory if it can (it's not required for work however).

Clean and Rescript .ks files for translate

The main purpose of this program is for make easy the translation of texts of FSN.

To do so, you have to clean the scripted .ks files of FSN. For that, extract an "original version" of the "scenario" directory of FSN (you can use the Mirror-moon's english version and extract it from patchX) from .xp3 files. To do that, you can use Insani's Extract tool. Or use the example archive at the end of this page.

I will name the extracted directory "Scripted VA" in my example and click on "Clean a directory". Select the directory "Scripted VA", click on OK, and create a new directory, in my example I name it "Cleaned VF". Now, you have a directory "Cleaned VF" cleaned from script, and you can translate it directly (but before that take a look at the Tips) and an original Scripted version that you will use later.

So, after the translation you have to rescript all translated files for, after that, reimport them in the game (with the Insani's Repack tool).

To do so, click on "Script a directory" and select the directory "Cleaned VF" as the translated directory, the directory "Scripted VA" as the original directory, and create a new directory, "Scripted VF" in my example.

With some file, you will have an error somewhat the file don't have the same number of lines... Even if it's the rights files ! Why ? Because the english version of mirrormoon have some trouble with white space in begin of line. Sometime, the white spaces aren't there even if it should be. That make the soft forget these lines.

So, you have a function "Add Blanck Space to a file" for make up this problem, and add white space to the line of text who don't have one. Use it on the translated files in the directory "Cleaned VF" who make error, and redo the function "Script a directory", now it should rescript the file with error, if not, send me the file, I will take a look.

After that, you have your new directory full of scripted translated files, ready to import in the game!

Specifics operations on .ks files

Firstly you have to open a .ks file, for it go in "File" menu and click on "Open".

Now you have several choices:

• You can clean only one .ks file from all marks and scripts (except some ones, used for Rescript function) for make it more readable.

For that, click on "Edit" -> "Clean a file from All".

• You can clean a .ks file from word-wrap marks only ([wrap text="..."]) and keep scripts and others of the file. It can be usefull if a file can't be rescripted for some reasons.

For that, click on "Edit" -> "Clean a file from Word-Wrap".

• You can clean a .ks file from [l][r] tags only and keep scripts and others of the file. It can be usefull if a file can't be rescripted for some reasons.

For that, click on "Edit" -> "Clean a file from LR".

• You can clean a .ks file from voice scripts only ("@say ...") for make an un-voiced version of your script.

For that, click on "Edit" -> "Clean a file from Voices".

• You can clean a .ks file from comment only ("// ...").

For that, click on "Edit" -> "Clean a file from Comment".

• You can add Word-Wrap to the text of a .ks file. It should be use after the "Clean a file from Word-Wrap" function, after you have translate the text. After that, you can import the file in game.

For that, click on "Edit" -> "Add word-wrap to a file".

• You can add [l][r] tags to the text of a .ks file. It should be use after the "Clean a file from LR" function, after you have translate the text. After that, you can import the file in game.

For that, click on "Edit" -> "Add LR to a file".

• You can replace the "english quotation mark" by the « french quotation mark ». It should be use on a cleaned file before any rescripting or word-wrapping. After that, you can use it like a standard cleaned file.

For that, click on "Edit" -> "Replace Double Quote by French Quotation Mark".

• You can add Script and Word-Wrap to the text of a .ks file. It should be use after the "Clean a file from All" function, after you have translate the text. After that, you can import the file in game.

For that, click on "Edit" -> "Add Word-Wrap and Script to a cleaned file".

• You also have a function for word-count all files in a directory (and its sub-directories). It will not count script or line without word (like "-----" or "...").

For that, click on "Directory" -> "Word-Count a Directory" and select the directory of your choice.

If you have any question, request or bug, please PM me on the baka-tsuki forum.

--Bejarid 22:22, 22 March 2009 (UTC)

Tips

In end of line, the [l] mark is to make a pause (until player press a button to have the next line) and the [r] mark is to make a new line.

This two is use together the most of time, but you can use only one of them, for exemple the [r] mark is usefull to make a better presentation for a quotation.

Change log

V1.X : Developpement releases.

V2.0 : Initial release with Clean & Rescript functions.
V2.1 : Add function for French quotation marks.
V2.2 : Resolve a bug on Drag & Drop.
V2.3 : Increase performance for display large text files, and for Rescript functions.
V2.4 : Resolve a bug on "Add LR" function (and Rescript functions) when the file don't finish by a transistion page (for example, the first file of day1).
V2.5 : Add function for word-count a directory.
V2.8 : On CodePlex.

Download links

Direct Download on CodePlex : Executable | Example | Source code