Key def.dat

Change Populous default keys using programming or hex editor. The file was decoded on November 23rd 2013.

All the addresses are correct, but typos can and will exist. If there is a typo or wrong address let me know or correct it!

Introduction

Key def.dat is a file that you have to create by using the Populous key editor included in the game (Key def download). Once you save, the file is created and it is located in ./save/Key def.dat. Each key is stored in a hexadecimal address, the combination key is always 1 in front of it. So if 1 is pause 2 will be the combination key. The combination key is like shift + key but in the file format it reads key + shift.

Each key needs to be converted from hexadecimal to a integer. This can be done in programming by simply reading information from the address, else if you're using a hex editor (like HxD) you'll have to that by hand using a converter like Paulschou (use the values from CHAR), once you got the number it should range from 1-105, if it exceeds that, you're reading the wrong location or you got your math wrong. In #In Programming you will be told how to convert the values from keycode (the integer number you just got) to ASCII using programming methods. If you want to change them by hand without programming, all the key definitions are on this list keycode list for US QWERTY, remember that you have to convert those numbers back to hex from the Paulschou's link, or by programming.

This is not a complete decode of the file, however its most of the common key commands for Populous, if you find more, feel free to add them!

All numbers are stored in big-endian format!

Block Format
Data Type	Length	Position (DEC)	Description
INT32	4	0x0
15		0x4
15		0x19
15		0x34
15		0x49
15		0x64
15		0x79
15		0x94
15		0x109
15		0x124
15		0x139
15		0x154
15		0x169
15		0x184
15		0x199
15		0x214
15		0x229
15		0x244
15		0x259
15		0x274
15		0x289
15		0x304
15		0x319
15		0x334
15		0x349
15		0x364
15		0x379
15		0x394
15		0x409
15		0x424
15		0x439
15		0x454
15		0x469
15		0x484
15		0x499
15		0x514
15		0x529
15		0x544
15		0x559
15		0x574
15		0x589
15		0x604
15		0x619
15		0x634
15		0x649
15		0x664
15		0x679
Total	709 Bytes

Combination keys

The combination keys use a different keycode format. I don't know if there is a pattern to this or if the game has custom keycodes for these.

Not all of these are tested.

    No modifier key = 0
    Shift = 1
    Shift + CTRL (or app button) = 3
    CTRL = 4
    Shift + ALT = 5
    Ctrl + alt = 6
    Shift + ctrl + alt = 7
    Alt = 20

Available keys

Toggle view key

    23 = Key
    24 = modifier key

Encyclopaedia key

    38 = Key
    39 = modifier key

Set Map Marker 1 key

    35 = Key
    36 = modifier key

Set Map Marker 2 key

    68 = Key
    69 = modifier key

Set Map Marker 3 key

    83 = Key
    84 = modifier key

Set Map Marker 4 key

    88 = Key
    99 = modifier key

Goto Map Marker 1

    113 = Key
    114 = modifier key

Goto Map Marker 2

    128 = Key
    129 = modifier key

Goto Map Marker 3

    143 = Key
    144 = modifier key

Goto Map Marker 4

    158 = Key
    159 = modifier key

Zoom view in key

    173 = Key
    174 = modifier key

Zoom view out key

    188 = Key
    189 = modifier key

Quick Load key

    203 = Key
    204 = modifier key

Quick Save key

    218 = Key
    219 = modifier key

Zoom to shaman key

    233 = Key
    234 = modifier key

Chat message key

    248 = Key
    249 = modifier key

Command Tracking key

    263 = Key
    264 = modifier key
    * Had problems w/ this key

Release guarding people key

    278 = Key
    279 = modifier key

Toggle Level Stats key

    293 = Key
    294 = modifier key

Rotate building key

    308 = Key
    309 = modifier key

Assign people to group 1 key

    323 = Key
    324 = modifier key

Assign people to group 2 key

    338 = Key
    339 = modifier key

Assign people to group 3 key

    353 = Key
    354 = modifier key

Assign people to group 4 key

    368 = Key
    369 = modifier key

Assign people to group 5 key

    383 = Key
    384 = modifier key

Assign people to group 6 key

    398 = Key
    399 = modifier key

Select people in group 1 key

    413 = Key
    414 = modifier key

Select people in group 2 key

    428 = Key
    429 = modifier key

Select people in group 3 key

    443 = Key
    444 = modifier key

Select people in group 4 key

    458 = Key
    459 = modifier key

Select people in group 5 key

    473 = Key
    474 = modifier key

Select people in group 6 key

    488 = Key
    489 = modifier key

Zoom to people in group 1 key

    503 = Key
    504 = modifier key

Zoom to people in group 2 key

    518 = Key
    519 = modifier key

Zoom to people in group 3 key

    533 = Key
    534 = modifier key

Zoom to people in group 4 key

    548 = Key
    549 = modifier key

Zoom to people in group 5 key

    563 = Key
    564 = modifier key

