2.TDU Modding Tools : Main Tools

File Browser

This tool aims at replacing BNK Editor+BNK Tool, thanks to its BNK Manager.
It displays all your TDU file hierarchy (folders on the left, files on the upper-right, contents of BNK selected file on the lower-right).

Every menu item has a tooltip, giving more details. To display it, just point this item and wait a few seconds.

.Keyboard shortcuts:

Some functions are explained in details above.
- F5: actualizes the lists, like in your web browser
- Ctrl+Numpad 1: displays/hides BNK Manager
- Ctrl+Numpad 2: displays/hides Edit Tasks
- Ctrl+A: selects all items
- Ctrl+B: makes a quick backup of selected file(s) [in top-list]
- Ctrl+E: extracts selected or all files from BNK [in BNK Manager]
- Ctrl+M: displays MAP details from selected files [in top-list]
- Ctrl+N: restores a file from selected backup [in top-list]
- Ctrl+R: replaces selected file, maintaining BNK size [in BNK Manager]
- Ctrl+Shift+R: replaces selected file, modifying BNK size [in BNK Manager]
- Del: deletes selected file(s) [in top-list]

.Mouse shortcuts:

- Single click: if item is a BNK file, contents will be displayed in BNK Manager
- Double click: opens selected file in default editor
- Shift+Double click: creates an edit taske et displays in default editor [in BNK Manager]

a.To backup/restore files:

- File Browser is able to make a backup of every file appearing in the upper section. Click on Backup. A copy will be created, whose name ending by .BAK.
- Also, you can restore a previous backup by selecting it then clicking on Restore. File will retrieve its previous contents.

b.To edit a file with BNK Manager:

This new edit function allows you to easily modify packed files, manage current edit tasks and directly apply changes you've made.
Select a packed file in the bottom part (BNK Manager), then Edit. A new edit task will be created and file will be opened in default editor:

- Once editing is finished, you can choose to Apply. The BNK file will be automatically updated and saved according to checked task(s).
- You can also Discard checked task(s) to cancel corresponding changes.

The Open xxx buttons respectively display the working folder (where files are stored during editing) and open the selected file again with the default application.

c.To extract and replace files (manually):

BNK manager behaves almost the same way as Jeff's BNK Editor. So you should be very good at it already ;)
The only difference is you'll be able to specify the method when replacing files into a BNK:

Maintain size: same behavior as BNK Editor.
Modify size: new feature, preserving file contents; though you'll have to fix the MAP system (see chapter 'd' below).

Note1 : packed files which have just been replaced appear in different color (blue).
Note2 : BNK file is automatically saved after a replace operation.

d.To fix MAP system:

If you intend to replace a file by a bigger/smaller one (or change size of an existing), you'll have to update the control system, for this file to be accepted. Since current version, it is now possible to directly patch the MAP data (=Bnk1.map) from File Browser.

Select the file then Tools > MAP Details... (or hit Ctrl+M), a new dialog box will appear:

Window contents:

Size modification supported ? checked if you are allowed to change the file size
Actual file size: the current size
Expected size: the size checked by protection system. If it's different from current size, the file won't be loaded (TDU may also crash).

On the left hand side, these are MAP Details for a file whose size changing is not supported for the moment; on the right, MAP Details are for a supported file.
Supported file list depends on the map-key.xml you should keep updated (separate downloads will be available).

When size modification supported and sizes are different, you can click on Fix it ! button to correct you Bnk1.map file automatically.

MAP Tool

Module to manage TDU's file protection: each file in Bnk folder and subfolders will be accepted by the game, as long as its size corresponds to info stored in a particular file: Bnk1.map.
MAP Tool gives contents of that file and allows advanced users to change expected sizes. That could be useful when you have to replace a BNK or whatever by a significally lighter/heavier file.

Remark: Bnk1.map is a relatively unclear file. At the moment, this tool isn't able to change size control for every file in TDU folders; known files are given by a KEY (provided with TDU Modding Tools: map-key.xml). That's the reason why some lines in the table can't show file names :( Though, this KEY will be updated.

a.To generate your own key:

sProvided map-key.xml should be OK for most usages. Though for any reason, you might have to generate your own key according to contents of your Bnk folder.
Just load your Bnk1.map file, click on Get Key... and follow further instructions.
These steps are useful to discover new ids and support new files too.

b.Fixing:

It consists in automatically correcting Bnk1.map data to ensure actual file size and protection system contain similar values. There are 2 ways to 'fix' :

Fix entry button: data will be corrected for the selected file only
Fix all button: data will be corrected for all the supported files.

c.To change data for a particular file:

For test purpose; it's a more advanced function, that allows to manually change size for a particular file into the Bnk1.map. To do that, click on Change button.

Database Editor

This part of the software allows you to edit data stored in the per-language database files (DB_XX.bnk, where 'XX' corresponds to your game language).
Note: it's still impossible to read files stored in DB.BNK file as they are encrypted.

It can be used according 2 modes :

Read-only mode, by selecting a Category in the list. Contents will be displayed but you cannot edit them
Read/write mode, by checking Open File then choosing a database file name (e.g. ...\TDU_CarPhysicsData.us).

Moreover, database files can be also viewed/edited from FileBrowser (select the DB_xx.BNK file then either View or Edit the packed file of your choice).

To change a value in the database (Read/Write mode only):

Just select the entry you want to change, then click on Modify button (or double-click that entry).
In the Entry Editor, make your changes, finally click on OK button to update file.

Keep original file size checked ensures values will keep their original size; so the values you've entered may be truncated. e.g.: if current value is 'Audi TT', the new value can't exceed 7 characters.
We recommended to let that enabled for the moment, as TDU does not allow your database files to have a different size from original - we'll try to resolve this concern for future versions.

Index