TheGreatRambler/mm2_world

Mario Maker 2 super worlds

Part of the Mario Maker 2 Dataset Collection

Dataset Description

The Mario Maker 2 super worlds dataset consists of 289 thousand super worlds from Nintendo's online service totaling around 13.5GB of data. The dataset was created using the self-hosted Mario Maker 2 api over the course of 1 month in February 2022.

How to use it

The Mario Maker 2 super worlds dataset is a very large dataset so for most use cases it is recommended to make use of the streaming API of datasets. You can load and iterate through the dataset with the following code:

from datasets import load_dataset

ds = load_dataset("TheGreatRambler/mm2_world", streaming=True, split="train")
print(next(iter(ds)))

#OUTPUT:
{
 'pid': '14510618610706594411',
 'world_id': 'c96012bef256ba6b_20200513204805563301',
 'worlds': 1,
 'levels': 5,
 'planet_type': 0,
 'created': 1589420886,
 'unk1': [some binary data],
 'unk5': 3,
 'unk6': 1,
 'unk7': 1,
 'thumbnail': [some binary data]
}

Each row is a unique super world denoted by the world_id created by the player denoted by the pid. Thumbnails are binary PNGs. unk1 describes the super world itself, including the world map, but its format is unknown as of now.

You can also download the full dataset. Note that this will download ~13.5GB:

ds = load_dataset("TheGreatRambler/mm2_world", split="train")

Data Structure

Data Instances

{
 'pid': '14510618610706594411',
 'world_id': 'c96012bef256ba6b_20200513204805563301',
 'worlds': 1,
 'levels': 5,
 'planet_type': 0,
 'created': 1589420886,
 'unk1': [some binary data],
 'unk5': 3,
 'unk6': 1,
 'unk7': 1,
 'thumbnail': [some binary data]
}

Data Fields

Data Splits

The dataset only contains a train split.

Enums

The dataset contains some enum integer fields. This can be used to convert back to their string equivalents:

SuperWorldPlanetType = {
	0: "Earth",
	1: "Moon",
	2: "Sand",
	3: "Green",
	4: "Ice",
	5: "Ringed",
	6: "Red",
	7: "Spiral"
}

<!-- TODO create detailed statistics -->

Dataset Creation

The dataset was created over a little more than a month in Febuary 2022 using the self hosted Mario Maker 2 api. As requests made to Nintendo's servers require authentication the process had to be done with upmost care and limiting download speed as to not overload the API and risk a ban. There are no intentions to create an updated release of this dataset.

Considerations for Using the Data

The dataset consists of super worlds from many different Mario Maker 2 players globally and as such harmful depictions could be present in their super world thumbnails.