Zoom to people in group 6 key

    578 = Key
    579 = modifier key

Zoom to Reincarnation site key

    593 = Key
    594 = modifier key

Toggle Local Selection key

    608 = Key
    609 = modifier key

Reselect last selection key

    623 = Key
    624 = modifier key

Reorient view key

    638 = Key
    639 = modifier key

Display last dialog key

    653 = Key
    654 = modifier key

Toggle auto deselect key

    668 = Key
    669 = modifier key

Call to arms key

    683 = Key
    684 = modifier key

Scatter people key

    698 = Key
    699 = modifier key

In Programming

VB .NET

This is code that will decode all the unknown keys seen above to ACSII, table

Use a code converter to translate to C#.

' Brandan Tyler Lasley
' Populous TB Key Mapper
' Read Populous TB key configuration keycodes, then convert it to ASCII
Imports System.Runtime.InteropServices
Imports System.IO

Module Module1
    Public Declare Function GetKeyboardLayout Lib "user32" (ByVal idThread As UInteger) As IntPtr

    <DllImport("User32.dll")> _
    Public Function GetKeyboardLayout(idThread As Integer) As IntPtr
    End Function

    <DllImport("user32.dll")> _
    Public Function MapVirtualKeyEx(uCode As Integer, uMapType As Integer, dwhkl As Integer) As Integer
    End Function

    <DllImport("user32.dll")> _
    Private Function GetKeyboardState(ByVal keyState() As Byte) As Boolean
    End Function

    <DllImport("user32.dll")> _
    Public Function ToAsciiEx(uVirtKey As Integer, uScanCode As Integer, lpKeyState As Byte, lpChar As Integer, uFlags As Integer, dwhkl As Integer) As Integer
    End Function

    Dim strings = New String() {"Pause", _
                                "Toggle View", _
                                "Encyclopaedia", _
                                "Set map marker 1", _
                                "Set map marker 2", _
                                "Set map marker 3", _
                                "Set map marker 4", _
                                "Goto map marker 1", _
                                "Goto map marker 2", _
                                "Goto map marker 3", _
                                "Goto map marker 4", _
                                "Zoom in", _
                                "Zoom out", _
                                "Quick load", _
                                "Quick save", _
                                "Goto shaman", _
                                "Chat/Message", _
                                "Command tracking", _
                                "Release Guarding", _
                                "Toggle level stats", _
                                "Rotate building", _
                                "Assign units to group 1", _
                                "Assign units to group 2", _
                                "Assign units to group 3", _
                                "Assign units to group 4", _
                                "Assign units to group 5", _
                                "Assign units to group 6", _
                                "Select units to group 1", _
                                "Select units to group 2", _
                                "Select units to group 3", _
                                "Select units to group 4", _
                                "Select units to group 5", _
                                "Select units to group 6", _
                                "Goto units to group 1", _
                                "Goto units to group 2", _
                                "Goto units to group 3", _
                                "Goto units to group 4", _
                                "Goto units to group 5", _
                                "Goto units to group 6", _
                                "Goto reincarnation site", _
                                "Toggle local selection", _
                                "Reselect last selection", _
                                "Reorient view", _
                                "Display last dialog", _
                                "Toggle auto deselect", _
                                "Call to arms", _
                                "Scatter people"}

    Dim keys = New Integer() {8, 23, 38, 53, 68, 83, 98, 113, 128, 143, _
                          158, 173, 188, 203, 218, 233, 248, 263, 278, _
                          293, 308, 323, 338, 353, 368, 383, 398, 413, _
                          428, 443, 458, 473, 488, 503, 518, 533, 548, _
                          563, 578, 593, 608, 623, 638, 653, 668, 683, _
                          698}

    Dim populousin As String = My.Computer.Registry.GetValue("HKEY_LOCAL_MACHINE\SOFTWARE\Bullfrog Productions Ltd\Populous: The Beginning", "InstallPath", "")

    Sub Main()

        Dim i = 0
        For Each Strs In strings

            Dim modifier = Reader(keys(i) + 1).ToString
            On Error Resume Next
            If modifier = 0 Then
                modifier = "NONE"
            ElseIf modifier = 2 Then
                modifier = "CTRL"
            ElseIf modifier = 3 Then
                modifier = "SHIFT + CTRL"
            ElseIf modifier = 5 Then
                modifier = "SHIFT + ALT"
            ElseIf modifier = 6 Then
                modifier = "CTRL + ALT"
            ElseIf modifier = 7 Then
                modifier = "SHIFT + CTRL + ALT"
            ElseIf modifier = 3 Then
                modifier = "APP"
            ElseIf modifier = 20 Then
                modifier = "ALT"
            ElseIf modifier = 1 Then
                modifier = "SHIFT"
            Else
                modifier = "NONE"
            End If
            Console.WriteLine(Strs & " = " & modifier & " + " & (scan2ascii(Reader(keys(i)))).ToString & vbNewLine)
            i = i + 1
        Next

        Console.ReadLine()
    End Sub

    Public Function scan2ascii(ByVal scancode)
        Dim hKL As IntPtr = GetKeyboardLayout(0)

        Dim State = New Byte(255) {}

        If GetKeyboardState(State) = False Then
            Return 0
        End If

        Return MapVirtualKeyEx(scancode, 1, hKL)
    End Function

    Function Reader(ByVal position As Integer)
        Dim Keysconfig As Boolean = My.Computer.FileSystem.FileExists(populousin & "\SAVE\key_def.dat")

        If Keysconfig = False Then
            Console.Write("Error: Populous keys configuration file could not be loaded, download it off the wiki and place it into ./saves/ file of pop.")
            Console.ReadLine()
            End
        End If

        Dim breader As New BinaryReader(New FileStream(populousin & "\SAVE\key_def.dat", FileMode.Open))
        breader.BaseStream.Position = position
        Dim output = breader.Read
        breader.Close()
        Return output
    End Function

