Skip to content

GBX Reference

Tom edited this page Jul 13, 2021 · 8 revisions

For *.Map.Gbx

Name Type Description
authorLogin String Maniaplanet Login of the map author
Trackmania Turbo 24 character long base 64 string
Trackmania® 22 character long base 62 string
authorNickname String Maniaplanet Nickname with formatting
Trackmania Turbo Uplay username
Trackmania®
authorZone String Zone of the author divided with |
authorVersion Number Obsolete Always 0
authorExtraInfo String Obsolete Empty
authorScore Number Deprecated For Trackmania United only
authorTime Number Author time in ms
goldTime Number Gold time in ms
silverTime Number Silver time in ms
bronzeTime Number Bronze time in ms
mapName String Map name
mapStyle String Obsolete Empty
mapType String Usually "Race" or "Trackmania\Race" in older versions
(better documentation required)
comments String Map comments
cost Number Copper size / Display cost
editorMode Number 0 Advanced editor
1 Simple editor
2 Advanced editor with ghost blocks
nbCheckpoints Number Amount of checkpoints
nbLaps Number Amount of laps
isMultilap Boolean Whether map is multilap
decoration Object
decoration.id String Mood of the map but in e.g. Day48 format
decoration.collection String Map environment
Number Not implemented map, use this table for reference
decoration.author String Author of the environment
mapInfo Object
mapInfo.id String Map UID
mapInfo.collection String Map environment
Number Not implemented map, use this table for reference
mapInfo.author String Map author (same as authorLogin)
titleUID String TMStadium, TMValley, TMCanyon, TMLagoon or SMStorm: offical ManiaPlanet titlepacks,
TMCE@nadeolabs or TMTurbo@nadeolabs: Trackmania Turbo,
(name)@(author) for custom titlepacks and Trackmania: Trackmania®
trackType Number 0 Race
1 Platform
2 Puzzle
3 Crazy
4 Shortcut
5 Stunts
6 Script
lightmapCacheUID String 12 character long base 64 string
lightmapVersion Number 0 Shadows not calculated
6 Trackmania Turbo or Maniaplanet 3 calculation engine version
7 Maniaplanet 4+ calculation engine version
8 Trackmania® calculation engine version
locked Boolean Obsolete Virtual Skipper feature to lock the map parameters, always false
password String Obsolete Empty
mapOrigin Object
mapOrigin.x String Obsolete Trackmania Original feature, always "0.00"
mapOrigin.y
mapTarget Object
mapTarget.x String Obsolete Trackmania Original feature, always "0.00"
mapTarget.y
xml String The entire readable header data in one string, includes embedded locators for signs or horns

gbx.js exclusive data points

mapNameD String Map name deformatted
isSimpleEdtior Boolean Whether map was built in Simple Editor
hasGhostBlocks Boolean Whether map has Ghost Blocks
thumbnail Uint8Array (thumbnail: true) Thumbnail stored as Uint8Array
String (thumbnail: "base64") Thumbnail stored as base 64 string
thumbnailSize Number Requires thumbnail option to not be false, thumbnail size in bytes

For *.Replay.Gbx

Name Type Description
authorLogin String Maniaplanet Login of the map author
Trackmania Turbo 24 character long base 64 string
Trackmania® 22 character long base 62 string
authorNickname String
Maniaplanet
Nickname with formatting
Trackmania Turbo Uplay username
Trackmania®
authorZone String Zone of the author divided with |
authorVersion Number Obsolete always 0
authorExtraInfo String Obsolete always ""
driverLogin String Realistically, same as authorLogin
driverNickname String Realistically, same as authorNickname
time Number Replay time in ms
mapInfo Object
mapInfo.id String Map UID
mapInfo.collection String Map environment
Number Map environment
mapInfo.author String Map author (same as authorLogin)
titleUID String TMStadium, TMValley, TMCanyon, TMLagoon or SMStorm: offical ManiaPlanet titlepacks,
TMCE@nadeolabs or TMTurbo@nadeolabs: Trackmania Turbo,
(name)@(author) for custom titlepacks and Trackmania: Trackmania®

Collection IDs

The collection ID specifies the maps environment. Taken from this table.

Collection Number Text Stored as Included in gbx.js
Desert 0 Speed Text
Snow 1 Alpine Text
Rally 2 Rally Text
Island 3 Island Text
Bay 4 Bay Text
Coast 5 Coast Text
StadiumMP4 6 Stadium Text Yes
Basic 7 Basic Text
Plain 8 Plain Text
Moon 9 Moon Text
Toy 10 Toy Text
Valley 11 Number Yes
Canyon 12 Number Yes
Lagoon 13 Number Yes
Deprecated_Arena 14 Number
TMCommon 17 Number
Canyon4 18 Number
Canyon256 19 Number
Valley4 20 Number
Valley256 21 Number
Lagoon4 22 Number
Lagoon256 23 Number
Stadium4 24 Number
Stadium256 25 Number Yes
Stadium 26 Number Yes
History 100 Number
Society 101 Number
Galaxy 102 Number
Gothic 200 Number
Paris 201 Number
Storm 202 Number
Cryo 203 Number
Meteor 204 Number
Meteor4 205 Number
Meteor256 206 Number
SMCommon 299 Number
Vehicles 10000 Text
Orbital 10001 Number
Actors 10002 Number
Common 10003 Number Yes
_Unassigned -1 Unassigned Text