GXT

From Grand Theft Wiki
Jump to navigation Jump to search

A GTA Text (GXT) file contains almost all texts that are displayed on the screen of Grand Theft Auto 2 and above. The location of those files may differ between the various game versions, but they are usually located in the \text\ folder inside the games installation directory. Except for GTA 2 There is one GXT file for each language, but the number of gxt files does not define the number of supported languages by the game.

File format

GTA 2

GTA 2 begins with a header followed by a TKEY block followed by a TDAT block. Within the TKEY block is an array of TKEY entries containing the offset to and the name of the TDAT entry. A TDAT entry contains the text to be displayed in the game.

Header
Offset Type Description
0x00 char[4]
  • GBLE: English
  • GBLF: French
  • GBLG: German
  • GBLI: Italian
  • GBLS: Spanish
  • GBLJ: Japanese
0x04 word File version, always 100
Block 1 (TKEY)
0x06 char[4] TKEY
0x0A dword Size of TKEY block
0x0E TKEY[n] Array of TKEY entries, where n is the number of entries. All entries are sorted in alphabetical order.
TKEY (0xC bytes):
Offset Type Description
0x00 dword TDAT entry offset. The value is relative to the location of the first entry of the array, which is, in absolute term, size of TKEY block + 22.
0x04 char[8] TDAT entry name

The absolute location of the TDAT block is the size of TKEY block + 14.

Block 2 (TDAT)
Offset Type Description
0x00 char[4] TDAT
0x04 dword Size of TDAT block
0x08 TDAT[n] Array of TDAT entries, where n is the number of entries. Entries are not sorted in alphabetical order but their order comes from the order of their entry in the GXT source file.
TDAT (m * 2 bytes):
Offset Type Description
0x00 wchar_t[m] An array of wide characters (2 bytes per character) to be displayed in the game, where m is the number of characters. The array is terminated by a null character (0x0000). The location of the entry in absolute term is TDAT entry offset + size of TKEY block + 22.

Characters beginning with 0x21 denote gang dialogue:

  • 0x216B: Krishna
  • 0x216C: Loony
  • 0x216D: Russian
  • 0x216E: Neutral
  • 0x2172: Redneck
  • 0x2173: Scientist
  • 0x2179: Yakuza
  • 0x217A: Zaibatsu

GTA III

Grand Theft Auto III is nearly identical to GTA 2 but without the header. It begins with a TKEY block followed by a TDAT block. Within the TKEY block is an array of TKEY entries containing the offset to and the name of the TDAT entry. A TDAT entry contains the text to be displayed in the game. The Xbox version of GTA Vice City uses this format also.

Block 1 (TKEY)
Offset Type Description
0x00 char[4] TKEY
0x04 dword Size of TKEY block
0x08 TKEY[n] Array of TKEY entries, where n is the number of entries. All entries are sorted in alphabetical order.
TKEY (0xC bytes):
Offset Type Description
0x00 dword TDAT entry offset. The value is relative to the location of the first entry of the array, which is, in absolute term, size of TKEY block + 16.
0x04 char[8] TDAT entry name

The absolute location of the TDAT block is the size of TKEY block + 8.

Block 2 (TDAT)
Offset Type Description
0x00 char[4] TDAT
0x04 dword Size of TDAT block
0x08 TDAT[n] Array of TDAT entries, where n is the number of entries. Entries are not sorted in alphabetical order but their order comes from the order of their entry in the GXT source file.
TDAT (m * 2 bytes):
Offset Type Description
0x00 wchar_t[m] An array of wide characters (2 bytes per character) to be displayed in the game, where m is the number of characters. The array is terminated by a null character (0x0000). The characters are based on the character table in the fonts.txd file, which mostly follows ASCII. The location of the entry in absolute term is TDAT entry offset + size of TKEY block + 16.

GTA Vice City, GTA Liberty City Stories, and GTA Vice City Stories