End Module

C++

This is code that will decode all the unknown keys seen above to ACSII, table

This code does not automatically get PopTB's filepath.

// Brandan Tyler Lasley
// Populous TB Key Mapper
// Read Populous TB key configuration keycodes, then convert it to ASCII

#include <iostream>
#include <fstream>
#include <string>
#include <Windows.h>
using namespace std;

int scantoascii(int scancode);
int bReader(int position);
int bWriter(int value, int position);

string strings[50] =  {"Pause", 
			"Toggle View", 
			"Encyclopaedia", 
			"Set map marker 1", 
			"Set map marker 2", 
			"Set map marker 3", 
			"Set map marker 4", 
			"Goto map marker 1", 
			"Goto map marker 2", 
			"Goto map marker 3", 
			"Goto map marker 4", 
			"Zoom in", 
			"Zoom out", 
			"Quick load", 
			"Quick save", 
			"Goto shaman", 
			"Chat/Message", 
			"Command tracking", 
			"Release Guarding", 
			"Toggle level stats", 
			"Rotate building", 
			"Assign units to group 1", 
			"Assign units to group 2", 
			"Assign units to group 3", 
			"Assign units to group 4", 
			"Assign units to group 5", 
			"Assign units to group 6", 
			"Select units to group 1", 
			"Select units to group 2", 
			"Select units to group 3", 
			"Select units to group 4", 
			"Select units to group 5", 
			"Select units to group 6", 
			"Goto units to group 1", 
			"Goto units to group 2", 
			"Goto units to group 3", 
			"Goto units to group 4", 
			"Goto units to group 5", 
			"Goto units to group 6", 
			"Goto reincarnation site", 
			"Toggle local selection", 
			"Reselect last selection", 
			"Reorient view", 
			"Display last dialog", 
			"Toggle auto deselect", 
			"Call to arms", 
			"Scatter people"};


    int keys[50] = {8, 23, 38, 53, 68, 83, 98, 113, 128, 143, 
                   158, 173, 188, 203, 218, 233, 248, 263, 278, 
                   293, 308, 323, 338, 353, 368, 383, 398, 413, 
                   428, 443, 458, 473, 488, 503, 518, 533, 548, 
                   563, 578, 593, 608, 623, 638, 653, 668, 683, 
                   698};

int main() { 

	for (int i = 0; i < sizeof strings/sizeof(string) - 3; i++) {
	int modifiercode = bReader(keys[i] + 1);
	string modifier;

	switch (modifiercode) {
		case 0:
			modifier = "None";
			break;
		case 1:
			modifier = "Shift";
			break;
		case 2:
			modifier = "CTRL";
			break;
		case 3:
			modifier = "SHIFT + CTRL";
			break;
		case 5:
			modifier = "SHIFT + ALT";
			break;
		case 6:
			modifier = "CTRL + ALT";
			break;
		case 7:
			modifier = "SHIFT + CTRL + ALT";
			break;
		case 20:
			modifier = "ALT";
			break;
		default:
		modifier = "Unknown";
	}

	 cout << strings[i] << " = " << modifier << " + " << scantoascii(bReader(keys[i])) << endl;
	}


	getchar();
	getchar();
    return 0; 
}

int scantoascii(int scancode) {
	static HKL layout=GetKeyboardLayout(0);
    static byte State[256];

	 if (GetKeyboardState(State)==FALSE) {
      return 0;
	 }
   UINT vk=MapVirtualKeyEx(scancode,1,layout);
   return vk;
}

int bReader(int position) {
	unsigned char x;
	int i = 0;
	std::ifstream input("C:\\Program Files (x86)\\Bullfrog\\Populous\\SAVE\\key_def.dat", std::ios::binary);
	input >> std::noskipws;
	while (input >> x) {
		if (i == position) {
			return x;
		}
		i++;
	}
	return 0;
}