GBXMapParser.NET 1.0.1

dotnet add package GBXMapParser.NET --version 1.0.1
NuGet\Install-Package GBXMapParser.NET -Version 1.0.1
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="GBXMapParser.NET" Version="1.0.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add GBXMapParser.NET --version 1.0.1
#r "nuget: GBXMapParser.NET, 1.0.1"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install GBXMapParser.NET as a Cake Addin
#addin nuget:?package=GBXMapParser.NET&version=1.0.1

// Install GBXMapParser.NET as a Cake Tool
#tool nuget:?package=GBXMapParser.NET&version=1.0.1


ManiaPlanet GBX map parser written in C# for .NET Core. It provides a static class allowing for parsing of a file via it's file location, a byte array or a stream.


Most of this parser is based on the GBX map parser included in PyPlanet, created by Toffe.


The solution on the GitHub website contains one example, a console application that reads the map information from the included map file.

Ways to parse map information

All three public methods (ReadFile, ReadBytes, ReadStream) in the end use the ReadStream method, and the data will be put into a stream if not being called directly with a stream. This is required to read the required data properly.

Read from file

Reading the map information directly from the file can be done by calling the ReadFile method of the MapParser class:

MapInformation map = MapParser.ReadFile(fileName);
Read from byte array

Reading the map information from a byte array is also possible by calling the ReadBytes method of the MapParser class:

MapInformation map = MapParser.ReadBytes(bytes);
Read from stream

Reading the map information from a stream (FileStream, MemoryStream, etc.) is also possible by calling the ReadStream method of the MapParser class:

MapInformation map = MapParser.ReadStream(stream);

Available information

The following information is being parsed (check out the example for a clearer picture):

  • UId (string): map unique identifier;
  • Name (string): name of the map (with styling);
  • NameStripped (string): name of the map (without styling);
  • AuthorLogin (string): login of the author;
  • TitleId (string): title in which the map is created (e.g. TMCanyon or SMStorm);
  • Environment (string): environment of the map (e.g. Canyon);
  • Mood (string): mood of the map (e.g. Day or Night);
  • DecorationEnvironmentId (string);
  • DecorationEnvironmentAuthor (string);
  • MapType (string): type of the map (e.g. TrackMania\Race);
  • MapStyle (string): style of the map (e.g. Full Speed);
  • MapTypeId (uint): type identifier of the map (corresponds with MapType);
  • IsMultilap (bool): whether the map is a multilap map;
  • Laps (uint): amount of maps to be driven to set a time;
  • Checkpoints (uint): amount of checkpoints in one lap of the map;
  • Price (uint): indicates how heavy the map is for the computer (formerly "copper price");
  • Editor (string): indicates which editor was used to create the map (either Simple or Advanced);
  • AuthorTime (uint): validation time in milliseconds;
  • AuthorScore (uint): validation score;
  • GoldTime (uint): gold time in milliseconds;
  • SilverTime (uint): silver time in milliseconds;
  • BronzeTime (uint): bronze time in milliseconds;
  • AuthorVersion (uint): author version;
  • AuthorNickName (string): nickname of the author at time of validation (with styling);
  • AuthorNickNameStripped (string): nickname of the author at time of validation (without styling);
  • AuthorZone (string): zone of the author at time of validation;
  • AuthorExtra (string);
  • HeaderXml (string): header information as XML string (does not contain all data!);
  • HasThumbnail (bool): whether the map contains a thumbnail;
  • Thumbnail (byte[]): thumbnail (JPEG, 512x512) as byte array;
  • Comments (string): map comments by author.
Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp1.0 is compatible.  netcoreapp1.1 was computed.  netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.0.1 573 1/2/2020
1.0.0 612 2/15/2019

Added ManiaPlanet styling-stripped versions of the map name and author nickname.