Carma Key Binder beta test 13, created in February-Mey 2015 by QTZ
http://qtz.toshiba-3.com/

This is free software. Use at you own risk!


It's tool for Carmageddon 1 / Splat Pack / demos and mods / Carmagedon 2 full / mods (C2 demo is not yet supported).
It also allow to import / export Carmageddon 2 KeyMap_?.txt files

With this tool you can bind keys that are not possible to bind from game, also all customizable functions are available to bind.
This allow to set the keys for left hand, arrows or whatever we want. Some keys are hard-coded in game, but we can set almost everything (I hope).

Current version is at very beta stage. There is no load error handling implemented. It need text format - decrypted text.txt file.

Run it as standalone, select path/s you want to use or use default locations, then just copy saved keymap_0.txt (1, 2, 3) into game folder. Same for import / export to / from C2.

You can copy this tool to Carmageddon 1 game folder, but you need to set proper path anyway.
DO NOT COPY IT TO C2 FOLDER! If you want to use included settings with C2, export them form CKB in C1 mode.

Note: It save Settings.ini file which remember first location from where this program was launched, so moving this tool doesn't change paths - you need to set them from Settings menu or directly in ini.
(For CKB settings search on system drive for \Carma Key Binder\Settings.ini file).

You can use included C1 files, but this is not obligated.
I have included two custom C1 configs (C, D) which are set to main keys only (it look like some less important functions are not working).

There is also optional, default UK keyboard.cok which set in game keyboard layout to UK QWERTY.

This is VB Windows application, so must be started from Windows.

However may be used with DOS Box installation (or any other, like for MAC [need EOL convertion]) of Carmageddon 1 / Splat Pack.

THIS TOOL DOESN'T PREVENT FROM SET ONE KEY TO MANY FUNCTIONS (yet), SO WE ARE RESPONSIBLE TO DO IT RIGHT WAY.

There is a information column which indicate reuse of keys, but for some function (set by default) this is not critical, like for those accessed with 'controls' or 'shifts' and in certain modes (like in cockpit view).
The numbers indicate how many times one key is mapped. However some keys are hard-coded like "," (<) and "." (>) for replay playing, so not included on that list.

Probably some (or most) of less used functions have wrong descriptions, most are not tested.

Note: To detect keypad key-pressing Num Lock must be set to 'on' first.


The story: I know from years there are keymap files which can be customized outside the game (I have done it in the past for C2), but since default C1 keyboard setting is brilliant for me, I always think changing that in C1 is pointless, till now.

On GOG forum there is information how to reassign "S" key which prevent of using WSAD combination as directions (or whatever).
http://www.gog.com/forum/carmageddon_series/map_the_s_key_for_reverse
So this is not true what Stainless say that we can't reassign 'S' key, it's not a bug but it's feature (to prevent of assign few keys to one function), which become annoying without proper setup.
https://carmageddon.zendesk.com/hc/en-us/articles/200942341-Carmageddon-Max-Pack-Known-Issues

There is also customized Carmageddon 2 keymap_0.txt file for laptop, which is just expanded usage of above information.
http://www.gog.com/forum/carmageddon_series/how_to_binding_keys_in_carmageddon_2
It using arrows instead of keypad (num-pad) keys, but also all directions for camera controls and key '2' are set to 'Shift'.

The laptop usage convince me to create this tool. There is much laptops without keypad, keyboards without numeric block, so it fill the gap. Of course it can be used with any keyboard.


This program access:
- KEYMAP_0.TXT (A config)
- KEYMAP_1.TXT (B config)
- KEYMAP_2.TXT (C config)
- KEYMAP_3.TXT (D config)

- DKEYMAP0.TXT (default for A)
- DKEYMAP1.TXT (default for B)
- DKEYMAP2.TXT (default for C)
- DKEYMAP3.TXT (default for D)

- KEYNAMES.TXT (key names taken from this file, displayed optionally)
- TEXT.TXT (some text taken from this file, displayed optionally)

For C2 if TEXT.TXT is missing it read:
- data.twt (some text taken from this file, displayed optionally)

The other file which is important for keyboard setting (not used by this tool) is:
- KEYBOARD.COK
This file is responsible for keyboard layout (this tool was only tested with UK version).
So if we have for example French Carmageddon, this file is in AZERTY standard, unfortunately game doesn't have setup for that file, so if it not match our keyboard layout we have keys switched. Splat Pack have few KEYBOARD.COK files (look in INT sub-folder) used by it setup (in GOG release setup is removed**, however they included KEYBOARD.COK files), unfortunately it took the file based on Carmageddon installation language in PATHS.TXT, so we still have no possibility to choice, there is not even information what that file does... The solution is to manually copy one of KEYBOARD.COK over existing (make backup first) and try. Also it's possible to set it using my Unofficial Carmageddon Patch. It is scheduled to be added to my other patches too, BTW.

So we don't need to type codes with switched letters or replacing the keyboard.
http://www.carmageddon.com/forum/topic/23784

**) (Actually setup is included, but we need to extract it from .gog file - copy .gog file to .iso, then extract)


When file from C2 is moved directly to C1 it looks completely messed up. For C2 few key functions are added in the middle of file, so those must be dropped. To do this correctly I have added import / export C2 files options which are available from 'File' menu.

In C2 there are same problems (also like F1 key, which is set by default, but can't be re-assigned when changed from game).
When you use C2 export function all missing keys are set to their C2 default. You can then set up all new Carmageddon 2 keys from game (except for 'Alt' function which is best to leave set to 'Alt' key). Or set them in CKB C2 mode.
By default for Carmageddon 2 import / export DATA_C2 sub-directory is used, but can be set directly to Carmageddon 2.
If you are using default path - to import file you need to copy it to DATA_C2 sub-folder of this tool (better is to set Carmageddon 2 DATA directory), exported file can be found in same folder (overwrite) and need to be copied to Carmageddon 2 DATA (only when path is not set). Then you can set other keys from game - if you want assign them to already used keys, you need to remap them (free them) first in this tool.

EOF->