La Pucelle Translation Project

La Pucelle Translation Project: Tools

Disclaimer:
These tools are provided AS IS and with NO WARRANTY. Use at YOUR OWN RISK.
These tools may not be used for commercial purposes.
La Pucelle English translation (C)2003 alamone.

Introduction:
Below are all the tools I developed for the purpose of the La Pucelle translation.
The sourcecode totals about 190KB (C and C++ code).
Compiled with GNU GCC/G++ under the MinGW system.

pucelle-tools.rar (2MB) - Translation tools.
Source code, precompiled binaries, graphics edits included.
Date: 2003/04/30

script-20030430.zip (186K) - Current script.
Plaintext/Shift-JIS. I recommend TextPad for editing.
Date: 2003/04/30

Please select an area of interest:

Getting Started

How to generate a patch

Explanation of files

Getting Started

These tools were developed on Windows XP in console mode (command prompt).

Make a directory on your computer, e.g. c:\pucelle\, as a working base dir.

Copy the contents of the La Pucelle CD-ROM to the base dir, including subdirs
(note: MUST be SLPS_20165 La Pucelle Limited Ed. JAPANESE version.
I have not yet supported SLPS_20167 La Pucelle Regular Ed. in pucelle-patch.cpp.
That is, more precisely, pucelle-patch is expecting PUCELLE.BAK to be SLPS_20165.)

Backup the La Pucelle CD-ROM to "pucelle.bin" and "pucelle.cue," to the base dir.

Execute the following commands at the base dir:


copy data.dat data.bak

copy sector.h sector.bak

copy slps_201.65 slps_201.bak

md data

md data-mod

md sound-mod

md start

ren pucelle.bin pucelle.bak

attrib *.bak +r

UNRAR the pucelle-tools.rar linked above into the base dir, OVERWRITING old files

Run the following commands at the base dir:


pucelle-datdump.exe

pucelle-startdump.exe

pucelle-dat2bmp.exe

pucelle-bannercombine.exe

unrar x translated-bmp.rar * data-mod/

pucelle-bannersplit.exe

Note: above assumes you have unrar installed. unrar should OVERWRITE existing files.
If you don't have unrar, winrar will work too. extract to data-mod/ dir.

You are now ready to generate a patch.

How to generate a patch

(0) restore.bat
restore files from backup. this step CANNOT be skipped.

(1) pucelle-insert.exe
script inserter.
creates data/talk2.dat
creates start/font2.tx2
modifies data.dat
generates dte-ref.dat

(2) copy dte-ref.dat dte-ref2.dat
do this step to keep a reference of the DTE used for next time

(3) pucelle-datdump.exe
extract data.dat to data/

(4) pucelle-bannersplit.exe
split the combined banners
step may be skipped if no new banners modified

(5) pucelle-bmp2dat.exe
convert translated graphics from data-mod/ into data/

(6) pucelle-startdump.exe
extract data/start.dat to start/

(7) [pucelle-charahack.exe]
OPTIONAL: hack the beginning stats of prier, alouette, and culotte

(8) pucelle-startgen.exe
generate data/start2.dat from start/*, importing font2.tx2

(9) pucelle-datgen.exe
generate data.dat from data/*, importing talk2.dat and start2.dat

(10) pucelle-patch.exe
generate the patch "pucelle.ala"

At the end of this process, you will have a "pucelle.ala" that is identical
to the "pucelle.ala" contained in ags-la_pucelle_disc1_1.0.zip.

Explanation of Files

(explanation of .cpp or .c files also applies to the precompiled .exe)

ala-format.txt	description of the .ala file format
alapatch.c	.ala commandline patcher
alapatchgui.exe	binary for the GUI .ala patcher by jiji
asciitbl.txt	ascii table
asciitbl2.txt	ascii to shift-jis table
ayashii.bmp	ayashii gamesubs bootlogo
byteorder.h	required header for alapatch.c
charahack.txt	info on chara hacking
compileall.bat	recompile all sourcecode
convfont.txt	shift-jis to font-index table
data/	where data.dat gets dumped/read from
data-mod/	location to store modified bmps
data.bak	backup of data.dat
data.dat	current working copy of data.dat
dte-ref.dat	currently generated DTE reference
dte-ref2.dat	last generated DTE reference
eccfmt.txt	info on cd-rom ECC
iso-info.txt	info on cd-rom ISO filesystem
make-steps.txt	how to generate a patch (also summarized above)
makebackup.bat	backup sourcecode to floppy disk
mf-audio*	mfaudio, ps2 audio conversion tool
patchend.txt	end of patch text
ps2boot.txt	ps2 bootsector info by loser
pucelle-asciitbl.c	ascii table generator
pucelle-auxtrans.txt	auxiliary translations for graphics
pucelle-backup.cue	cuefile to load the original ISO
pucelle-bannercombine.cpp	combine the split location banners
pucelle-bannersplit.cpp	split the combined location banners
pucelle-bmp2dat.cpp	convert BMPs into game-data
pucelle-charahack.cpp	hack the character stats (start/char.dat)
pucelle-dat2bmp.cpp	convert game-data into BMPs
pucelle-datdump.cpp	dump the data.dat resourcefile to data/
pucelle-datgen.cpp	generate the data.dat file, importing new data
pucelle-dump.cpp	dump the script to "pucelle-orig.txt"
pucelle-insert.cpp	generate the script from "pucelle.txt" into data/talk2.dat
pucelle-monstertext.c	generate the english monster text
pucelle-orig.txt	original japanese script
pucelle-patch.cpp	generate pucelle.bin and pucelle.ala
pucelle-sjistbl.c	generate the shift-jis table
pucelle-snddump.cpp	dump the music/sounds (see the sourcecode for info)
pucelle-startdump.cpp	dump data/start.dat resourcefile to start/
pucelle-startgen.cpp	generate data/start2.dat from start/*, importing new files
pucelle.bak	the original ISO
pucelle.bin	the generated ISO
pucelle.cue	cuefile for generated ISO
pucelle.txt	scriptfile
restore.bat	restore files from original files to start generation process over
sector.bak	backup of sector.h
sector.h	current generated sector.h
shiftjis.txt	shift-jis table
slps_201.65	currently generated slps_201.65 (executable code)
slps_201.bak	backup of slps_201.65
sound/	contains snd.pak
sound-mod/	directory to contain dumped music/sounds
start/	directory to contain start.dat dumped data
system/	directory that contains PS2 I/O and system code
system.cnf	PS2 boot-information
tmp.bmp	temporary place for bootlogo operations
translated-bmp.rar	translated BMPs to put into data-mod
usedsjis.txt	sjis codes actually used ingame

back to main...