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 the BNK Manager
- Double click: opens selected file in default editor
- Shift+Double click [in BNK Manager]: creates an edit task and displays in default editor.

.Contextual menus:

New ! You can now do a right click on any item in lists, to display common operations.

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. Also, please note the backup will disappear.

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 define in Settings which method to use when updating this file.
- You can also Discard checked task(s) to cancel corresponding changes.

The Open folder/file buttons respectively display the folder where files are stored during editing or 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: feature preserving file contents; though you'll have to ensure the MAP system is ok (see chapters 'd' and 'e' 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 definitively patch the MAP (preferred method):

Menu Tools > Disable File Size Control...
By doing this, you accept the Bnk1.map to be patched to enable any file replacement. You only need to do this once; original file will be saved as backup.

No account bans, nor online disconnects have been reported so far. But at this modding level, I can't give you any guarantee so be advised before using modified files.

e.To fix MAP system (alternate method):

In case you prefer to keep your original Bnk1.map, if you intend to replace a file by a bigger/smaller one (or change size of an existing), you can also update the control system, for this file to be accepted.

Select the file then Tools > MAP Details... (or hit Ctrl+M), a 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.

You'll notice not every file is supported by this method, as it's rather difficult to provide keys for doing this. As a consequence, this method is not maintained anymore and will disappear.

BNK Editor

The first tool which was able to fully pack/unpack BNK contents. Many thanks to Jeffrey Harris, who has really pushed TDU modding to a next level.
To activate BNK Editor, just copy the bnkfileeditor.exe into plugins folder. Using it is rather self-explanatory.

Since 1.5, TDU Modding Tools can do most of these tasks. So please note with future versions, BNK Editor won't be integrated anymore.

MAP Tool (advanced 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.

Notice: 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 don't show file names :(.

a.To generate your own key:

Provided 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... then 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 will contain consistent 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 purposes; 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.

Index