Grand Theft Auto: Vice City, Grand Theft Auto: Liberty City Stories, and Grand Theft Auto: Vice City Stories begin with a TABL block, which was first introduced in GTA Vice City, followed by an array of TKEY blocks. Within each TKEY block is an array of TKEY entries containing the offset to and the name of the TDAT entry. A TDAT entry contains the text to be displayed in the game. The Xbox version of GTA Vice City uses GTA III's format instead.

Block 1 (TABL)
Offset Type Description
0x00 char[4] TABL
0x04 dword Size of TABL block
0x08 TABL[n] Array of TABL entries, where n is the number of entries. All entries are sorted in alphabetical order except the first one, MAIN.
TABL (0xC bytes):
Offset Type Description
0x00 char[8] TKEY entry name
0x04 dword TKEY entry offset. The value is absolute.

The absolute location of the TKEY block is simply the TKEY entry offset. The TKEY block format is slightly different for the first block named MAIN. Hover over the dotted lines for information specific to that block. All other blocks follow the format shown below.

Block 2 (TKEY)
Offset Type Description
0x00 char[8] TKEY entry name
0x08 char[4] TKEY
0x0C dword Size of TKEY block
0x10 TKEY[n] Array of TKEY entries, where n is the number of entries. All entries are sorted in alphabetical order.
TKEY (0xC bytes):
Offset Type Description
0x00 dword TDAT entry offset. The value is relative to the location of the first entry of the array, which is, in absolute term, TKEY entry offset + size of TKEY block + 16.
0x04 char[8] TDAT entry name

The absolute location of the TDAT block is the TKEY entry offset + size of TKEY block + 16.

Block 3 (TDAT)
Offset Type Description
0x00 char[4] TDAT
0x04 dword Size of TDAT block
0x08 TDAT[n] Array of TDAT entries, where n is the number of entries. Entries are not sorted in alphabetical order but their order comes from the order of their entry in the GXT source file.
TDAT (m bytes):
Offset Type Description
0x00 wchar_t[m] An array of wide characters (2 bytes per character) to be displayed in the game, where m is the number of characters. The array is terminated by a null character (0x0000). The characters are based on the character table in the fonts.txd file, which mostly follows ASCII. The location of the entry in absolute term is TDAT entry offset + size of TKEY block + 16.

GTA San Andreas / GTA IV Format

Each GXT file contains certain tables with entries. And each entry has a unique CRC identifier and a normal text.

Header

The header contains information about the GXT version.

INT32   - 4b   - Version (0x080004 for ASCII, 0x100004 for UTF-16)

Table Block

The Table Block contains data about the subtables and their offsets.

CHAR[4] - 4b   - TABL
INT32   - 4b   - Blocksize

//Array of [Blocksize / 12 Entries]
CHAR[8] - 8b   - Subtablename
INT32   - 4b   - Offset

The Offset of the subtable points to an 8-byte Char Array with the subtable's name, followed by TKEY. For the MAIN Table this points directly to TKEY!

GTA San Andreas has a limit of max 200 tables to be stored per GXT file.

TKEY and TDAT

TKEY

The TKEY Block of an subtable contains the CRC32-values of the entrytitles. The game calculates the CRC32-value out of a given string and checks if they exist in the GXT.

CHAR[4] - 4b   - TKEY
INT32   - 4b   - Blocksize

//Array of [Blocksize / 8]
INT32   - 4b   - Entryoffset
INT32   - 4b   - CRC32 (Entryname)

The TKEY block is directly followed by the TDAT Block which contains the contents of the entries. The Entryoffset is relative to the TDAT + 8 offset.

TDAT
CHAR[4] - 4b   - TDAT
INT32   - 4b   - Blocksize

From here the entryoffset of each entry points to the content. The content can have different sizes. However it always ends in '\0'! For Example "Hello!" needs to be transformed to "Hello!\0" here and this gives a size of 6 bytes (To tell it in a short form content is a null-terminated string). If this is the 1st content in TDAT the next got an offset of 0x06!

