
KRS BIN CONVERT PROGRAM
       by timetraveller
========================================

KRS Bin Convert (KRSBC) is a file converter and file viewer program for Kuju Rail Simulator game files. It allows simple double-click mouse access to all game files so they can be immediately inspected and unpacked, and even modifed (.bin files and others like them). .bin files are immediately converted and sent to the text editor of your choice. Make your change to the file, resave, and the file is converted back to .bin and replaced in-game after a backup is made. KRSBC detects when you close your editor, and checks for any changes you may have made. Editing .bin files are now like editing any text file. Click a .dav file and have the sound play in the onboard sound plugin or sound player of your choice. Click a .TgPcDx file and view it in an image viewer of your choice. Choose (or not) to convert sound and image files to a conversion folder whenever they are clicked.

Program has been developed and tested on Windows XP Professional, Service Pack 2.


WARNING
------------------------
This program is a game hacker program. In some cases, it will modify Rail Simulator game files. It has been tested extensively, however I am not responsible for damage incurred to your Rail Simulator install. Back up your game!


INSTALLING
------------------------
Unzip the downloaded file and click on the setup.exe to install KRSBC. Install may be done over top any pre-existing KRSBC installation. If newer versions come out, this is what to do.

>>> Important!
Be sure the file serz.exe (installed by the RS game to your \RailSimulator folder) has been copied into your Windows\system32 folder.


INITIAL START UP
------------------------
Click on the Desktop icon for initial startup of the program.

This program requires you to associate file extensions for certain file types pertaining to the Rail Simulator game. These file types are: .bin, .GeoPcDx, .dcsv, .XSec, .cost, .tgt, .TgPcDx, .dav. They must be associated or KRSBC will not function. A "Go" button exists on the mail panel to do this. Do this first.

Next, set up your file paths to your text editor (for editing .xml files), sound player (if you choose to use your own), and your .dds image viewer. Tick the radio button to use your own image viewer and sound player if you like.

Decide if you want KRSBC to convert each image (.TgPcDx) or sound (.dav) file you click. Converted files are always saved to the KRSBC "wav files" folder (sounds) or "dds files" folder (images). This folder is found in the KRSBC install folder. You can access it easily by clicking on the button on the main panel.

Close the main panel when you have accomplished all the above.


FILE BACKUP
------------------------
Every .xml-like .bin file modified through this program and saved back to the Rail Simulator game is backed up in the KRSBC "backups" folder, found in the install folder. After the first save, a version number is added to the file extension to show the version sequence.


GENERAL USE
------------------------
In Windows Explorer, double-click on any of the Rail Simulator file types.

>>> Editing .xml-like .bin files (.bin, .GeoPcDx, .dcsv, .XSec, .cost, .tgt)
.xml-like files will be unpacked and sent to the text editor you have chosen. The KRSBC program will remain on the Windows Taskbar monitoring progress. Make sure not to close this program if you want to be able to update the game file with any changes you have made to the .xml file.

>>> Saving changes to your edit
If you have made changes to the .xml-like .bin file, resave it using the "Save" option of your editor. Do not use "Save As". "Save" will save it in the same place. Now, simply close the text editor. KRSBC will detect that the text editor has closed, and check the file for modification. If modified, a popup window will ask you if you want the file converted back to the game. If so, KRSBC will convert it and replace the game file with your modified version, backing up the original.

>>> Sound files
Sound files (.dav) are played instantly either in the KRSBC plugin or the sound player of your choice. The sound .dav file will be converted to a standard .wav type file and saved in the "wav files" folder so it can be modified by you at a later time.

>>> Image files
Image files (.TgPcDx) are displayed instantly in the image viewer of your choice. The image .TgPcDx file will be converted to a standard .dds type file and saved in the "dds files" folder so it can be modified by you at a later time.


NOTES
------------------------
KRSBC does not convert sound(.wav) files or image (.dds) files back to the Rail Simulator .dav or .TgPcDx native format.


VIEWERS
------------------------
>>> .dds image files
The viewer I use is ddsview, found at http://www.amnoid.de/ddsview. Try it, I think you might like it. I also understand IrfanView will view .dds files. Plugins for .dds format are available for Paint Shop Pro and PhotoShop.

>>> .wav sound files
Virtually any MP3 player will work to hear .wav sound files. KRSBC will play .wav files for you if you so choose.






