Kartendaten

Dieser Artikel behandelt die Daten der Karte als Gegenstand. Für die Daten einer Welt siehe Weltdaten.

Datenbaum im NBT-Explorer: "Meine Testwelt" hat im data-Ordner die Datei idcounts.dat, in der die bisherige höchste Karten-ID steht sowie die map-Dateien für drei Karten. Die Karten-ID ist Teil des jeweiligen Dateinamens.

Kartendaten (engl. Map Item Data) sind die Eigenschaften der Karten, die man im Spiel herstellen kann.

Datenquelle

• .minecraft: Der im Launcher-Profil eingestellte Spielordner (Standard: .minecraft).
  • saves: Alle mit dieser Minecraft-Version generierten Welten.
    • Name des Weltordners: Der Weltordner enthält alle Daten einer Welt. Der Name wird im Menü/Welt erstellen vergeben.
      • data: Verschiedene Dateien mit Daten dieser Welt.
        • idcounts.dat: Eine Datei zur Speicherung von ID-Zählern. Zur Zeit gibt es nur für die Karten einen ID-Zähler.
        • map_Karten-ID.dat: Für jede beschriebene Karte existiert im data-Ordner der Welt eine eigene map-Datei mit der jeweiligen Karten-ID im Namen.

Änderbarkeit der Daten

Kartendaten werden im NBT-Format gespeichert. Das heißt, diese Daten sind außerhalb des Spiels nur mit einem speziellen NBT-Editor einseh- und änderbar. Im Spiel ändern sich die Daten, wenn man die Landschaft ändert und dann die Karte in die Hand nimmt. Mit Befehlen kann nur die Landschaft geändert werden, nicht die Karte.

Funktionsweise

Im Spiel können Karten kopiert werden. Da jede Kopie dieselbe Karten-ID hat, greifen alle Kopien auf dieselben Kartendaten zu. Dadurch wird eine Kopie, die sicher in einer Truhe verwahrt ist, automatisch mit aktualisiert, wenn der Spieler das Original mit auf Reisen nimmt.

Eine Kartendatei bleibt erhalten, auch wenn alle Exemplare der Karte mit dieser ID im Spiel zerstört werden.

Datenstruktur

Karten-ID

Die ID-Zähler-Datei ist zur Speicherung von beliebigen ID-Zählern vorgesehen. Zur Zeit gibt es jedoch nur für die Karten einen ID-Zähler.

• idcounts.dat: Die Datei mit den ID-Zählern.
  • map: Die höchste bisher vergebene Karten-ID. Sie beginnt bei 0 und wird mit jeder neuen Karte um 1 erhöht.

Karte

• map_ID.dat: Eine Datei mit den Kartendaten einer Karte.
  • DataVersion: Die Version-ID der Minecraft-Version, mit der die Kartendaten zuletzt gespeichert wurden. Bei erneuten Betreten der Welt wird diese Version mit der Version-Eigenschaft der Weltdaten verglichen. Falls die Kartendaten mit veralteter oder fehlender DataVersion geladen werden, werden veraltete Eigenschaften entfernt oder gegebenenfalls umgewandelt und ersetzt.
  • data: Alle Daten einer Karte. Die Karten-ID ist Teil des Dateinamens.
    • banners: Liste der Bannermarkierungen.
      • Eine Bannermarkierung.
        • Color: Der ID-Name für die Grundfarbe des Banners.
        • Name: Optional: Der Name des Banners als JSON-Text.
        • Pos: Die Position des Banners in der Welt.
          • X: Die X-Weltkoordinate.
          • Y: Die Y-Weltkoordinate.
          • Z: Die Z-Weltkoordinate.
    • colors: Array aus 128×128 Bytes mit den Farbwerten. Sortierung = XZ. Jede Farbe ist ein Byte, d.h. theoretisch könnten so 256 verschiedene Farben dargestellt werden. Setzt man jedoch einen Farbwert größer als 207, wird die komplette Karte leer dargestellt.
    • dimension: ID-Name der Dimension. Im Nether zeigen Karten jedoch nur ein spezifisches Rauschmuster und nicht die Landschaft.
    • scale: Maßstab: von 0 = Maßstab 1:1 bis 4 = Maßstab 1:16.
    • trackingPosition: 1 oder 0 (true/false). Wenn true (Standard), wird die Position des Spielers als Richtungspfeil angezeigt, solange er sich im Kartengebiet befindet, als Kreis am Kartenrand, wenn er sich in der Nähe des Kartengebietes befindet und gar nicht, wenn er weit entfernt ist. Bei false erscheint nie eine Positionsmarkierung.
    • unlimitedTracking: 1 oder 0 (true/false). Wenn true (Standard), wird die Position des Spielers als kleiner Kreis angezeigt, wenn er weit vom Kartengebiet entfernt ist und es sich um eine Schatzkarte handelt (siehe Gegenstandsdaten).
    • xCenter: X-Weltkoordinate des Blockes, der im Zentrum der Karte liegt. Blöcke am linken Rand der Karte haben beim Maßstab 1:1 die X-Koordinate xCenter - 64, am rechten Rand xCenter + 63.
    • zCenter: Z-Weltkoordinate der Blockes, der im Zentrum der Karte liegt. Blöcke am oberen Rand der Karte haben beim Maßstab 1:1 die Z-Koordinate zCenter - 64, am unteren Rand zCenter + 63.