Encodings
GTA SA          : Windows-1252 always.
GTA IV(8 bits)  : Custom Encoding
GTA IV(16 bits) : Well, its a fake 16 bits encoding, all you need to take care about first 8 bits(1 byte). 
                  Eg. A3F4 C2DD E922, read only A3, C2, E9.


Sorting

The sorting method for TABL, TKEY, TDAT is as follow:

Section Sorting method
TABL Sorted in alphabetical order
TKEY GTA SA: Sorted from the lowest crc32 to the highest crc32,

GTA IV: Unknown. Perhaps randomized order.

TDAT Not sorted. The data is stored from the first line to the last line in the GXT source file

Character maps

These character maps display all possible characters that can be used in the GXT file. Each character is represented by a hexadecimal value, which can be constructed by adding the value in the leftmost column to the value in the topmost row, e.g. a capital letter A is represented by 0x41 in hex.

GTA III

Font Style 0 (Bank)

00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F
20   ! # $ % & ' ( ) * + , - . /
30 0 1 2 3 4 5 6 7 8 9 : ; = ?
40 A B C D E F G H I J K L M N O
50 P Q R S T U V W X Y Z [ \ ] ^ °
60 ` a b c d e f g h i j k l m n o
70 p q r s t u v w x y z     ~  
80 À Á Â Ä Æ Ç È É Ê Ë Ì Í Î Ï Ò Ó
90 Ô Ö Ù Ú Û Ü ß à á â ä æ ç è é ê
A0 ë ì í î ï ò ó ô ö ù ú û ü Ñ ñ ¿
B0 ¡ '

Font Style 1 (Pager)

00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F
20   ! " # $ % & ' ( ) -   , - .  
30 0 1 2 3 4 5 6 7 8 9 :         ?
40   A B C D E F G H I J K L M N O
50 P Q R S T U V W X Y Z          
60   a b c d e f g h i j k l m n o
70 p q r s t u v w x y z       ~  
80 À Á Â Ä Æ Ç È É Ê Ë Ì Í Î Ï Ò Ó
90 Ô Ö Ù Ú Û Ü ß à á â ä æ ç è é ê
A0 ë ì í î ï ò ó ô ö ù ú û ü Ñ ñ ¿
B0 ¡

Font Style 2 (Heading)

00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F
20   ! ® $ % & ' ( )   + , - .
30 0 1 2 3 4 5 6 7 8 9 : ?
40 a b c d e f g h i j k l m n o
50 p q r s t u v w x y z   \   °
60 © a b c d e f g h i j k l m n o
70 p q r s t u v w x y z     ~  
80 à á â ä æ ç è é ê ë ì í î ï ò ó
90 ô ö ù ú û ü ß à á â ä æ ç è é ê
A0 ë ì í î ï ò ó ô ö ù ú û ü ñ ñ ¿
B0 ¡

  • Characters in italic are the pager font.
  • Characters in bold use Pricedown font or have a dirty look.
  • Characters in both bold and italic use an italicized Pricedown font.
  • Hover your mouse over the dotted line for characters that cannot be displayed in the browser.

GTA Vice City

Font Style 0 (Bank)

00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F
20   !     $ % & ' [ ]   + , - .  
30 0 1 2 3 4 5 6 7 8 9 :         ?
40   A B C D E F G H I J K L M N O
50 P Q R S T U V W X Y Z   \   ¡ \
60   a b c d e f g h i j k l m n o
70 p q r s t u v w x y z       ~  
80 À Á Â Ä Æ Ç È É Ê Ë Ì Í Î Ï Ò Ó
90 Ô Ö Ù Ú Û Ü ß à á â ä æ ç è é ê
A0 ë ì í î ï ò ó ô ö ù ú û ü Ñ ñ ¿
B0 i

Font Style 1 (Standard)

00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F
20   ! " # $ % & ' ( ) * + , - . /
30 0 1 2 3 4 5 6 7 8 9 : ;   =   ?
40 A B C D E F G H I J K L M N O
50 P Q R S T U V W X Y Z [ \ ] ¡ °
60 ` a b c d e f g h i j k l m n o
70 p q r s t u v w x y z   | $ ~ )
80 À Á Â Ä Æ Ç È É Ê Ë Ì Í Î Ï Ò Ó
90 Ô Ö Ù Ú Û Ü ß à á â ä æ ç è é ê
A0 ë ì í î ï ò ó ô ö ù ú û ü Ñ ñ ¿
B0 0 1 2 3 4 5 6 7 8 9 : a

