Extracts scripts from Tanuki Soft and Kaeru Soft visual novels, specifically .bcs
files.
Script extraction should work for every Tanuki Soft, Kaeru Soft, and Rune visual novel. The folder replacement described here to put the extracted csv scripts back in the games should work for all Tanuki Soft and Kaeru Soft visual novels, but it is not guaranteed to work for all Rune visual novels.
.bcs
files from the archives, generally they are in datascn.tac
, scenario.g2
, or scenario.g
. I recommend using GARBro for this, but other tools will work and might be necessary depending on how old the game is.bcsextractor.exe
using extract and point it to the .bcs
files.bcsextractor.exe extract bcs_files -o put_csvs_here
datascn.tac
) in the visual novel's main directory.datascn.tac
) as replacement.bcsextractor.exe
into the new folder created.To translate the text, all you need to do is replace the japanese text in the csvs with other text. The game should automatically pick them up and work without issue. Mostly you will replace text under the %text%
fields, but names and choices can also be translated.
Note that since this is a csv, you MUST wrap text that contains a comma in quotation marks like so:
10900 ,,,,,,,,,,,,,,,,,,,,"Text that has, a comma"
Be careful not to change a command or variable, the game might break if it can't find those.
bcsextractor.exe
also has a format command that adds word wrapping for ease of use. See bcsextractor.exe format -h
.
Q: GARBro extracts the .bcs
files as garbled strings instead of something like 04haruna.bcs
.
A: Due to how the .tac
extraction works, unless GARBro knows what the name is going to be before it extracts it, it can't determine the name. It keeps a file in GameData/tanuki.lst
in its installation directory that is a list of all the known Tanuki Soft/Kaeru Soft .bcs
filenames. If you extract _project.csv
, it should tell you all the .bcs
filenames for the scripts in that game. Add them to GARBro's GameData/tanuki.lst
and GARBro should recognize it after. I've added an expanded tanuki.lst
in this repo as well.
Q: All the emote sprites disappeared.
A: _emote.csv
is currently broken, just place the original _emote.bcs
in the datascn.tac
folder instead. There is nothing to translate in _emote.bcs
anyway. The extractor should refuse to extract emote.bcs due to this.
Q: The game doesn't work after replacing the scripts.
A: Make sure the folder has the exact same name as the scenario archive like datascn.tac
or scenario.g2
. If the game is a Rune visual novel, see the linked documentation as it's not guaranteed to work.