Liste der Farbwerte

Darstellung der Höhenunterschiede in einer Wüstenkarte mit hellen und dunklen Abstufungen der Basisfarbe für Sand

Es gibt insgesamt 208 Farb-IDs in 36 Farbgruppen. Jede Farbgruppe besteht aus vier Farben, die sich durch Aufhellen oder Abdunkeln der dritten Farbe ableiten lassen. Dies geschieht durch Multiplikation der RGB-Werte der dritten Farbe mit einem Faktor: ¹⁸⁰⁄₂₅₅ für die erste Farbe, ²²⁰⁄₂₅₅ für die zweite und ¹³⁵⁄₂₅₅ für die vierte. Dies dient der Darstellung eines Höhenreliefs, denn stehen in der Welt zwei gleiche Blöcke nebeneinander auf unterschiedlichen Ebenen, wird dieser Höhenunterschied durch eine andere Farbe aus derselben Farbgruppe dargestellt.

Bei den Farbwerten geht es nicht um die Identifikation eines bestimmten Blockes, sondern um die Wiedererkennung der Landschaft. Daher werden in der nachfolgenden Tabelle absichtlich nicht alle Blöcke genannt, denn viele haben denselben Farbwert und sind auf der Karte nicht unterscheidbar. Außerdem würde die Nennung der Blöcke nur für den Maßstab 1:1 gelten, bei den anderen Maßstäben werden bis zu 256 Blöcke zu einem Farbwert zusammengefasst.

Verallgemeinert ist der Farbwert eines Blockes der durchschnittliche Farbwert seiner Originaltextur. Dabei haben Blöcke mit unterschiedlich gefärbten Seiten auch unterschiedliche Farbwerte in der Karte: Ein aufrecht hingestelltes Birkenholz ist in der Karte beige (Farb-ID 10), auf der Seite liegend ist es in der Karte weiß (Farb-ID 58). Ändert man mit einem Ressourcenpaket die Texturfarbe, hat das keine Auswirkung auf die Karte. Beispielsweise wird auch ein rot gefärbter Stein weiterhin in der Karte mit seiner originalen grauen Farbe dargestellt.

