Map: {
    type: "compound";
    value: {
        colors: { type: "byteArray"; value: number[] };
        decorations: {
            type: "list";
            value: {
                type: "compound";
                value: {
                    data?: {
                        type: "compound";
                        value: {
                            rot: { type: "int"; value: number };
                            type: { type: "int"; value: number };
                            x: { type: "int"; value: number };
                            y: { type: "int"; value: number };
                        };
                    };
                    key?: {
                        type: "compound";
                        value: {
                            entityId: { type: "long"; value: [high: ..., low: ...] };
                            type: { type: "int"; value: number };
                        };
                    };
                }[];
            };
        };
        dimension: { type: "byte"; value: number };
        fullyExplored: { type: "byte"; value: number };
        height: { type: "short"; value: number };
        mapId: { type: "long"; value: [high: number, low: number] };
        mapLocked: { type: "byte"; value: number };
        parentMapId: { type: "long"; value: [high: number, low: number] };
        scale: { type: "byte"; value: number };
        unlimitedTracking: { type: "byte"; value: number };
        width: { type: "short"; value: number };
        xCenter: { type: "int"; value: number };
        zCenter: { type: "int"; value: number };
    };
}

The Map schema.

NBT structure of a map.

Type declaration

  • type: "compound"
  • value: {
        colors: { type: "byteArray"; value: number[] };
        decorations: {
            type: "list";
            value: {
                type: "compound";
                value: {
                    data?: {
                        type: "compound";
                        value: {
                            rot: { type: "int"; value: number };
                            type: { type: "int"; value: number };
                            x: { type: "int"; value: number };
                            y: { type: "int"; value: number };
                        };
                    };
                    key?: {
                        type: "compound";
                        value: {
                            entityId: { type: "long"; value: [high: ..., low: ...] };
                            type: { type: "int"; value: number };
                        };
                    };
                }[];
            };
        };
        dimension: { type: "byte"; value: number };
        fullyExplored: { type: "byte"; value: number };
        height: { type: "short"; value: number };
        mapId: { type: "long"; value: [high: number, low: number] };
        mapLocked: { type: "byte"; value: number };
        parentMapId: { type: "long"; value: [high: number, low: number] };
        scale: { type: "byte"; value: number };
        unlimitedTracking: { type: "byte"; value: number };
        width: { type: "short"; value: number };
        xCenter: { type: "int"; value: number };
        zCenter: { type: "int"; value: number };
    }
    • colors: { type: "byteArray"; value: number[] }

      An array of bytes that represent color values (65536 entries for a default 128×128 map).

    • decorations: {
          type: "list";
          value: {
              type: "compound";
              value: {
                  data?: {
                      type: "compound";
                      value: {
                          rot: { type: "int"; value: number };
                          type: { type: "int"; value: number };
                          x: { type: "int"; value: number };
                          y: { type: "int"; value: number };
                      };
                  };
                  key?: {
                      type: "compound";
                      value: {
                          entityId: { type: "long"; value: [high: ..., low: ...] };
                          type: { type: "int"; value: number };
                      };
                  };
              }[];
          };
      }

      A list of optional icons to display on the map.

    • dimension: { type: "byte"; value: number }

      0 = The Overworld, 1 = [The Nether](https://minecraft.wiki/w/The Nether), 2 = [The End](https://minecraft.wiki/w/The End), any other value = a static image with no player pin.

    • fullyExplored: { type: "byte"; value: number }

      1 if the map is full explored.

    • height: { type: "short"; value: number }

      The height of the map. Is associated with the scale level.

    • mapId: { type: "long"; value: [high: number, low: number] }

      The Unique ID of the map.

    • mapLocked: { type: "byte"; value: number }

      1 if the map has been locked in a [cartography table](https://minecraft.wiki/w/cartography table).

    • parentMapId: { type: "long"; value: [high: number, low: number] }

      The Unique ID's of the parent maps.

    • scale: { type: "byte"; value: number }

      How zoomed in the map is, and must be a number between 0 and 4 (inclusive) that represent the level. Default 0. If this is changed in an anvil or a [cartography table](https://minecraft.wiki/w/cartography table), the Unique ID of the map changes.

      0
      
    • unlimitedTracking: { type: "byte"; value: number }

      UNDOCUMENTED. Default 0.

      0
      
    • width: { type: "short"; value: number }

      The width of the map. Is associated with the scale level.

    • xCenter: { type: "int"; value: number }

      Center of the map according to real world by X.

    • zCenter: { type: "int"; value: number }

      Center of the map according to real world by Z.