Font Style 2 (Heading)

00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F
20   ! " # $ % & ' ( ) * + , - . /
30 0 1 2 3 4 5 6 7 8 9 : ;   =   ?
40 a b c d e f g h i j k l m n o
50 p q r s t u v w x y z [ \ ] ¡ °
60 ` a b c d e f g h i j k l m n o
70 p q r s t u v w x y z   | $ ~ )
80 à á â ä æ ç è é ê ë ì í î ï ò ó
90 ô ö ù ú û ü ß à á â ä æ ç è é ê
A0 ë ì í î ï ò ó ô ö ù ú û ü ñ ñ ¿
B0 0 1 2 3 4 5 6 7 8 9 : a b c d e
C0 f g h i j k l m n o p q r s t u
D0 v w x y z à á â ä æ ç è é ê ë ì
E0 í î ï ò ó ô ö ù ú û ü ß ñ ¿ ' .

  • Characters in italic use Rage Italic font.
  • Characters in bold use Pricedown font or have a dirty look.
  • Hover your mouse over the dotted line for characters that cannot be displayed in the browser.

Tokens

A token is a character or string surrounded by ~ and is used for displaying colors, symbols, dynamic text, and button controls in text. Tokens with visible effects are listed in tables below. Note that using ~ by itself will crash the game when the game attempts to display it.

Symbols and colors

Token GTA III GTA Vice City GTA San Andreas GTA Liberty City Stories
~1~ number within a text
~A~ - - L3 icon (PS2) / LStick icon (XBOX) -
~B~ - bold and unbold text; text must be enclosed by two of these tokens -
~K~ - - L1 icon (PS2) / LT icon (XBOX) -
~Y~ - - yellow text
~a~ text within a text
~b~ blue text blue text blue text blue text
~c~ - - R3 icon (PS2) / RStick icon (XBOX) -
~d~ - - ▼-icon -
~g~ green text hot pink text green text green text
~h~ white text highlight white text
~j~ - - R1 icon (PS2) / RT icon (XBOX) -
~k~ key (followed by buttons)
~l~ black text forces text to default color and ignores set colors black text
~n~ - - newline -
~m~ - - L2 icon (PS2) / WHITE icon (XBOX) -
~o~ - pink text Circle icon (PS2) / B icon (XBOX) pink text
~p~ purple text purple text purple text
~q~ - plum pink text Square icon (PS2) / X icon (XBOX) plum pink text
~r~ red text hot pink text red text red text
~s~ - - reset color to standard -
~t~ - green text Triangle icon (PS2) / Y icon (XBOX) green text
~u~ - - ▲-icon -
~v~ - - R2 icon (PS2) / BLACK icon (XBOX) -
~w~ gray text white text white text
~x~ - light blue text Cross icon (PS2) / A icon (XBOX) light blue text
~y~ yellow text yellow text yellow text yellow text
~z~ - - subtitle (doesn't shown when the Subtitles option is off) -
~<~ - - ◄-icon -
~>~ - - ►-icon -
~f~ - Text flashing -

In GTA III's original GXT files for the PC version, the token l is unused. The token W appears erroneously in GXT key AS3_A in all language files except the Italian one. In GTA Vice City's original GXT files for the PC version, the tokens B and l are unused. t and x are unused in the English language file but appear to be used erroneously in other language files. The token c appears erroneously in GXT key FIN_B5; it could have represented the cyan color to match the color of the blip the text represents.[1] The token also appears in GXT key RCH1_3 in all language files except the English one.

Buttons

You can use opcode 00E1 to check if these keys are being pressed.

Foot Controls

Key Game Entry
Fire GTA III GTA Vice City GTA San Andreas ~PED_FIREWEAPON~
Next Weapon / Target GTA III GTA Vice City GTA San Andreas ~PED_CYCLE_WEAPON_RIGHT~
Previous Weapon / Target GTA III GTA Vice City GTA San Andreas ~PED_CYCLE_WEAPON_LEFT~
Group Ctrl Forward GTA San Andreas ~GROUP_CONTROL_FWD~
Group Ctrl Back GTA San Andreas ~GROUP_CONTROL_BWD~
Conversation - No GTA San Andreas ~CONVERSATION_NO~
Conversation - Yes GTA San Andreas ~CONVERSATION_YES~
Forward GTA III GTA Vice City GTA San Andreas ~GO_FORWARD~
Backwards GTA III GTA Vice City GTA San Andreas ~GO_BACK~
Left GTA III GTA Vice City GTA San Andreas ~GO_LEFT~
Right GTA III GTA Vice City GTA San Andreas ~GO_RIGHT~
Zoom In GTA III GTA Vice City GTA San Andreas ~PED_SNIPER_ZOOM_IN~
Zoom Out GTA III GTA Vice City GTA San Andreas ~PED_SNIPER_ZOOM_OUT~
Enter+Exit GTA III GTA Vice City GTA San Andreas ~VEHICLE_ENTER_EXIT~
Change Camera GTA III GTA Vice City GTA San Andreas ~CAMERA_CHANGE_VIEW_ALL_SITUATIONS~
Jump GTA III GTA Vice City GTA San Andreas ~PED_JUMPING~
Sprint GTA III GTA Vice City GTA San Andreas ~PED_SPRINT~
Target / Aim Weapon GTA III GTA Vice City GTA San Andreas ~PED_LOCK_TARGET~
Crouch GTA Vice City GTA San Andreas ~PED_DUCK~
Action GTA Vice City GTA San Andreas ~PED_ANSWER_PHONE~
Walk GTA San Andreas ~SNEAK_ABOUT~
Look Behind GTA III GTA Vice City GTA San Andreas ~PED_LOOKBEHIND~
Look Left GTA III GTA Vice Citya ~PED_1RST_PERSON_LOOK_LEFT~
Look Right GTA III GTA Vice Citya ~PED_1RST_PERSON_LOOK_RIGHT~
Look Up GTA III GTA Vice Citya ~PED_1RST_PERSON_LOOK_UP~
Look Down GTA III GTA Vice Citya ~PED_1RST_PERSON_LOOK_DOWN~
Next Target GTA III GTA Vice Citya ~PED_CYCLE_TARGET_LEFT~
Previous Target GTA III GTA Vice Citya ~PED_CYCLE_TARGET_RIGHT~
Center Camera GTA III GTA Vice Citya ~PED_CENTER_CAMERA_BEHIND_PLAYER~

Vehicle Controls

Key Game Entry
Fire GTA III GTA Vice City GTA San Andreas ~VEHICLE_FIREWEAPON~
Secondary Fire GTA San Andreas ~VEHICLE_FIREWEAPON_ALT~
Accelerate GTA III GTA Vice City GTA San Andreas ~VEHICLE_ACCELERATE~
Brake / Reverse GTA III GTA Vice City GTA San Andreas ~VEHICLE_BRAKE~
Left GTA III GTA Vice City GTA San Andreas ~VEHICLE_STEERLEFT~
Right GTA III GTA Vice City GTA San Andreas ~VEHICLE_STEERRIGHT~
Steer Forward / Down GTA III GTA Vice City GTA San Andreas ~VEHICLE_STEERDOWN~
Steer Back / Up GTA III GTA Vice City GTA San Andreas ~VEHICLE_STEERUP~
Enter+Exit GTA III GTA Vice City GTA San Andreas ~VEHICLE_ENTER_EXIT~
Trip Skip GTA San Andreas ~CONVERSATION_YES~
Change Radio Station GTA III GTA Vice City ~VEHICLE_CHANGE_RADIO_STATION~
Next Radio Station GTA San Andreas ~VEHICLE_RADIO_STATION_UP~
Previous Radio Station GTA San Andreas ~VEHICLE_RADIO_STATION_DOWN~
User Track Skip GTA San Andreas none
Horn GTA III GTA Vice City GTA San Andreas ~VEHICLE_HORN~
Sub-mission GTA III GTA Vice City GTA San Andreas ~TOGGLE_SUBMISSIONS~
Change Camera GTA III GTA Vice City GTA San Andreas ~CAMERA_CHANGE_VIEW_ALL_SITUATIONS~
Handbrake GTA III GTA Vice City GTA San Andreas ~VEHICLE_HANDBRAKE~
Mouse Look GTA San Andreas ~VEHICLE_MOUSELOOK~
Look Left GTA III GTA Vice City GTA San Andreas ~VEHICLE_LOOKLEFT~
Look Right GTA III GTA Vice City GTA San Andreas ~VEHICLE_LOOKRIGHT~
Turret Left / Special Ctrl Left GTA III GTA Vice City GTA San Andreas ~VEHICLE_TURRETLEFT~
Turret Right / Special Ctrl Right GTA III GTA Vice City GTA San Andreas ~VEHICLE_TURRETRIGHT~
Turret Up / Special Ctrl Up GTA III GTA Vice City GTA San Andreas ~VEHICLE_TURRETUP~
Turret Down / Special Ctrl Down GTA III GTA Vice City GTA San Andreas ~VEHICLE_TURRETDOWN~
Look Behind GTA III GTA Vice City GTA San Andreasb ~VEHICLE_LOOKBEHIND~
a. Classic controls key only
b. Hardcoded key in III and VC, unavailable in SA

Unused

Here are some keypress codes only used during development stage. They were removed or replaced later but probably they are still working. Maybe this is useful for further research. Some are only used in PS2 Version.

  • ~TAKE_SCREEN_SHOT~
  • ~SWITCH_DEBUG_CAM_ON~
  • ~TOGGLE_DPAD~
  • ~NETWORK_TALK~

Tools

GTA 2 GTA2 GXT Editor v2.0 - by Delfi
GTA III GTA Vice City GTA San Andreas GTA Liberty City Stories GTA Vice City Stories Grand Theft Auto GXT Editor v1.3 - by Zverik, retrieved from archive.org
GTA III GTA Vice City GTA San Andreas GTA Liberty City Stories GTA Vice City Stories GTA IV SAGE v0.9.7 - by AleX AciD
GTA III GTA Vice City GTA Liberty City Stories GTA Vice City Stories GTA Texter v2.0b3 - by feroCT5
GTA III GXT Editor 1.3 - by Jevon
GTA Vice City GTA Liberty City Stories GTA Vice City Stories GTA: Vice City GXT Editor v1.2 - by CyQ
GTA Vice City GTA San Andreas GXT Builder, by Silent
GTA San Andreas GTA San Andreas Text Editor - by JernejL
GTA San Andreas GTA: San Andreas GXT Editor v1.3 - by Hammer83
GTA San Andreas A-GXT Editor v1.0a - by Aschratt
GTA San Andreas GTA IV X GXT Editor v2.1 - by xmen
GTA IV OpenIV - Have Inbuilt GXT file viewer

Reference

External links

Copyrighted

This page is licensed under the GNU Free Documentation Licence. This page has a separate license to the CC-BY-SA that applies to most of Grand Theft Wiki.

The full text of the GNU FDL v1.2 is here. Click the "History" button to see the full list of authors. See Grand Theft Wiki:Copyright for more detail on our copyright policy.

GNU Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
See Grand Theft Wiki:Copyright for more information.