Hexadezimal	Farb-ID	Farbe	RGB-Werte	Beispiel
00	0		transparent	Glas
01	1		transparent
02	2		transparent
03	3		transparent
04	4		88, 124, 39	Grasblock
05	5		108, 151, 47
06	6		125, 176, 55
07	7		66, 93, 29
08	8		172, 162, 114	Sand
09	9		210, 199, 138
0A	10		244, 230, 161
0B	11		128, 122, 85
0C	12		138, 138, 138	Spinnennetz
0D	13		169, 169, 169
0E	14		197, 197, 197
0F	15		104, 104, 104
10	16		178, 0, 0	Lava
11	17		217, 0, 0
12	18		252, 0, 0
13	19		133, 0, 0
14	20		111, 111,178	Eis
15	21		136, 136,217
16	22		158, 158,252
17	23		83,83,133
18	24		116,116,116	Eisenblock
19	25		142,142,142
1A	26		165,165,165
1B	27		87,87,87
1C	28		0,86,0	Laub
1D	29		0,105,0
1E	30		0,123,0
1F	31		0,64,0
20	32		178,178,178	Quarzblock
21	33		217,217,217
22	34		252,252,252
23	35		133,133,133
24	36		114,117,127	Tonblock
25	37		139,142,156
26	38		162,166,182
27	39		85,87,96
28	40		105,75,53	Erde
29	41		128,93,65
2A	42		149,108,76
2B	43		78,56,39
2C	44		78,78,78	Stein
2D	45		95,95,95
2E	46		111,111,111
2F	47		58,58,58
30	48		44,44,178	Wasser
31	49		54,54,217
32	50		63,63,252
33	51		33,33,133
34	52		99,83,49	Eichenholzbretter
35	53		122,101,61
36	54		141,118,71
37	55		74,62,38
38	56		178,175,170	Schnee, weiße Wolle
39	57		217,214,208
3A	58		252,249,242
3B	59		133,131,127
3C	60		150,88,36	orange Wolle
3D	61		184,108,43
3E	62		213,125,50
3F	63		113,66,27
40	64		124,52,150	magenta Wolle
41	65		151,64,184
42	66		176,75,213
43	67		93,39,113
44	68		71,107,150	hellblaue Wolle
45	69		87,130,184
46	70		101,151,213
47	71		53,80,113
48	72		159,159,36	gelbe Wolle
49	73		195,195,43
4A	74		226,226,50
4B	75		120,120,27
4C	76		88,142,17	hellgrüne Wolle
4D	77		108,174,21
4E	78		125,202,25
4F	79		66,107,13
50	80		168,88,115	rosa Wolle
51	81		206,108,140
52	82		239,125,163
53	83		126,66,86
54	84		52,52,52	graue Wolle
55	85		64,64,64
56	86		75,75,75
57	87		39,39,39
58	88		107,107,107	hellgraue Wolle
59	89		130,130,130
5A	90		151,151,151
5B	91		80,80,80
5C	92		52,88,107	türkise Wolle
5D	93		64,108,130
5E	94		75,125,151
5F	95		39,66,80
60	96		88,43,124	violette Wolle
61	97		108,53,151
62	98		125,62,176
63	99		66,33,93
64	100		36,52,124	blaue Wolle
65	101		43,64,151
66	102		50,75,176
67	103		27,39,93
68	104		71,52,36	braune Wolle
69	105		87,64,43
6A	106		101,75,50
6B	107		53,39,27
6C	108		71,88,36	grüne Wolle
6D	109		87,108,43
6E	110		101,125,50
6F	111		53,66,27
70	112		107,36,36	rote Wolle
71	113		130,43,43
72	114		151,50,50
73	115		80,27,27
74	116		17,17,17	schwarze Wolle
75	117		21,21,21
76	118		25,25,25
77	119		13,13,13
78	120		174,166,53	Goldblock
79	121		212,203,65
7A	122		247,235,76
7B	123		130,125,39
7C	124		63,152,148	Diamantblock
7D	125		78,186,181
7E	126		91,216,210
7F	127		47,114,111
80	128		51,89,178	Lapislazuliblock
81	129		62,109,217
82	130		73,129,252
83	131		39,66,133
84	132		0,151,39	Smaragdblock
85	133		0,185,49
86	134		0,214,57
87	135		0,113,30
88	136		90,59,34	Fichtenholzbretter
89	137		110,73,41
8A	138		127,85,48
8B	139		67,44,25
8C	140		78,1,0	Netherziegel
8D	141		95,1,0
8E	142		111,2,0
8F	143		58,1,0
90	144		148,124,114	Weiße Keramik
91	145		180,153,139
92	146		209,177,161
93	147		111,94,85
94	148		112,58,25	Orange Keramik
95	149		137,71,31
96	150		159,82,36
97	151		84,43,19
98	152		105,61,76	Magenta Keramik
99	153		129,75,93
9A	154		149,87,108
9B	155		79,46,57
9C	156		79,76,97	Hellblaue Keramik
9D	157		97,93,119
9E	158		112,108,138
9F	159		59,57,73
A0	160		131,94,25	Gelbe Keramik
A1	161		160,115,31
A2	162		186,133,36
A3	163		98,70,19
A4	164		73,83,37	Hellgrüne Keramik
A5	165		89,101,46
A6	166		103,117,53
A7	167		55,62,28
A8	168		113,54,55	Rosa Keramik
A9	169		138,66,67
AA	170		160,77,78
AB	171		85,41,41
AC	172		40,29,25	Graue Keramik
AD	173		49,35,30
AE	174		57,41,35
AF	175		30,22,19
B0	176		95,76,69	Hellgraue Keramik
B1	177		116,92,85
B2	178		135,107,98
B3	179		71,57,52
B4	180		61,65,65	Türkise Keramik
B5	181		75,79,79
B6	182		87,92,92
B7	183		46,49,49
B8	184		86,52,62	Violette Keramik
B9	185		105,63,76
BA	186		122,73,88
BB	187		65,39,47
BC	188		54,44,65	Blaue Keramik
BD	189		66,53,79
BE	190		76,62,92
BF	191		40,33,49
C0	192		54,35,25	Braune Keramik
C1	193		66,43,30
C2	194		76,50,35
C3	195		40,26,19
C4	196		54,58,30	Grüne Keramik
C5	197		66,71,36
C6	198		76,82,42
C7	199		40,43,22
C8	200		100,42,32	Rote Keramik
C9	201		123,52,40
CA	202		142,60,46
CB	203		75,32,24
CC	204		26,16,11	Schwarze Keramik
CD	205		32,19,14
CE	206		37,22,16
CF	207		20,12,8