TES4 Mod Translator

An easy to use Oblivion plugins translator
(c) 2006 - Sir Dragon




I. WHAT IT IS ?
II. INSTALL
III. HOW DOES IT WORKS ?
IV. INTERFACE
V. TIPS
   How to change menu language
   Keep current modifications safe from database re-writing
VI. HISTORY
VII. CONTACT
VIII. THANKS
IX. LICENSE



I. INTRODUCTION
TES4 Mod Translator is foreign Oblivion mods (plugins) translator written in C#, using Visual Studio 2005 (c) Microsoft. You must have installed .Net 2.0 to run this tool. If .Net 2.0 is not on your PC, it can be downloaded from Microsoft website.
This tool is smomehow still in developpement. It doesn't do anything and TESC 2 is still necessary to perform some works. Remenber to save your work regulary.

II. INSTALL
Unzip archive where you want to. Necessary folder will be created during this process.
At this end, you must have something looking like :



III. HOW DOES IT WORK
First of all, you need to build a database before translating any plugins. In order to do so, run the tool (double-click Tes4ModTranslator.exe). If the menu language does not suit your needs take a look at TIPS to see how to change it. Then select Database -> Generate and take a look at the TV program since DB building take a long, long time. It took me 3 hours for me and my PC is not an old one (almost 1 year old... oh boy it's an old PC indeed) And it's very processor time consuming so do it during your sleep if you can.
CSV file will be created in the data folder (I mean the data folder just created, nothing to do with your Oblivion install).
IMPORTANT :
Before loading any translated mod, take one minute to save it with TESC 2. This is critical if scripts are present in plugins (I don't really know why and how but message boxes contents are save 2 times in plugins but I can't mimic the mechanism). And, from time to time, writing error can occur with contents number and I didn't find how to fix it.

IV. INTERFACE
Présentation
File Menu
  To open a plugin (fichier ESP), choose File -> Open...
  To save your work, choose File -> Save
  To save the plugin with another name, choose File -> Save as.... Take care of you will still work with the first plugin you've just opened.
  To close the plugin - NO SAVE ARE DONE IN THIS CASE -, choose File -> Close
  To exit the application, choose File -> Exit
Database Menu
  To build the DB from Oblivion.esm, choose Database -> Generate
  To add your work to your DB, choose Database -> Add to your DB
  To read from your previously saved work, choose Database -> Load...
  To save to some peculiar CSV file, choose Database -> Save as...
  To tag all items as translated, choose Database -> Tag all as "T"


V. TRUCS ET ASTUCES
   How to change menu language
To change the menu language, copy the Application-configuration-en.xml to, say german language, Application-configuration-de.xml. Edit this file with any editor. You will see everything looking like :
<Key Name=keyword Value="any value I wish to see">
So just modify the value field. You will have to copy this newly created XML file to Application-configuration.xml. Then quit and run the application. Change will be done.
   Keep current modifications safe from database re-writing
Plugin data are translated by doing item id comparison within CSV file. The tool look for a matching id in the data folder then in the extra folder. If you don't want to corrupt the plugin you are translating, empty the data and extra folder (move them then create new folders with the same name). This is cool when you have some unofficial plugin patch. Load the plugin, every item will show up an "X" in the first columns (X stands for no match found), do your work (a "T" mark will show up for each translated item), or tag all item as "T" and save to your DB. Then copy the saved dat folder contents to the newly empty created data folder and do the same for extra. If CSV file have the same name just concat them with the new one.

VI. HISTORIQUE
See CHANGELOG.txt file.

VII. CONTACT
sirdragon888 at hotmail dot com
My home page

VIII. THANKS
Bethesda for giving us Oblivion.
Gilles_k who create the hotdogizer (a TES3: MORROWIND plugin translation tool) from which I keep the same design.
Timeslip and his TESsnip who allow me to use some C# class
The many wiwilanders who help me doing the tool.

IX. LICENCE
This tool is given to you "as is". It and I are not responsible for your day-life tragedia, such as your cat who committing suicide in your micro-wave oven or your wife's mother that settles in your home. You can do anything you want with this tool just like improving it, but please release your work for the Oblivion community. You can ask me for the project code if you want to. Keep the credits.