2b2t Atlas API

Example request

https://api.blackportal.cloud/api/maprenders/catalog

Open live response

Responses

200 Primary layers and location renders.

Response body application/json

Checked October 19, 2026. Recorded response, shortened to one item per array. Values can change. The field list describes this example; use OpenAPI for the full schema.

{
  "primary": [
    {
      "kind": "primary",
      "id": "256k",
      "defaultEnabled": false,
      "worldDownloadUrl": null,
      "name": "256k (2021)",
      "dimension": 0,
      "scale": "256k",
      "tileUrlTemplate": "https://blackportal.cloud/AtlasTiles/Overworld/256k/{dn}/{z}/{y}/{x}.png",
      "hasDayNight": true,
      "maxNativeZoom": null,
      "coordinateScheme": "xyz-v1",
      "source": "2b2t Atlas",
      "worldDownloadDate": null,
      "locationId": null,
      "locationName": null,
      "locationX": null,
      "locationZ": null,
      "minX": null,
      "minZ": null,
      "maxXExclusive": null,
      "maxZExclusive": null
    }
  ],
  "locations": [
    {
      "kind": "location",
      "id": "render-1",
      "defaultEnabled": false,
      "worldDownloadUrl": null,
      "name": "cutecurly's City (2025)",
      "dimension": 0,
      "scale": "1",
      "tileUrlTemplate": "https://blackportal.cloud/AtlasTiles/cutecurlys-city-2025/overworld/g-20260820012216-a1940519/{dn}/{z}/{y}/{x}.png",
      "hasDayNight": true,
      "maxNativeZoom": 9,
      "coordinateScheme": "atlas-sparse-v1",
      "source": null,
      "worldDownloadDate": "2025-06-03",
      "locationId": 1242,
      "locationName": "cutecurly's City (2025)",
      "locationX": -2385763,
      "locationZ": 460640,
      "minX": -2386224,
      "minZ": 460272,
      "maxXExclusive": -2385200,
      "maxZExclusive": 461072
    }
  ]
}

Fields in this example

Up to three levels. [] means an array item. Types describe this example, not the complete schema.

Field	Example type
$	object
$.primary	array
$.primary[]	object
$.primary[].kind	string
$.primary[].id	string
$.primary[].defaultEnabled	boolean
$.primary[].worldDownloadUrl	null
$.primary[].name	string
$.primary[].dimension	integer
$.primary[].scale	string
$.primary[].tileUrlTemplate	string
$.primary[].hasDayNight	boolean
$.primary[].maxNativeZoom	null
$.primary[].coordinateScheme	string
$.primary[].source	string
$.primary[].worldDownloadDate	null
$.primary[].locationId	null
$.primary[].locationName	null
$.primary[].locationX	null
$.primary[].locationZ	null
$.primary[].minX	null
$.primary[].minZ	null
$.primary[].maxXExclusive	null
$.primary[].maxZExclusive	null
$.locations	array
$.locations[]	object
$.locations[].kind	string
$.locations[].id	string
$.locations[].defaultEnabled	boolean
$.locations[].worldDownloadUrl	null
$.locations[].name	string
$.locations[].dimension	integer
$.locations[].scale	string
$.locations[].tileUrlTemplate	string
$.locations[].hasDayNight	boolean
$.locations[].maxNativeZoom	integer
$.locations[].coordinateScheme	string
$.locations[].source	null
$.locations[].worldDownloadDate	string
$.locations[].locationId	integer
$.locations[].locationName	string
$.locations[].locationX	integer
$.locations[].locationZ	integer
$.locations[].minX	integer
$.locations[].minZ	integer
$.locations[].maxXExclusive	integer
$.locations[].maxZExclusive	integer

Example request

https://api.blackportal.cloud/api/maprenders

Open live response

Responses

200 Published layers.

Response body application/json

Checked October 19, 2026. Recorded response, shortened to one item per array. Values can change. The field list describes this example; use OpenAPI for the full schema.

[
  {
    "id": 2,
    "coordinateScheme": "xyz-v1",
    "minX": null,
    "minZ": null,
    "maxXExclusive": null,
    "maxZExclusive": null,
    "defaultEnabled": false,
    "archiveSha256": null,
    "worldDownloadUrl": null,
    "slug": "spawn-fragment-july-2011-overworld",
    "name": "1k (2011)",
    "dimension": 0,
    "scale": "1k",
    "urlTemplate": "https://blackportal.cloud/AtlasTiles/spawn-fragment-july-2011-overworld-42a63b5587/{z}/{y}/{x}.png",
    "hasDayNight": false,
    "maxNativeZoom": 9,
    "worldDownloadDate": "2011-07-02",
    "source": "SpawnMasons archive (NFE 2011-07-02 ruins); recovered via Archive+",
    "sortOrder": 10,
    "isPublished": true,
    "dateAddedUtc": "2026-09-02T15:53:29.807-06:00"
  }
]

Fields in this example

Up to three levels. [] means an array item. Types describe this example, not the complete schema.

Field	Example type
$	array
$[]	object
$[].id	integer
$[].coordinateScheme	string
$[].minX	null
$[].minZ	null
$[].maxXExclusive	null
$[].maxZExclusive	null
$[].defaultEnabled	boolean
$[].archiveSha256	null
$[].worldDownloadUrl	null
$[].slug	string
$[].name	string
$[].dimension	integer
$[].scale	string
$[].urlTemplate	string
$[].hasDayNight	boolean
$[].maxNativeZoom	integer
$[].worldDownloadDate	string
$[].source	string
$[].sortOrder	integer
$[].isPublished	boolean
$[].dateAddedUtc	string

Parameters

Responses

200 ZIP file.

application/zip Binary ZIP archive of the saved world. Follow the download URL returned by metadata; the body is not JSON.

206 Requested byte range.

application/zip Binary ZIP archive of the saved world. Follow the download URL returned by metadata; the body is not JSON.

404 No public source is available.

409 Checksum changed; refresh the layer record.

416 Byte range is outside the file.

429 Too many downloads.

503 Source file temporarily unavailable.

Example request

https://api.blackportal.cloud/api/find/sources

Open live response

Responses

200 Visible sources with status, products, records, completedParts and totalParts. ready describes the listed indexed products, not complete world coverage. partial and waiting sources may have missing or unprocessed block data. savedObjects gives positioned-object counts for completed location galleries; absent means this derivative is not available. records remains the block-observation count.

Response body application/json

Checked October 19, 2026. Recorded response, shortened to one item per array. Values can change. The field list describes this example; use OpenAPI for the full schema.

[
  {
    "id": "nocom:overworld",
    "name": "NoCom historical observations",
    "family": "nocom",
    "dimension": "overworld",
    "status": "ready",
    "products": [
      "sign"
    ],
    "records": 1174278,
    "completedParts": 1,
    "totalParts": 1,
    "captureDate": null,
    "provenance": "Historical NoCom observations; spawners are a reviewed subset",
    "sourceUrl": "https://github.com/nerdsinspace/nocom-explanation/blob/main/torrent.md",
    "updatedUtc": "2026-10-09T23:53:14.596598+00:00",
    "savedObjects": null
  }
]

Fields in this example

Up to three levels. [] means an array item. Types describe this example, not the complete schema.

Field	Example type
$	array
$[]	object
$[].id	string
$[].name	string
$[].family	string
$[].dimension	string
$[].status	string
$[].products	array
$[].products[]	string
$[].records	integer
$[].completedParts	integer
$[].totalParts	integer
$[].captureDate	null
$[].provenance	string
$[].sourceUrl	string
$[].updatedUtc	string
$[].savedObjects	null

503 Find index or current publication catalog is unavailable. Retry later.

Example request

https://api.blackportal.cloud/api/find?dimension=overworld&kinds=storage&sources=wdl&contentsRecorded=true&x=-3077978&z=28998004&radius=16&minY=99&maxY=99&limit=1

Open live response

Parameters

Responses

200 total, nextOffset and distinct category/XYZ results. observation is the representative captured version; matchingCaptures counts selected sources that match the filters. detailsJson is JSON-encoded: storage may contain inventoryDeferred, inventoryListSaved, properties and savedDetailUrl. Load inventory only on expansion; if deferred without a URL, find the same observation id in history. Unknown contents are not an empty inventory. locationId plus captureUrl identifies a 3D capture; NoCom has no associated 3D WDL. Mobs, map art, banners, item frames and other objects are capture-specific. detailsJson.savedObject contains the object ID, generation and navigation links. Saved objects also expose displayName, customName and savedObject identity/links as structured fields. customName is null without an explicit saved name. Legacy detailsJson is retained for compatibility and full saved attributes.

Response body application/json

Checked October 19, 2026. Recorded response, shortened to one item per array. Values can change. The field list describes this example; use OpenAPI for the full schema.

{
  "total": 3,
  "nextOffset": 1,
  "items": [
    {
      "key": "overworld:storage:-3077978:99:28998004",
      "observation": {
        "id": 2925313,
        "sourceId": "wdl:2226:1a50b22d0a246074",
        "sourceName": "Boby's Border Base 2",
        "family": "wdl",
        "provenance": "Archive / museum capture",
        "kind": "storage",
        "dimension": "overworld",
        "x": -3077978,
        "y": 99,
        "z": 28998004,
        "blockType": "minecraft:chest",
        "text": "",
        "firstObservedUtc": "2026-09-22",
        "lastObservedUtc": "2026-09-22",
        "timeKind": "capture",
        "sourceUrl": "https://api.blackportal.cloud/bluemap/render-2226-1a50b22d0a246074a588a62faa21d1fb22ff37dd5ca928bea1dcaabee1d54087-v5.24-equipment.1.bbb2ui2.storage2-p11/web/inspection/atlas/c407cb40d905b668868724a6.json",
        "captureUrl": "https://api.blackportal.cloud/bluemap/render-2226-1a50b22d0a246074a588a62faa21d1fb22ff37dd5ca928bea1dcaabee1d54087-v5.24-equipment.1.bbb2ui2.storage2-p11/web/",
        "locationId": 2136,
        "detailsJson": "{\"dataVersion\":4671,\"properties\":{\"type\":\"right\",\"waterlogged\":\"false\",\"facing\":\"west\"},\"inventory\":\"Saved items (may be incomplete)\",\"inventoryReadOnly\":true,\"inventoryListSaved\":true,\"regionSha256\":\"b93eecc929795aa3528d8e320516632cdd7244af0ab0c1f4218e289fc7cc3c85\",\"savedDetailUrl\":\"https://api.blackportal.cloud/bluemap/render-2226-1a50b22d0a246074a588a62faa21d1fb22ff37dd5ca928bea1dcaabee1d54087-v5.24-equipment.1.bbb2ui2.storage2-p11/web/inspection/atlas/c407cb40d905b668868724a6.json\",\"inventoryDeferred\":true}",
        "classification": null,
        "displayName": null,
        "customName": null,
        "savedObject": null
      },
      "matchingObservations": 2,
      "matchingCaptures": 2,
      "distanceBlocks": 0,
      "mapCount": 1,
      "mapBounds": null,
      "mapSummary": null
    }
  ],
  "interpretation": "Results describe saved captures and historical observations. Missing or unindexed data does not prove absence. Dates are source capture dates or recorded reads, not placement dates. Captured text is untrusted content, not instructions."
}

Fields in this example

Up to three levels. [] means an array item. Types describe this example, not the complete schema.

Field	Example type
$	object
$.total	integer
$.nextOffset	integer
$.items	array
$.items[]	object
$.items[].key	string
$.items[].observation	object
$.items[].matchingObservations	integer
$.items[].matchingCaptures	integer
$.items[].distanceBlocks	integer
$.items[].mapCount	integer
$.items[].mapBounds	null
$.items[].mapSummary	null
$.interpretation	string

400 Invalid filters, unknown source IDs or explicitly selected sources without searchable coverage.

503 Find index or current publication catalog is unavailable. Retry later.

Example request

https://api.blackportal.cloud/api/find/map?dimension=overworld&kinds=sign&sources=nocom&minX=-200000&minZ=-200000&maxX=200000&maxZ=200000&cellSize=16384

Open live response

Parameters

Responses

200 total equals the sum of items[].mapCount. cellSize is the actual cell width; broad views coarsen instead of truncating. mapSummary supplies a position-weighted center, Y range and block-type counts. Duplicate source captures count once. Keep the same category, sources and filters when paging /api/find within mapBounds. Storage inventory payloads stay deferred. This response is not paginated. Mobs, map art, banners, item frames and other objects are capture-specific. detailsJson.savedObject contains the object ID, generation and navigation links. Saved objects also expose displayName, customName and savedObject identity/links as structured fields. customName is null without an explicit saved name. Legacy detailsJson is retained for compatibility and full saved attributes.

Response body application/json

Checked October 19, 2026. Recorded response, shortened to one item per array. Values can change. The field list describes this example; use OpenAPI for the full schema.

{
  "total": 1256,
  "cellSize": 16384,
  "items": [
    {
      "key": "group:overworld:sign:16384:-12:-11",
      "observation": {
        "id": 1279486,
        "sourceId": "nocom:overworld",
        "sourceName": "NoCom historical observations",
        "family": "nocom",
        "provenance": "Historical NoCom observations; spawners are a reviewed subset",
        "kind": "sign",
        "dimension": "overworld",
        "x": -190800,
        "y": 64,
        "z": -169481,
        "blockType": "minecraft:oak_sign",
        "text": "the legal boat \ndock\n\n",
        "firstObservedUtc": "2020-06-19T02:45:56.676000+00:00",
        "lastObservedUtc": "2020-06-19T02:45:56.676000+00:00",
        "timeKind": "recorded read",
        "sourceUrl": "https://api.blackportal.cloud/api/nocom/find/sign-history/sign%3A0%3A-190800%3A64%3A-169481",
        "captureUrl": "https://2b2tatlas.com/nocom/",
        "locationId": null,
        "detailsJson": "{}",
        "classification": null,
        "displayName": null,
        "customName": null,
        "savedObject": null
      },
      "matchingObservations": 42,
      "matchingCaptures": 1,
      "distanceBlocks": null,
      "mapCount": 34,
      "mapBounds": {
        "minX": -190800,
        "minZ": -169494,
        "maxX": -190745,
        "maxZ": -169424
      },
      "mapSummary": {
        "x": -190785.82352941178,
        "z": -169453.26470588235,
        "minY": 64,
        "maxY": 85,
        "blocks": [
          {
            "blockType": "minecraft:oak_sign",
            "count": 34
          }
        ]
      }
    }
  ]
}

Fields in this example

Up to three levels. [] means an array item. Types describe this example, not the complete schema.

Field	Example type
$	object
$.total	integer
$.cellSize	integer
$.items	array
$.items[]	object
$.items[].key	string
$.items[].observation	object
$.items[].matchingObservations	integer
$.items[].matchingCaptures	integer
$.items[].distanceBlocks	null
$.items[].mapCount	integer
$.items[].mapBounds	object
$.items[].mapSummary	object

400 Invalid filters, unknown source IDs or explicitly selected sources without searchable coverage.

503 Find index or current publication catalog is unavailable. Retry later.

Example request

https://api.blackportal.cloud/api/find/history?dimension=overworld&kind=sign&x=61176&y=51&z=197427

Open live response

Parameters

Responses

200 total, nextOffset and up to 50 visible observations at this exact position, across all visible sources. History does not inherit search source, text or date filters; unknown dates remain null.

Response body application/json

Checked October 19, 2026. Recorded response, shortened to one item per array. Values can change. The field list describes this example; use OpenAPI for the full schema.

{
  "total": 1,
  "nextOffset": null,
  "items": [
    {
      "id": 1280935,
      "sourceId": "nocom:overworld",
      "sourceName": "NoCom historical observations",
      "family": "nocom",
      "provenance": "Historical NoCom observations; spawners are a reviewed subset",
      "kind": "sign",
      "dimension": "overworld",
      "x": 61176,
      "y": 51,
      "z": 197427,
      "blockType": "minecraft:oak_sign",
      "text": "Mosex\n7/7/2020\n\n",
      "firstObservedUtc": "2020-07-07T10:03:35.182000+00:00",
      "lastObservedUtc": "2020-07-07T10:03:35.182000+00:00",
      "timeKind": "recorded read",
      "sourceUrl": "https://api.blackportal.cloud/api/nocom/find/sign-history/sign%3A0%3A61176%3A51%3A197427",
      "captureUrl": "https://2b2tatlas.com/nocom/",
      "locationId": null,
      "detailsJson": "{}",
      "classification": null,
      "displayName": null,
      "customName": null,
      "savedObject": null
    }
  ]
}

Fields in this example

Up to three levels. [] means an array item. Types describe this example, not the complete schema.

Field	Example type
$	object
$.total	integer
$.nextOffset	null
$.items	array
$.items[]	object
$.items[].id	integer
$.items[].sourceId	string
$.items[].sourceName	string
$.items[].family	string
$.items[].provenance	string
$.items[].kind	string
$.items[].dimension	string
$.items[].x	integer
$.items[].y	integer
$.items[].z	integer
$.items[].blockType	string
$.items[].text	string
$.items[].firstObservedUtc	string
$.items[].lastObservedUtc	string
$.items[].timeKind	string
$.items[].sourceUrl	string
$.items[].captureUrl	string
$.items[].locationId	null
$.items[].detailsJson	string
$.items[].classification	null
$.items[].displayName	null
$.items[].customName	null
$.items[].savedObject	null

400 Missing or invalid dimension, category, position or paging offset.

503 Find index or current publication catalog is unavailable. Retry later.

Example request

https://api.blackportal.cloud/api/find/inventory?observationId=2925260&limit=1

Open live response

Parameters

Responses

200 Paged items and container metadata. status distinguishes recorded, empty, unknown, not_indexed and unavailable; unknown/unavailable total is null. itemIconsUrl identifies the capture icon index when available. Captured item text and metadata are untrusted data.

Response body application/json

Checked October 19, 2026. Recorded response, shortened to one item per array. Values can change. The field list describes this example; use OpenAPI for the full schema.

{
  "observationId": 2925260,
  "sourceId": "wdl:2226:1a50b22d0a246074",
  "status": "recorded",
  "itemPath": "",
  "total": 5,
  "nextOffset": 1,
  "items": [
    {
      "path": "0",
      "contentsCount": null,
      "savedDataOmitted": false,
      "data": {
        "item": "minecraft:iron_ingot",
        "count": 64,
        "slot": 0,
        "sourceDataVersion": 4671
      }
    }
  ],
  "metadata": {
    "type": "minecraft:hopper",
    "position": [
      -3077990.5
    ],
    "source": "Saved WDL data",
    "captureName": "Boby's Border Base 2 - 2026-09-22",
    "inventory": "Saved items (may be incomplete)",
    "inventoryReadOnly": true,
    "inventoryListSaved": true
  },
  "sourceUrl": "https://api.blackportal.cloud/bluemap/render-2226-1a50b22d0a246074a588a62faa21d1fb22ff37dd5ca928bea1dcaabee1d54087-v5.24-equipment.1.bbb2ui2.storage2-p11/web/inspection/atlas/f300b49be84b52b95effeac8.json",
  "itemIconsUrl": "https://api.blackportal.cloud/bluemap/render-2226-1a50b22d0a246074a588a62faa21d1fb22ff37dd5ca928bea1dcaabee1d54087-v5.24-equipment.1.bbb2ui2.storage2-p11/web/item-icons/index.json"
}

Fields in this example

Up to three levels. [] means an array item. Types describe this example, not the complete schema.

Field	Example type
$	object
$.observationId	integer
$.sourceId	string
$.status	string
$.itemPath	string
$.total	integer
$.nextOffset	integer
$.items	array
$.items[]	object
$.items[].path	string
$.items[].contentsCount	null
$.items[].savedDataOmitted	boolean
$.items[].data	object
$.metadata	object
$.metadata.type	string
$.metadata.position	array
$.metadata.position[]	number
$.metadata.source	string
$.metadata.captureName	string
$.metadata.inventory	string
$.metadata.inventoryReadOnly	boolean
$.metadata.inventoryListSaved	boolean
$.sourceUrl	string
$.itemIconsUrl	string

400 Missing/invalid observation ID, item path or pagination; or the observation is not storage.

404 The observation is missing, withdrawn or not public.

503 The Find index, publication catalog or saved inventory could not be read.

Example request

https://api.blackportal.cloud/api/find/objects/19/ef93aca0660f8de015f523e8

Open live response

Parameters

Responses

200 Exact positioned object with capture context and 2D/3D links. Saved objects also expose displayName, customName and savedObject identity/links as structured fields. customName is null without an explicit saved name. Legacy detailsJson is retained for compatibility and full saved attributes.

Response body application/json

Checked October 19, 2026. Recorded response, shortened to one item per array. Values can change. The field list describes this example; use OpenAPI for the full schema.

{
  "key": "saved:19:ef93aca0660f8de015f523e8",
  "observation": {
    "id": -6690154,
    "sourceId": "wdl:19:e135883e144a34c0",
    "sourceName": "+Z Border",
    "family": "wdl",
    "provenance": "Saved capture",
    "kind": "mob",
    "dimension": "overworld",
    "x": 127,
    "y": 70,
    "z": 29999491,
    "blockType": "minecraft:wolf",
    "text": "wolf",
    "firstObservedUtc": "2022-07-11",
    "lastObservedUtc": "2022-07-11",
    "timeKind": "capture",
    "sourceUrl": "https://api.blackportal.cloud/bluemap/render-19-e135883e144a34c0f416a293ce085257dfbb244529830b0872dfea55d7a0441a-v5.24-equipment.1.ui3-p11/web/",
    "captureUrl": "https://api.blackportal.cloud/bluemap/render-19-e135883e144a34c0f416a293ce085257dfbb244529830b0872dfea55d7a0441a-v5.24-equipment.1.ui3-p11/web/",
    "locationId": 904,
    "detailsJson": "{\"savedObject\":{\"renderId\":19,\"id\":\"ef93aca0660f8de015f523e8\",\"generation\":\"render-19-e135883e144a34c0f416a293ce085257dfbb244529830b0872dfea55d7a0441a-v5.24-equipment.1.ui3-p11\",\"label\":\"Wolf\",\"record\":{\"id\":\"ef93aca0660f8de015f523e8\",\"kind\":\"minecraft:wolf\",\"mob\":true,\"customName\":\"Wolf\",\"name\":\"Wolf\",\"position\":[127.4528634733076,70.0,29999491.4844295],\"box\":[[126.57837658192003,69.97,29999491.18642301],[128.2385018377614,70.99875,29999491.816747557]]},\"locationLink\":\"/location/904?view=3d\\u0026render=19\\u0026generation=render-19-e135883e144a34c0f416a293ce085257dfbb244529830b0872dfea55d7a0441a-v5.24-equipment.1.ui3-p11\\u0026object=ef93aca0660f8de015f523e8\\u0026camera=%7B%22mode%22%3A%22free%22%2C%22position%22%3A%5B130.4084392098407%2C71.684375%2C29999494.501585282%5D%2C%22rotation%22%3A-0.7853981633974483%2C%22angle%22%3A1.2951535275786312%2C%22distance%22%3A0%7D\\u0026findX=127\\u0026findY=70\\u0026findZ=29999491\",\"mapLink\":\"/map?dimension=overworld\\u0026x=127\\u0026z=29999491\\u0026zoom=14\\u0026find=true\\u0026render=19\\u0026object=ef93aca0660f8de015f523e8\\u0026generation=render-19-e135883e144a34c0f416a293ce085257dfbb244529830b0872dfea55d7a0441a-v5.24-equipment.1.ui3-p11\",\"galleryLink\":\"/location/904?render=19\\u0026gallery=objects\"},\"savedDetailUrl\":\"https://api.blackportal.cloud/bluemap/render-19-e135883e144a34c0f416a293ce085257dfbb244529830b0872dfea55d7a0441a-v5.24-equipment.1.ui3-p11/web/inspection/atlas/ef93aca0660f8de015f523e8.json\"}",
    "classification": null,
    "displayName": "Wolf",
    "customName": "Wolf",
    "savedObject": {
      "renderId": 19,
      "id": "ef93aca0660f8de015f523e8",
      "generation": "render-19-e135883e144a34c0f416a293ce085257dfbb244529830b0872dfea55d7a0441a-v5.24-equipment.1.ui3-p11",
      "locationLink": "/location/904?view=3d&render=19&generation=render-19-e135883e144a34c0f416a293ce085257dfbb244529830b0872dfea55d7a0441a-v5.24-equipment.1.ui3-p11&object=ef93aca0660f8de015f523e8&camera=%7B%22mode%22%3A%22free%22%2C%22position%22%3A%5B130.4084392098407%2C71.684375%2C29999494.501585282%5D%2C%22rotation%22%3A-0.7853981633974483%2C%22angle%22%3A1.2951535275786312%2C%22distance%22%3A0%7D&findX=127&findY=70&findZ=29999491",
      "mapLink": "/map?dimension=overworld&x=127&z=29999491&zoom=14&find=true&render=19&object=ef93aca0660f8de015f523e8&generation=render-19-e135883e144a34c0f416a293ce085257dfbb244529830b0872dfea55d7a0441a-v5.24-equipment.1.ui3-p11",
      "galleryLink": "/location/904?render=19&gallery=objects",
      "savedDetailUrl": "https://api.blackportal.cloud/bluemap/render-19-e135883e144a34c0f416a293ce085257dfbb244529830b0872dfea55d7a0441a-v5.24-equipment.1.ui3-p11/web/inspection/atlas/ef93aca0660f8de015f523e8.json"
    }
  },
  "matchingObservations": 1,
  "matchingCaptures": 1,
  "distanceBlocks": null,
  "mapCount": 1,
  "mapBounds": null,
  "mapSummary": {
    "x": 127.4528634733076,
    "z": 29999491.4844295,
    "minY": 70,
    "maxY": 70,
    "blocks": [
      {
        "blockType": "minecraft:wolf",
        "count": 1
      }
    ]
  }
}

Fields in this example

Up to three levels. [] means an array item. Types describe this example, not the complete schema.

Field	Example type
$	object
$.key	string
$.observation	object
$.observation.id	integer
$.observation.sourceId	string
$.observation.sourceName	string
$.observation.family	string
$.observation.provenance	string
$.observation.kind	string
$.observation.dimension	string
$.observation.x	integer
$.observation.y	integer
$.observation.z	integer
$.observation.blockType	string
$.observation.text	string
$.observation.firstObservedUtc	string
$.observation.lastObservedUtc	string
$.observation.timeKind	string
$.observation.sourceUrl	string
$.observation.captureUrl	string
$.observation.locationId	integer
$.observation.detailsJson	string
$.observation.classification	null
$.observation.displayName	string
$.observation.customName	string
$.observation.savedObject	object
$.observation.savedObject.renderId	integer
$.observation.savedObject.id	string
$.observation.savedObject.generation	string
$.observation.savedObject.locationLink	string
$.observation.savedObject.mapLink	string
$.observation.savedObject.galleryLink	string
$.observation.savedObject.savedDetailUrl	string
$.matchingObservations	integer
$.matchingCaptures	integer
$.distanceBlocks	null
$.mapCount	integer
$.mapBounds	null
$.mapSummary	object
$.mapSummary.x	number
$.mapSummary.z	number
$.mapSummary.minY	integer
$.mapSummary.maxY	integer
$.mapSummary.blocks	array
$.mapSummary.blocks[]	object

404 The public object or requested generation is unavailable.

Example request

https://api.blackportal.cloud/api/find/source-options

Open live response

Responses

200 Compact source selector metadata. The same waiting, partial and deferred-source gates apply. Use /api/find/sources for products and provenance.

Response body application/json

Checked October 19, 2026. Recorded response, shortened to one item per array. Values can change. The field list describes this example; use OpenAPI for the full schema.

[
  {
    "id": "nocom:overworld",
    "name": "NoCom historical observations",
    "family": "nocom",
    "dimension": "overworld",
    "status": "ready",
    "records": 1174278,
    "completedParts": 1,
    "totalParts": 1,
    "captureDate": null
  }
]

Fields in this example

Up to three levels. [] means an array item. Types describe this example, not the complete schema.

Field	Example type
$	array
$[]	object
$[].id	string
$[].name	string
$[].family	string
$[].dimension	string
$[].status	string
$[].records	integer
$[].completedParts	integer
$[].totalParts	integer
$[].captureDate	null

Example request

https://api.blackportal.cloud/api/renders?locationId=904&limit=1

Open live response

Parameters

Responses

200 Render list.

Response body application/json

Checked October 19, 2026. Recorded response, shortened to one item per array. Values can change. The field list describes this example; use OpenAPI for the full schema.

[
  {
    "renderId": 14,
    "apiUrl": "https://api.blackportal.cloud/api/renders/14",
    "locationId": 904,
    "locationUrl": "https://2b2tatlas.com/location/904",
    "locationRecordUrl": "https://2b2tatlas.com/entities/locations/904/",
    "locationInteractiveUrl": "https://2b2tatlas.com/location/904",
    "locationApiUrl": "https://api.blackportal.cloud/api/locations/904",
    "locationName": "+Z Border",
    "locationX": 0,
    "locationZ": 30000000,
    "dimension": 0,
    "dimensionName": "Overworld",
    "name": "+Z Border",
    "description": "Rendered from Discord-provided Google Drive WDL 1Bid_Abe2ii046b8tLppmKDhg8KzI9N4U; +Z 6-16-2019; occupied tile verified at Atlas location 904.",
    "source": "wdl-ingestion",
    "archiveWarpId": null,
    "archiveWarpApiUrl": null,
    "archiveWarpName": null,
    "isSinglePlayerConcept": false,
    "scale": "1",
    "tileUrlTemplate": "https://blackportal.cloud/AtlasTiles/plus-z-border-2019-06-17/overworld/g-20260820012310-21449bfe/{dn}/{z}/{y}/{x}.png",
    "hasDayNight": true,
    "maxNativeZoom": 9,
    "coordinateScheme": "atlas-sparse-v1",
    "worldDownloadDate": "2019-06-17",
    "worldDownloadUrl": "https://api.blackportal.cloud/api/renders/14/world-download.zip?filename=2b2tAtlas-Z-Border-render-14.zip&sha256=b0897bd288dc1091adb9f67fbe3f6c0909d39b40469c2df3f9be596e774b1201",
    "worldDownloadMetadataUrl": "https://api.blackportal.cloud/api/renders/14/world-download",
    "worldDownloadScope": "preserved-render-source",
    "worldDownloadSha256": "b0897bd288dc1091adb9f67fbe3f6c0909d39b40469c2df3f9be596e774b1201",
    "worldDownloadSource": "Discord-provided Google Drive WDL 1Bid_Abe2ii046b8tLppmKDhg8KzI9N4U; +Z 6-16-2019; occupied tile verified at Atlas location 904",
    "blueMapUrl": "https://api.blackportal.cloud/bluemap/render-14-b0897bd288dc1091adb9f67fbe3f6c0909d39b40469c2df3f9be596e774b1201-v5.24-equipment.1-p11/web/",
    "blueMapPath": "/bluemap/render-14-b0897bd288dc1091adb9f67fbe3f6c0909d39b40469c2df3f9be596e774b1201-v5.24-equipment.1-p11/web/",
    "blueMapProfileVersion": 11,
    "minX": -512,
    "minZ": -288,
    "maxXExclusive": 784,
    "maxZExclusive": 30000048,
    "dateAddedUtc": "2026-08-10T20:13:30.1703278Z"
  }
]

Fields in this example

Up to three levels. [] means an array item. Types describe this example, not the complete schema.

Field	Example type
$	array
$[]	object
$[].renderId	integer
$[].apiUrl	string
$[].locationId	integer
$[].locationUrl	string
$[].locationRecordUrl	string
$[].locationInteractiveUrl	string
$[].locationApiUrl	string
$[].locationName	string
$[].locationX	integer
$[].locationZ	integer
$[].dimension	integer
$[].dimensionName	string
$[].name	string
$[].description	string
$[].source	string
$[].archiveWarpId	null
$[].archiveWarpApiUrl	null
$[].archiveWarpName	null
$[].isSinglePlayerConcept	boolean
$[].scale	string
$[].tileUrlTemplate	string
$[].hasDayNight	boolean
$[].maxNativeZoom	integer
$[].coordinateScheme	string
$[].worldDownloadDate	string
$[].worldDownloadUrl	string
$[].worldDownloadMetadataUrl	string
$[].worldDownloadScope	string
$[].worldDownloadSha256	string
$[].worldDownloadSource	string
$[].blueMapUrl	string
$[].blueMapPath	string
$[].blueMapProfileVersion	integer
$[].minX	integer
$[].minZ	integer
$[].maxXExclusive	integer
$[].maxZExclusive	integer
$[].dateAddedUtc	string

Example request

https://api.blackportal.cloud/api/renders/14

Open live response

Parameters

Responses

200 The render.

Response body application/json

Checked October 19, 2026. Recorded response, shortened to one item per array. Values can change. The field list describes this example; use OpenAPI for the full schema.

{
  "renderId": 14,
  "apiUrl": "https://api.blackportal.cloud/api/renders/14",
  "locationId": 904,
  "locationUrl": "https://2b2tatlas.com/location/904",
  "locationRecordUrl": "https://2b2tatlas.com/entities/locations/904/",
  "locationInteractiveUrl": "https://2b2tatlas.com/location/904",
  "locationApiUrl": "https://api.blackportal.cloud/api/locations/904",
  "locationName": "+Z Border",
  "locationX": 0,
  "locationZ": 30000000,
  "dimension": 0,
  "dimensionName": "Overworld",
  "name": "+Z Border",
  "description": "Rendered from Discord-provided Google Drive WDL 1Bid_Abe2ii046b8tLppmKDhg8KzI9N4U; +Z 6-16-2019; occupied tile verified at Atlas location 904.",
  "source": "wdl-ingestion",
  "archiveWarpId": null,
  "archiveWarpApiUrl": null,
  "archiveWarpName": null,
  "isSinglePlayerConcept": false,
  "scale": "1",
  "tileUrlTemplate": "https://blackportal.cloud/AtlasTiles/plus-z-border-2019-06-17/overworld/g-20260820012310-21449bfe/{dn}/{z}/{y}/{x}.png",
  "hasDayNight": true,
  "maxNativeZoom": 9,
  "coordinateScheme": "atlas-sparse-v1",
  "worldDownloadDate": "2019-06-17",
  "worldDownloadUrl": "https://api.blackportal.cloud/api/renders/14/world-download.zip?filename=2b2tAtlas-Z-Border-render-14.zip&sha256=b0897bd288dc1091adb9f67fbe3f6c0909d39b40469c2df3f9be596e774b1201",
  "worldDownloadMetadataUrl": "https://api.blackportal.cloud/api/renders/14/world-download",
  "worldDownloadScope": "preserved-render-source",
  "worldDownloadSha256": "b0897bd288dc1091adb9f67fbe3f6c0909d39b40469c2df3f9be596e774b1201",
  "worldDownloadSource": "Discord-provided Google Drive WDL 1Bid_Abe2ii046b8tLppmKDhg8KzI9N4U; +Z 6-16-2019; occupied tile verified at Atlas location 904",
  "blueMapUrl": "https://api.blackportal.cloud/bluemap/render-14-b0897bd288dc1091adb9f67fbe3f6c0909d39b40469c2df3f9be596e774b1201-v5.24-equipment.1-p11/web/",
  "blueMapPath": "/bluemap/render-14-b0897bd288dc1091adb9f67fbe3f6c0909d39b40469c2df3f9be596e774b1201-v5.24-equipment.1-p11/web/",
  "blueMapProfileVersion": 11,
  "minX": -512,
  "minZ": -288,
  "maxXExclusive": 784,
  "maxZExclusive": 30000048,
  "dateAddedUtc": "2026-08-10T20:13:30.1703278Z"
}

Fields in this example

Up to three levels. [] means an array item. Types describe this example, not the complete schema.

Field	Example type
$	object
$.renderId	integer
$.apiUrl	string
$.locationId	integer
$.locationUrl	string
$.locationRecordUrl	string
$.locationInteractiveUrl	string
$.locationApiUrl	string
$.locationName	string
$.locationX	integer
$.locationZ	integer
$.dimension	integer
$.dimensionName	string
$.name	string
$.description	string
$.source	string
$.archiveWarpId	null
$.archiveWarpApiUrl	null
$.archiveWarpName	null
$.isSinglePlayerConcept	boolean
$.scale	string
$.tileUrlTemplate	string
$.hasDayNight	boolean
$.maxNativeZoom	integer
$.coordinateScheme	string
$.worldDownloadDate	string
$.worldDownloadUrl	string
$.worldDownloadMetadataUrl	string
$.worldDownloadScope	string
$.worldDownloadSha256	string
$.worldDownloadSource	string
$.blueMapUrl	string
$.blueMapPath	string
$.blueMapProfileVersion	integer
$.minX	integer
$.minZ	integer
$.maxXExclusive	integer
$.maxZExclusive	integer
$.dateAddedUtc	string

404 Not found.

Example request

https://api.blackportal.cloud/api/locations/904/renders

Open live response

Parameters

Responses

200 The location's renders.

Response body application/json

Checked October 19, 2026. Recorded response, shortened to one item per array. Values can change. The field list describes this example; use OpenAPI for the full schema.

[
  {
    "renderId": 14,
    "apiUrl": "https://api.blackportal.cloud/api/renders/14",
    "locationId": 904,
    "locationUrl": "https://2b2tatlas.com/location/904",
    "locationRecordUrl": "https://2b2tatlas.com/entities/locations/904/",
    "locationInteractiveUrl": "https://2b2tatlas.com/location/904",
    "locationApiUrl": "https://api.blackportal.cloud/api/locations/904",
    "locationName": "+Z Border",
    "locationX": 0,
    "locationZ": 30000000,
    "dimension": 0,
    "dimensionName": "Overworld",
    "name": "+Z Border",
    "description": "Rendered from Discord-provided Google Drive WDL 1Bid_Abe2ii046b8tLppmKDhg8KzI9N4U; +Z 6-16-2019; occupied tile verified at Atlas location 904.",
    "source": "wdl-ingestion",
    "archiveWarpId": null,
    "archiveWarpApiUrl": null,
    "archiveWarpName": null,
    "isSinglePlayerConcept": false,
    "scale": "1",
    "tileUrlTemplate": "https://blackportal.cloud/AtlasTiles/plus-z-border-2019-06-17/overworld/g-20260820012310-21449bfe/{dn}/{z}/{y}/{x}.png",
    "hasDayNight": true,
    "maxNativeZoom": 9,
    "coordinateScheme": "atlas-sparse-v1",
    "worldDownloadDate": "2019-06-17",
    "worldDownloadUrl": "https://api.blackportal.cloud/api/renders/14/world-download.zip?filename=2b2tAtlas-Z-Border-render-14.zip&sha256=b0897bd288dc1091adb9f67fbe3f6c0909d39b40469c2df3f9be596e774b1201",
    "worldDownloadMetadataUrl": "https://api.blackportal.cloud/api/renders/14/world-download",
    "worldDownloadScope": "preserved-render-source",
    "worldDownloadSha256": "b0897bd288dc1091adb9f67fbe3f6c0909d39b40469c2df3f9be596e774b1201",
    "worldDownloadSource": "Discord-provided Google Drive WDL 1Bid_Abe2ii046b8tLppmKDhg8KzI9N4U; +Z 6-16-2019; occupied tile verified at Atlas location 904",
    "blueMapUrl": "https://api.blackportal.cloud/bluemap/render-14-b0897bd288dc1091adb9f67fbe3f6c0909d39b40469c2df3f9be596e774b1201-v5.24-equipment.1-p11/web/",
    "blueMapPath": "/bluemap/render-14-b0897bd288dc1091adb9f67fbe3f6c0909d39b40469c2df3f9be596e774b1201-v5.24-equipment.1-p11/web/",
    "blueMapProfileVersion": 11,
    "minX": -512,
    "minZ": -288,
    "maxXExclusive": 784,
    "maxZExclusive": 30000048,
    "dateAddedUtc": "2026-08-10T20:13:30.1703278Z"
  }
]

Fields in this example

Up to three levels. [] means an array item. Types describe this example, not the complete schema.

Field	Example type
$	array
$[]	object
$[].renderId	integer
$[].apiUrl	string
$[].locationId	integer
$[].locationUrl	string
$[].locationRecordUrl	string
$[].locationInteractiveUrl	string
$[].locationApiUrl	string
$[].locationName	string
$[].locationX	integer
$[].locationZ	integer
$[].dimension	integer
$[].dimensionName	string
$[].name	string
$[].description	string
$[].source	string
$[].archiveWarpId	null
$[].archiveWarpApiUrl	null
$[].archiveWarpName	null
$[].isSinglePlayerConcept	boolean
$[].scale	string
$[].tileUrlTemplate	string
$[].hasDayNight	boolean
$[].maxNativeZoom	integer
$[].coordinateScheme	string
$[].worldDownloadDate	string
$[].worldDownloadUrl	string
$[].worldDownloadMetadataUrl	string
$[].worldDownloadScope	string
$[].worldDownloadSha256	string
$[].worldDownloadSource	string
$[].blueMapUrl	string
$[].blueMapPath	string
$[].blueMapProfileVersion	integer
$[].minX	integer
$[].minZ	integer
$[].maxXExclusive	integer
$[].maxZExclusive	integer
$[].dateAddedUtc	string

404 Location not found.

Example request

https://api.blackportal.cloud/api/renders/14/world-download

Open live response

Parameters

Responses

200 World-download metadata.

Response body application/json

Checked October 19, 2026. Recorded response, shortened to one item per array. Values can change. The field list describes this example; use OpenAPI for the full schema.

{
  "warpId": null,
  "warpName": null,
  "renderId": 14,
  "renderName": "+Z Border",
  "isSinglePlayerConcept": false,
  "locationId": 904,
  "locationName": "+Z Border",
  "locationUrl": "https://2b2tatlas.com/location/904",
  "locationRecordUrl": "https://2b2tatlas.com/entities/locations/904/",
  "locationInteractiveUrl": "https://2b2tatlas.com/location/904",
  "locationApiUrl": "https://api.blackportal.cloud/api/locations/904",
  "metadataUrl": "https://api.blackportal.cloud/api/renders/14/world-download",
  "downloadUrl": "https://api.blackportal.cloud/api/renders/14/world-download.zip?filename=2b2tAtlas-Z-Border-render-14.zip&sha256=b0897bd288dc1091adb9f67fbe3f6c0909d39b40469c2df3f9be596e774b1201",
  "fileName": "2b2tAtlas-Z-Border-render-14.zip",
  "contentType": "application/zip",
  "byteLength": 24480600,
  "sha256": "b0897bd288dc1091adb9f67fbe3f6c0909d39b40469c2df3f9be596e774b1201",
  "captureType": "preserved-render-source",
  "worldFormat": "Minecraft Java Edition save",
  "playability": "partial-java-save",
  "isCompleteWorld": false,
  "warning": "This is the preserved source save used to produce an Atlas render, not a complete copy of 2b2t. Its retained area depends on the original community or archival WDL and chunks outside that save may generate as new terrain if opened normally. Use a copy and prevent chunk generation when historical fidelity matters.",
  "dimension": "Overworld",
  "chunkCount": 6520,
  "bounds": {
    "minX": -512,
    "minZ": -288,
    "maxXExclusive": 784,
    "maxZExclusive": 30000048
  },
  "worldDownloadDate": "2019-06-17",
  "captureDatePrecision": "day",
  "source": "Discord-provided Google Drive WDL 1Bid_Abe2ii046b8tLppmKDhg8KzI9N4U; +Z 6-16-2019; occupied tile verified at Atlas location 904",
  "attribution": "Preserved by 2b2t Atlas from the credited community or archival source."
}

Fields in this example

Up to three levels. [] means an array item. Types describe this example, not the complete schema.

Field	Example type
$	object
$.warpId	null
$.warpName	null
$.renderId	integer
$.renderName	string
$.isSinglePlayerConcept	boolean
$.locationId	integer
$.locationName	string
$.locationUrl	string
$.locationRecordUrl	string
$.locationInteractiveUrl	string
$.locationApiUrl	string
$.metadataUrl	string
$.downloadUrl	string
$.fileName	string
$.contentType	string
$.byteLength	integer
$.sha256	string
$.captureType	string
$.worldFormat	string
$.playability	string
$.isCompleteWorld	boolean
$.warning	string
$.dimension	string
$.chunkCount	integer
$.bounds	object
$.bounds.minX	integer
$.bounds.minZ	integer
$.bounds.maxXExclusive	integer
$.bounds.maxZExclusive	integer
$.worldDownloadDate	string
$.captureDatePrecision	string
$.source	string
$.attribution	string

404 No preserved source WDL is linked.

503 Archived object temporarily unavailable.

Parameters

Responses

200 ZIP body (application/zip).

application/zip Binary ZIP archive of the saved world. Follow the download URL returned by metadata; the body is not JSON.

409 Requested SHA-256 was replaced; refresh metadata.

416 Byte range is outside the file.

206 Partial content for a range request.

application/zip Binary ZIP archive of the saved world. Follow the download URL returned by metadata; the body is not JSON.

404 No preserved source WDL is linked.

429 Download concurrency limit reached.

503 Archived object temporarily unavailable.

Example request

https://api.blackportal.cloud/api/renders/38/explore

Open live response

Parameters

Responses

200 Saved capture data.

Response body application/json

Checked October 19, 2026. Recorded response, shortened to one item per array. Values can change. The field list describes this example; use OpenAPI for the full schema.

{
  "renderId": 38,
  "locationId": 5,
  "locationName": "Mu Megabase",
  "dimension": 0,
  "current": {
    "renderId": 38,
    "date": "2020-07-23",
    "name": "Mu Megabase",
    "url": "/bluemap/render-38-287caa5d3b289c2cf4076c00fc2fa7b4a84efaf153ea35c46e6f6cb0adc48ed7-v5.24-equipment.1-p11/web/",
    "generation": "render-38-287caa5d3b289c2cf4076c00fc2fa7b4a84efaf153ea35c46e6f6cb0adc48ed7-v5.24-equipment.1-p11",
    "minX": 5162816,
    "minZ": 10304592,
    "maxXExclusive": 5171232,
    "maxZExclusive": 10322528
  },
  "captures": [
    {
      "renderId": 2225,
      "date": "2020-03-02",
      "name": "Mu Megabase",
      "url": "/bluemap/render-2225-8b9b2fcf6e9d8cf0e434f9f5a03b71a759d64a0e362abdf7372890138fb989a1-v5.24-equipment.1-p11/web/",
      "generation": "render-2225-8b9b2fcf6e9d8cf0e434f9f5a03b71a759d64a0e362abdf7372890138fb989a1-v5.24-equipment.1-p11",
      "minX": 5167056,
      "minZ": 10317904,
      "maxXExclusive": 5169936,
      "maxZExclusive": 10321776
    }
  ]
}

Fields in this example

Up to three levels. [] means an array item. Types describe this example, not the complete schema.

Field	Example type
$	object
$.renderId	integer
$.locationId	integer
$.locationName	string
$.dimension	integer
$.current	object
$.current.renderId	integer
$.current.date	string
$.current.name	string
$.current.url	string
$.current.generation	string
$.current.minX	integer
$.current.minZ	integer
$.current.maxXExclusive	integer
$.current.maxZExclusive	integer
$.captures	array
$.captures[]	object
$.captures[].renderId	integer
$.captures[].date	string
$.captures[].name	string
$.captures[].url	string
$.captures[].generation	string
$.captures[].minX	integer
$.captures[].minZ	integer
$.captures[].maxXExclusive	integer
$.captures[].maxZExclusive	integer

404 Capture, object or artwork unavailable.

Example request

https://api.blackportal.cloud/api/renders/38/explore/objects?category=maps&q=19873&limit=1

Open live response

Parameters

Responses

200 Saved capture data.

Response body application/json

Checked October 19, 2026. Recorded response, shortened to one item per array. Values can change. The field list describes this example; use OpenAPI for the full schema.

{
  "status": "ready",
  "generation": "render-38-287caa5d3b289c2cf4076c00fc2fa7b4a84efaf153ea35c46e6f6cb0adc48ed7-v5.24-equipment.1-p11",
  "total": 1,
  "offset": 0,
  "limit": 1,
  "results": [
    {
      "id": "2789333f29220d7f81f9b0b1",
      "category": "maps",
      "label": "Map #19873",
      "excerpt": "Saved map",
      "record": {
        "id": "2789333f29220d7f81f9b0b1",
        "kind": "minecraft:filled_map",
        "savedMap": true,
        "mapId": 19873,
        "depictedDimension": "overworld",
        "position": null,
        "box": null,
        "placementEvidence": null,
        "placementDimension": null,
        "placementObject": null,
        "savedFramePositions": []
      },
      "mapId": 19873
    }
  ]
}

Fields in this example

Up to three levels. [] means an array item. Types describe this example, not the complete schema.

Field	Example type
$	object
$.status	string
$.generation	string
$.total	integer
$.offset	integer
$.limit	integer
$.results	array
$.results[]	object
$.results[].id	string
$.results[].category	string
$.results[].label	string
$.results[].excerpt	string
$.results[].record	object
$.results[].mapId	integer

404 Capture, object or artwork unavailable.

202 Index preparation is running. Retry after a short delay.

400 Invalid query parameters.

503 Temporarily unavailable; retry later.

409 Capture generation changed. Refresh metadata.

Example request

https://api.blackportal.cloud/api/renders/38/explore/objects/2789333f29220d7f81f9b0b1

Open live response

Parameters

Responses

200 Saved capture data.

Response body application/json

Checked October 19, 2026. Recorded response, shortened to one item per array. Values can change. The field list describes this example; use OpenAPI for the full schema.

{
  "id": "2789333f29220d7f81f9b0b1",
  "kind": "minecraft:filled_map",
  "savedMap": true,
  "mapId": 19873,
  "depictedDimension": "overworld",
  "position": null,
  "box": null,
  "placementEvidence": null,
  "placementDimension": null,
  "placementObject": null,
  "savedFramePositions": []
}

Fields in this example

Up to three levels. [] means an array item. Types describe this example, not the complete schema.

Field	Example type
$	object
$.id	string
$.kind	string
$.savedMap	boolean
$.mapId	integer
$.depictedDimension	string
$.position	null
$.box	null
$.placementEvidence	null
$.placementDimension	null
$.placementObject	null
$.savedFramePositions	array

404 Capture, object or artwork unavailable.

202 Index preparation is running. Retry after a short delay.

400 Invalid query parameters.

503 Temporarily unavailable; retry later.

409 Capture generation changed. Refresh metadata.

Example request

https://api.blackportal.cloud/api/renders/38/explore/objects/2789333f29220d7f81f9b0b1/art.png

Open live response

Parameters

Responses

200 PNG artwork.

image/png Binary PNG artwork preview for the saved object and generation; the body is not JSON.

404 Capture, object or artwork unavailable.

202 Index preparation is running. Retry after a short delay.

400 Invalid query parameters.

503 Temporarily unavailable; retry later.

Example request

https://api.blackportal.cloud/api/locations

Open live response

Responses

200 Location list.

Response body application/json

Checked October 19, 2026. Recorded response, shortened to one item per array. Values can change. The field list describes this example; use OpenAPI for the full schema.

[
  {
    "rowid": 1,
    "canonicalUrl": "https://2b2tatlas.com/location/1",
    "recordUrl": "https://2b2tatlas.com/entities/locations/1/",
    "interactiveUrl": "https://2b2tatlas.com/location/1",
    "apiUrl": "https://api.blackportal.cloud/api/locations/1",
    "locationUuid": "011880c6-3e3d-11eb-9990-0200516ae545",
    "name": "Chunk Bridge, Autism Memorial",
    "description": "",
    "tags": null,
    "dimension": 0,
    "dimensionName": "Overworld",
    "x": 22928,
    "y": 64,
    "z": 6224,
    "wiki": null,
    "videoUrl": null,
    "endDimension": false,
    "dateAddedUtc": "2020-12-14T18:48:49",
    "dateAddedInstantUtc": null,
    "dateAddedTimezoneKnown": false,
    "modifiedUtc": "2026-08-30T18:00:00-06:00",
    "warps": [
      {
        "id": 100,
        "apiUrl": "https://api.blackportal.cloud/api/warps/100",
        "warpUuid": "94be3ad8-8167-11eb-b0ae-0200516ae545",
        "locationUuidFk": "011880c6-3e3d-11eb-9990-0200516ae545",
        "locationRowid": 1,
        "name": "Chunk_Bridge,_Autism_Memorial",
        "isSinglePlayerConcept": false,
        "timeAdded": "2021-03-10T06:12:24",
        "archiveSha256": null,
        "worldDownloadUrl": null,
        "worldDownloadMetadataUrl": null,
        "worldDownloadScope": null,
        "worldDownloadDate": null,
        "captureDatePrecision": null,
        "source": null,
        "archiveX": null,
        "archiveY": null,
        "archiveZ": null
      }
    ],
    "attachments": [],
    "renders": [],
    "groups": [],
    "groupNames": "",
    "warpCount": 1,
    "attachmentCount": 0,
    "renderCount": 0,
    "blueMapReadyRenderCount": 0,
    "totalRelatedItems": 1,
    "relatedContentSummary": "1 warp"
  }
]

Fields in this example

Up to three levels. [] means an array item. Types describe this example, not the complete schema.

Field	Example type
$	array
$[]	object
$[].rowid	integer
$[].canonicalUrl	string
$[].recordUrl	string
$[].interactiveUrl	string
$[].apiUrl	string
$[].locationUuid	string
$[].name	string
$[].description	string
$[].tags	null
$[].dimension	integer
$[].dimensionName	string
$[].x	integer
$[].y	integer
$[].z	integer
$[].wiki	null
$[].videoUrl	null
$[].endDimension	boolean
$[].dateAddedUtc	string
$[].dateAddedInstantUtc	null
$[].dateAddedTimezoneKnown	boolean
$[].modifiedUtc	string
$[].warps	array
$[].warps[]	object
$[].attachments	array
$[].renders	array
$[].groups	array
$[].groupNames	string
$[].warpCount	integer
$[].attachmentCount	integer
$[].renderCount	integer
$[].blueMapReadyRenderCount	integer
$[].totalRelatedItems	integer
$[].relatedContentSummary	string

Example request

https://api.blackportal.cloud/api/locations/map

Open live response

Responses

200 Array ordered by rowid. Includes coordinates, description, tags, wiki, videoUrl, groups (groupId, groupName, role), warps with worldDownloadDate, and public renders. Omits attachments, download provenance and 3D catalogs; fetch /api/locations/{id} for full details.

Response body application/json

Checked October 19, 2026. Recorded response, shortened to one item per array. Values can change. The field list describes this example; use OpenAPI for the full schema.

[
  {
    "rowid": 1,
    "name": "Chunk Bridge, Autism Memorial",
    "description": "",
    "tags": null,
    "wiki": null,
    "videoUrl": null,
    "x": 22928,
    "y": 64,
    "z": 6224,
    "dimension": 0,
    "groups": [],
    "warps": [
      {
        "id": 100,
        "name": "Chunk_Bridge,_Autism_Memorial",
        "worldDownloadDate": null
      }
    ],
    "renders": []
  }
]

Fields in this example

Up to three levels. [] means an array item. Types describe this example, not the complete schema.

Field	Example type
$	array
$[]	object
$[].rowid	integer
$[].name	string
$[].description	string
$[].tags	null
$[].wiki	null
$[].videoUrl	null
$[].x	integer
$[].y	integer
$[].z	integer
$[].dimension	integer
$[].groups	array
$[].warps	array
$[].warps[]	object
$[].renders	array

Example request

https://api.blackportal.cloud/api/locations/aliases

Open live response

Responses

200 Alias mappings ordered by oldId: oldId, oldUuid, canonicalId, canonicalUrl, recordUrl and interactiveUrl.

Response body application/json

Checked October 19, 2026. Recorded response, shortened to one item per array. Values can change. The field list describes this example; use OpenAPI for the full schema.

[
  {
    "oldId": 203,
    "oldUuid": "fadd5437-ab7f-4ed4-89e0-007d8554630e",
    "canonicalId": 265,
    "canonicalUrl": "https://2b2tatlas.com/location/265",
    "recordUrl": "https://2b2tatlas.com/entities/locations/265/",
    "interactiveUrl": "https://2b2tatlas.com/location/265"
  }
]

Fields in this example

Up to three levels. [] means an array item. Types describe this example, not the complete schema.

Field	Example type
$	array
$[]	object
$[].oldId	integer
$[].oldUuid	string
$[].canonicalId	integer
$[].canonicalUrl	string
$[].recordUrl	string
$[].interactiveUrl	string

Example request

https://api.blackportal.cloud/api/locations/904

Open live response

Parameters

Responses

200 The location.

Response body application/json

Checked October 19, 2026. Recorded response, shortened to one item per array. Values can change. The field list describes this example; use OpenAPI for the full schema.

{
  "rowid": 904,
  "canonicalUrl": "https://2b2tatlas.com/location/904",
  "recordUrl": "https://2b2tatlas.com/entities/locations/904/",
  "interactiveUrl": "https://2b2tatlas.com/location/904",
  "apiUrl": "https://api.blackportal.cloud/api/locations/904",
  "locationUuid": "d14c3617-8d2c-42e7-9c2a-4952006eb5b6",
  "name": "+Z Border",
  "description": "Also known as The Southern World Border, this is the southern Overworld world-border settlement, near Z 30,000,000 and the end of the Southern Canal. The +Z Digging Group reached this border on June 9, 2017 after extending the Nether route to Z 3,750,000. Preserved downloads and media show the settlement at several later dates.\n\nThis location includes Overworld and Nether saved worlds. The Nether capture is archived as Nether +Z 3.75M Milestone, at X 0, Z 3,749,973. The Archive preserves captures in both dimensions dated 2018-02-26.",
  "tags": "",
  "dimension": 0,
  "dimensionName": "Overworld",
  "x": 0,
  "y": 64,
  "z": 30000000,
  "wiki": "",
  "videoUrl": "",
  "endDimension": false,
  "dateAddedUtc": "2020-08-17T22:26:48",
  "dateAddedInstantUtc": null,
  "dateAddedTimezoneKnown": false,
  "modifiedUtc": "2026-10-16T16:56:13.663344-06:00",
  "warps": [
    {
      "id": 1269,
      "apiUrl": "https://api.blackportal.cloud/api/warps/1269",
      "warpUuid": "87e6671a-02e7-477f-91f3-385d9dee5e9f",
      "locationUuidFk": "d14c3617-8d2c-42e7-9c2a-4952006eb5b6",
      "locationRowid": 904,
      "name": "z3.75m_2018-02-26@Nether",
      "isSinglePlayerConcept": false,
      "timeAdded": "2026-09-02T08:16:43.4064212-06:00",
      "archiveSha256": "c5248c4ac163e1ad4a844fb9adfa668b1ce51d79c2058c02302d110c03938b96",
      "worldDownloadUrl": "https://api.blackportal.cloud/api/warps/1269/world-download.zip?filename=2b2tAtlas-Z-Border-warp-1269.zip&sha256=c5248c4ac163e1ad4a844fb9adfa668b1ce51d79c2058c02302d110c03938b96",
      "worldDownloadMetadataUrl": "https://api.blackportal.cloud/api/warps/1269/world-download",
      "worldDownloadScope": "bounded-footprint",
      "worldDownloadDate": "2018-02-26",
      "captureDatePrecision": "day",
      "source": "The Archive automated sync",
      "archiveX": -0.42,
      "archiveY": 120,
      "archiveZ": 3749973
    }
  ],
  "attachments": [
    {
      "id": 63,
      "apiUrl": "https://api.blackportal.cloud/api/attachments/63",
      "locationRowid": 904,
      "fileName": "+Z world border — 6K overview",
      "path": "https://blackportal.cloud/2b2t/MiscRenders/%2BZ%20Border/Z%2BBorderRender6k.png",
      "mediaType": "Image",
      "thumbnailPath": "https://blackportal.cloud/2b2t/MiscRenders/LocationAttachments/z-border/z-border-6k.webp",
      "sourceUrl": "https://blackportal.cloud/2b2t/MiscRenders/%2BZ%20Border/",
      "caption": "In-game 6K overview render of the developed +Z Overworld world-border area.",
      "attribution": "2b2t Atlas operator archive; original retained on BlackPortal.",
      "dateAddedUtc": "2026-09-05T05:58:05.8654552Z"
    }
  ],
  "renders": [
    {
      "id": 14,
      "apiUrl": "https://api.blackportal.cloud/api/renders/14",
      "locationRowid": 904,
      "name": "+Z Border",
      "description": "Rendered from Discord-provided Google Drive WDL 1Bid_Abe2ii046b8tLppmKDhg8KzI9N4U; +Z 6-16-2019; occupied tile verified at Atlas location 904.",
      "source": "wdl-ingestion",
      "archiveWarpId": null,
      "archiveWarp": null,
      "isSinglePlayerConcept": false,
      "dimension": 0,
      "scale": "1",
      "tilesPath": "https://blackportal.cloud/AtlasTiles/plus-z-border-2019-06-17/overworld/g-20260820012310-21449bfe/{dn}/{z}/{y}/{x}.png",
      "hasDayNight": true,
      "previewImagePath": null,
      "worldDownloadDate": "2019-06-17",
      "captureDatePrecision": "day",
      "worldDownloadUrl": "https://api.blackportal.cloud/api/renders/14/world-download.zip?filename=2b2tAtlas-Z-Border-render-14.zip&sha256=b0897bd288dc1091adb9f67fbe3f6c0909d39b40469c2df3f9be596e774b1201",
      "worldDownloadMetadataUrl": "https://api.blackportal.cloud/api/renders/14/world-download",
      "worldDownloadScope": "preserved-render-source",
      "worldDownloadSha256": "b0897bd288dc1091adb9f67fbe3f6c0909d39b40469c2df3f9be596e774b1201",
      "worldDownloadSource": "Discord-provided Google Drive WDL 1Bid_Abe2ii046b8tLppmKDhg8KzI9N4U; +Z 6-16-2019; occupied tile verified at Atlas location 904",
      "blueMapUrl": "https://api.blackportal.cloud/bluemap/render-14-b0897bd288dc1091adb9f67fbe3f6c0909d39b40469c2df3f9be596e774b1201-v5.24-equipment.1-p11/web/",
      "blueMapPath": "/bluemap/render-14-b0897bd288dc1091adb9f67fbe3f6c0909d39b40469c2df3f9be596e774b1201-v5.24-equipment.1-p11/web/",
      "blueMapProfileVersion": 11,
      "minX": -512,
      "minZ": -288,
      "maxXExclusive": 784,
      "maxZExclusive": 30000048,
      "maxNativeZoom": 9,
      "coordinateScheme": "atlas-sparse-v1",
      "dateAddedUtc": "2026-08-10T20:13:30.1703278Z",
      "archiveWarps": []
    }
  ],
  "groups": [
    {
      "groupId": 19,
      "groupUrl": "https://2b2tatlas.com/group/19",
      "groupRecordUrl": "https://2b2tatlas.com/entities/groups/19/",
      "groupInteractiveUrl": "https://2b2tatlas.com/group/19",
      "groupApiUrl": "https://api.blackportal.cloud/api/groups/19",
      "groupName": "+Z Digging Group",
      "role": "Builder",
      "color": "#2986cc",
      "logoUrl": "https://blackportal.cloud/2b2t/MiscRenders/GroupLogos/plus-z-world-border-banner-82f485d0ecd6.png"
    }
  ],
  "groupNames": "+Z Digging Group",
  "warpCount": 3,
  "attachmentCount": 33,
  "renderCount": 10,
  "blueMapReadyRenderCount": 10,
  "totalRelatedItems": 46,
  "relatedContentSummary": "3 warps, 33 files, 10 renders"
}

Fields in this example

Up to three levels. [] means an array item. Types describe this example, not the complete schema.

Field	Example type
$	object
$.rowid	integer
$.canonicalUrl	string
$.recordUrl	string
$.interactiveUrl	string
$.apiUrl	string
$.locationUuid	string
$.name	string
$.description	string
$.tags	string
$.dimension	integer
$.dimensionName	string
$.x	integer
$.y	integer
$.z	integer
$.wiki	string
$.videoUrl	string
$.endDimension	boolean
$.dateAddedUtc	string
$.dateAddedInstantUtc	null
$.dateAddedTimezoneKnown	boolean
$.modifiedUtc	string
$.warps	array
$.warps[]	object
$.warps[].id	integer
$.warps[].apiUrl	string
$.warps[].warpUuid	string
$.warps[].locationUuidFk	string
$.warps[].locationRowid	integer
$.warps[].name	string
$.warps[].isSinglePlayerConcept	boolean
$.warps[].timeAdded	string
$.warps[].archiveSha256	string
$.warps[].worldDownloadUrl	string
$.warps[].worldDownloadMetadataUrl	string
$.warps[].worldDownloadScope	string
$.warps[].worldDownloadDate	string
$.warps[].captureDatePrecision	string
$.warps[].source	string
$.warps[].archiveX	number
$.warps[].archiveY	integer
$.warps[].archiveZ	integer
$.attachments	array
$.attachments[]	object
$.attachments[].id	integer
$.attachments[].apiUrl	string
$.attachments[].locationRowid	integer
$.attachments[].fileName	string
$.attachments[].path	string
$.attachments[].mediaType	string
$.attachments[].thumbnailPath	string
$.attachments[].sourceUrl	string
$.attachments[].caption	string
$.attachments[].attribution	string
$.attachments[].dateAddedUtc	string
$.renders	array
$.renders[]	object
$.renders[].id	integer
$.renders[].apiUrl	string
$.renders[].locationRowid	integer
$.renders[].name	string
$.renders[].description	string
$.renders[].source	string
$.renders[].archiveWarpId	null
$.renders[].archiveWarp	null
$.renders[].isSinglePlayerConcept	boolean
$.renders[].dimension	integer
$.renders[].scale	string
$.renders[].tilesPath	string
$.renders[].hasDayNight	boolean
$.renders[].previewImagePath	null
$.renders[].worldDownloadDate	string
$.renders[].captureDatePrecision	string
$.renders[].worldDownloadUrl	string
$.renders[].worldDownloadMetadataUrl	string
$.renders[].worldDownloadScope	string
$.renders[].worldDownloadSha256	string
$.renders[].worldDownloadSource	string
$.renders[].blueMapUrl	string
$.renders[].blueMapPath	string
$.renders[].blueMapProfileVersion	integer
$.renders[].minX	integer
$.renders[].minZ	integer
$.renders[].maxXExclusive	integer
$.renders[].maxZExclusive	integer
$.renders[].maxNativeZoom	integer
$.renders[].coordinateScheme	string
$.renders[].dateAddedUtc	string
$.renders[].archiveWarps	array
$.groups	array
$.groups[]	object
$.groups[].groupId	integer
$.groups[].groupUrl	string
$.groups[].groupRecordUrl	string
$.groups[].groupInteractiveUrl	string
$.groups[].groupApiUrl	string
$.groups[].groupName	string
$.groups[].role	string
$.groups[].color	string
$.groups[].logoUrl	string
$.groupNames	string
$.warpCount	integer
$.attachmentCount	integer
$.renderCount	integer
$.blueMapReadyRenderCount	integer
$.totalRelatedItems	integer
$.relatedContentSummary	string

301 Merged ID redirects to its canonical location.

404 Not found.

Example request

https://api.blackportal.cloud/api/locations/directory

Open live response

Responses

200 Compact directory rows with searchable descriptions, groups, exact public counts and preferred actions. Cached for 30 seconds; full evidence remains on location detail.

Response body application/json

Checked October 19, 2026. Recorded response, shortened to one item per array. Values can change. The field list describes this example; use OpenAPI for the full schema.

[
  {
    "rowid": 1,
    "name": "Chunk Bridge, Autism Memorial",
    "description": "",
    "dimension": 0,
    "dimensionName": "Overworld",
    "x": 22928,
    "y": 64,
    "z": 6224,
    "dateAddedUtc": "2020-12-14T18:48:49",
    "groups": [],
    "groupNames": "",
    "warpCount": 1,
    "attachmentCount": 0,
    "renderCount": 0,
    "blueMapReadyRenderCount": 0,
    "totalRelatedItems": 1,
    "relatedContentSummary": "1 warp",
    "mapDimension": 0,
    "preferredWarp": {
      "id": 100,
      "name": "Chunk_Bridge,_Autism_Memorial"
    },
    "download": null
  }
]

Fields in this example

Up to three levels. [] means an array item. Types describe this example, not the complete schema.

Field	Example type
$	array
$[]	object
$[].rowid	integer
$[].name	string
$[].description	string
$[].dimension	integer
$[].dimensionName	string
$[].x	integer
$[].y	integer
$[].z	integer
$[].dateAddedUtc	string
$[].groups	array
$[].groupNames	string
$[].warpCount	integer
$[].attachmentCount	integer
$[].renderCount	integer
$[].blueMapReadyRenderCount	integer
$[].totalRelatedItems	integer
$[].relatedContentSummary	string
$[].mapDimension	integer
$[].preferredWarp	object
$[].preferredWarp.id	integer
$[].preferredWarp.name	string
$[].download	null

Example request

https://api.blackportal.cloud/api/warps?limit=1

Open live response

Parameters

Responses

200 Warp records.

Response body application/json

Checked October 19, 2026. Recorded response, shortened to one item per array. Values can change. The field list describes this example; use OpenAPI for the full schema.

[
  {
    "locationName": "Rop's Tower Base",
    "dimension": 0,
    "locationUrl": "https://2b2tatlas.com/location/277",
    "locationRecordUrl": "https://2b2tatlas.com/entities/locations/277/",
    "locationInteractiveUrl": "https://2b2tatlas.com/location/277",
    "locationApiUrl": "https://api.blackportal.cloud/api/locations/277",
    "id": 1,
    "apiUrl": "https://api.blackportal.cloud/api/warps/1",
    "warpUuid": "cfdf3d6a-8121-11eb-b0ae-0200516ae545",
    "locationUuidFk": "3a6034c4-8121-11eb-b0ae-0200516ae545",
    "locationRowid": 277,
    "name": "ROP_Tower_base_2015-12-12",
    "isSinglePlayerConcept": false,
    "timeAdded": "2021-03-09T21:52:58",
    "archiveSha256": "4aed78c85f4bd0eed05da9c1fec37e6204c49fd41a943467c8b8191b8a9720ca",
    "worldDownloadUrl": "https://api.blackportal.cloud/api/warps/1/world-download.zip?filename=2b2tAtlas-Rop-s-Tower-Base-warp-1.zip&sha256=4aed78c85f4bd0eed05da9c1fec37e6204c49fd41a943467c8b8191b8a9720ca",
    "worldDownloadMetadataUrl": "https://api.blackportal.cloud/api/warps/1/world-download",
    "worldDownloadScope": "bounded-footprint",
    "worldDownloadDate": null,
    "captureDatePrecision": null,
    "source": "The Archive automated sync",
    "archiveX": 23086.58,
    "archiveY": 76.0408,
    "archiveZ": 23833.04
  }
]

Fields in this example

Up to three levels. [] means an array item. Types describe this example, not the complete schema.

Field	Example type
$	array
$[]	object
$[].locationName	string
$[].dimension	integer
$[].locationUrl	string
$[].locationRecordUrl	string
$[].locationInteractiveUrl	string
$[].locationApiUrl	string
$[].id	integer
$[].apiUrl	string
$[].warpUuid	string
$[].locationUuidFk	string
$[].locationRowid	integer
$[].name	string
$[].isSinglePlayerConcept	boolean
$[].timeAdded	string
$[].archiveSha256	string
$[].worldDownloadUrl	string
$[].worldDownloadMetadataUrl	string
$[].worldDownloadScope	string
$[].worldDownloadDate	null
$[].captureDatePrecision	null
$[].source	string
$[].archiveX	number
$[].archiveY	number
$[].archiveZ	number

Example request

https://api.blackportal.cloud/api/warps/5

Open live response

Parameters

Responses

200 The warp.

Response body application/json

Checked October 19, 2026. Recorded response, shortened to one item per array. Values can change. The field list describes this example; use OpenAPI for the full schema.

{
  "locationName": "Havanna",
  "dimension": 0,
  "locationUrl": "https://2b2tatlas.com/location/917",
  "locationRecordUrl": "https://2b2tatlas.com/entities/locations/917/",
  "locationInteractiveUrl": "https://2b2tatlas.com/location/917",
  "locationApiUrl": "https://api.blackportal.cloud/api/locations/917",
  "id": 5,
  "apiUrl": "https://api.blackportal.cloud/api/warps/5",
  "warpUuid": "eb3b01ee-8122-11eb-b0ae-0200516ae545",
  "locationUuidFk": "c1452098-8122-11eb-b0ae-0200516ae545",
  "locationRowid": 917,
  "name": "Havanna_2021-02-25@Infinity_Incursion",
  "isSinglePlayerConcept": false,
  "timeAdded": "2021-03-09T22:00:54",
  "archiveSha256": "0a19d70b87cf424f716e294b90879c10622996ad5e3dd44029f93e6230973039",
  "worldDownloadUrl": "https://api.blackportal.cloud/api/warps/5/world-download.zip?filename=2b2tAtlas-Havanna-warp-5.zip&sha256=0a19d70b87cf424f716e294b90879c10622996ad5e3dd44029f93e6230973039",
  "worldDownloadMetadataUrl": "https://api.blackportal.cloud/api/warps/5/world-download",
  "worldDownloadScope": "bounded-footprint",
  "worldDownloadDate": "2021-02-25",
  "captureDatePrecision": "day",
  "source": "The Archive automated sync",
  "archiveX": -316553.49,
  "archiveY": 65.86,
  "archiveZ": 203747.53
}

Fields in this example

Up to three levels. [] means an array item. Types describe this example, not the complete schema.

Field	Example type
$	object
$.locationName	string
$.dimension	integer
$.locationUrl	string
$.locationRecordUrl	string
$.locationInteractiveUrl	string
$.locationApiUrl	string
$.id	integer
$.apiUrl	string
$.warpUuid	string
$.locationUuidFk	string
$.locationRowid	integer
$.name	string
$.isSinglePlayerConcept	boolean
$.timeAdded	string
$.archiveSha256	string
$.worldDownloadUrl	string
$.worldDownloadMetadataUrl	string
$.worldDownloadScope	string
$.worldDownloadDate	string
$.captureDatePrecision	string
$.source	string
$.archiveX	number
$.archiveY	number
$.archiveZ	number

404 Not found.

Example request

https://api.blackportal.cloud/api/warps/5/world-download

Open live response

Parameters

Responses

200 World-download metadata.

Response body application/json

Checked October 19, 2026. Recorded response, shortened to one item per array. Values can change. The field list describes this example; use OpenAPI for the full schema.

{
  "warpId": 5,
  "warpName": "Havanna_2021-02-25@Infinity_Incursion",
  "renderId": 1657,
  "renderName": "Havanna",
  "isSinglePlayerConcept": false,
  "locationId": 917,
  "locationName": "Havanna",
  "locationUrl": "https://2b2tatlas.com/location/917",
  "locationRecordUrl": "https://2b2tatlas.com/entities/locations/917/",
  "locationInteractiveUrl": "https://2b2tatlas.com/location/917",
  "locationApiUrl": "https://api.blackportal.cloud/api/locations/917",
  "metadataUrl": "https://api.blackportal.cloud/api/warps/5/world-download",
  "downloadUrl": "https://api.blackportal.cloud/api/warps/5/world-download.zip?filename=2b2tAtlas-Havanna-warp-5.zip&sha256=0a19d70b87cf424f716e294b90879c10622996ad5e3dd44029f93e6230973039",
  "fileName": "2b2tAtlas-Havanna-warp-5.zip",
  "contentType": "application/zip",
  "byteLength": 2623413,
  "sha256": "0a19d70b87cf424f716e294b90879c10622996ad5e3dd44029f93e6230973039",
  "captureType": "bounded-footprint",
  "worldFormat": "Minecraft Java Edition save",
  "playability": "partial-java-save",
  "isCompleteWorld": false,
  "warning": "This is a bounded historical snapshot, not a complete 2b2t world. Chunks outside the retained footprint are absent and Minecraft may generate new terrain if opened normally. Use a copy and prevent chunk generation when historical fidelity matters.",
  "dimension": "Overworld",
  "chunkCount": 630,
  "bounds": {
    "minX": -316800,
    "minZ": 203536,
    "maxXExclusive": -316368,
    "maxZExclusive": 204048
  },
  "worldDownloadDate": "2021-02-25",
  "captureDatePrecision": "day",
  "source": "The Archive automated sync",
  "attribution": "Captured from The Archive museum server by 2b2t Atlas."
}

Fields in this example

Up to three levels. [] means an array item. Types describe this example, not the complete schema.

Field	Example type
$	object
$.warpId	integer
$.warpName	string
$.renderId	integer
$.renderName	string
$.isSinglePlayerConcept	boolean
$.locationId	integer
$.locationName	string
$.locationUrl	string
$.locationRecordUrl	string
$.locationInteractiveUrl	string
$.locationApiUrl	string
$.metadataUrl	string
$.downloadUrl	string
$.fileName	string
$.contentType	string
$.byteLength	integer
$.sha256	string
$.captureType	string
$.worldFormat	string
$.playability	string
$.isCompleteWorld	boolean
$.warning	string
$.dimension	string
$.chunkCount	integer
$.bounds	object
$.bounds.minX	integer
$.bounds.minZ	integer
$.bounds.maxXExclusive	integer
$.bounds.maxZExclusive	integer
$.worldDownloadDate	string
$.captureDatePrecision	string
$.source	string
$.attribution	string

404 No collector WDL is linked.

503 Archived object temporarily unavailable.

Parameters

Responses

200 ZIP body (application/zip).

application/zip Binary ZIP archive of the saved world. Follow the download URL returned by metadata; the body is not JSON.

409 Requested SHA-256 was replaced; refresh metadata.

416 Byte range is outside the file.

206 Partial content for a range request.

application/zip Binary ZIP archive of the saved world. Follow the download URL returned by metadata; the body is not JSON.

404 No collector WDL is linked.

429 Download concurrency limit reached.

503 Archived object temporarily unavailable.

Example request

https://api.blackportal.cloud/api/attachments?limit=1

Open live response

Parameters

Responses

200 Attachment records.

Response body application/json

Checked October 19, 2026. Recorded response, shortened to one item per array. Values can change. The field list describes this example; use OpenAPI for the full schema.

[
  {
    "locationName": "Ravendel",
    "dimension": 0,
    "locationUrl": "https://2b2tatlas.com/location/242",
    "locationRecordUrl": "https://2b2tatlas.com/entities/locations/242/",
    "locationInteractiveUrl": "https://2b2tatlas.com/location/242",
    "locationApiUrl": "https://api.blackportal.cloud/api/locations/242",
    "id": 1,
    "apiUrl": "https://api.blackportal.cloud/api/attachments/1",
    "locationRowid": 242,
    "fileName": "Ravendel - Wiki - Ravendel",
    "path": "https://2b2t.miraheze.org/wiki/Ravendel",
    "mediaType": null,
    "thumbnailPath": null,
    "sourceUrl": null,
    "caption": null,
    "attribution": null,
    "dateAddedUtc": "2025-09-01T23:11:47Z"
  }
]

Fields in this example

Up to three levels. [] means an array item. Types describe this example, not the complete schema.

Field	Example type
$	array
$[]	object
$[].locationName	string
$[].dimension	integer
$[].locationUrl	string
$[].locationRecordUrl	string
$[].locationInteractiveUrl	string
$[].locationApiUrl	string
$[].id	integer
$[].apiUrl	string
$[].locationRowid	integer
$[].fileName	string
$[].path	string
$[].mediaType	null
$[].thumbnailPath	null
$[].sourceUrl	null
$[].caption	null
$[].attribution	null
$[].dateAddedUtc	string

Example request

https://api.blackportal.cloud/api/attachments/1

Open live response

Parameters

Responses

200 The attachment.

Response body application/json

Checked October 19, 2026. Recorded response, shortened to one item per array. Values can change. The field list describes this example; use OpenAPI for the full schema.

{
  "locationName": "Ravendel",
  "dimension": 0,
  "locationUrl": "https://2b2tatlas.com/location/242",
  "locationRecordUrl": "https://2b2tatlas.com/entities/locations/242/",
  "locationInteractiveUrl": "https://2b2tatlas.com/location/242",
  "locationApiUrl": "https://api.blackportal.cloud/api/locations/242",
  "id": 1,
  "apiUrl": "https://api.blackportal.cloud/api/attachments/1",
  "locationRowid": 242,
  "fileName": "Ravendel - Wiki - Ravendel",
  "path": "https://2b2t.miraheze.org/wiki/Ravendel",
  "mediaType": null,
  "thumbnailPath": null,
  "sourceUrl": null,
  "caption": null,
  "attribution": null,
  "dateAddedUtc": "2025-09-01T23:11:47Z"
}

Fields in this example

Up to three levels. [] means an array item. Types describe this example, not the complete schema.

Field	Example type
$	object
$.locationName	string
$.dimension	integer
$.locationUrl	string
$.locationRecordUrl	string
$.locationInteractiveUrl	string
$.locationApiUrl	string
$.id	integer
$.apiUrl	string
$.locationRowid	integer
$.fileName	string
$.path	string
$.mediaType	null
$.thumbnailPath	null
$.sourceUrl	null
$.caption	null
$.attribution	null
$.dateAddedUtc	string

404 Not found.

Example request

https://api.blackportal.cloud/api/highways

Open live response

Responses

200 Highway list.

Response body application/json

Checked October 19, 2026. Recorded response, shortened to one item per array. Values can change. The field list describes this example; use OpenAPI for the full schema.

[
  {
    "pageUrl": "https://2b2tatlas.com/highway/1",
    "canonicalUrl": "https://2b2tatlas.com/highway/1",
    "interactiveUrl": "https://2b2tatlas.com/highway/1",
    "recordUrl": "https://2b2tatlas.com/entities/highways/1/",
    "attachments": [
      {
        "id": 1,
        "apiUrl": "https://api.blackportal.cloud/api/highways/1/attachments/1",
        "locationRowid": 0,
        "fileName": "MEG project roundup (2023)",
        "path": "https://www.reddit.com/r/2b2t/comments/12sw870/",
        "mediaType": "Link",
        "thumbnailPath": null,
        "sourceUrl": "https://www.reddit.com/r/2b2t/comments/12sw870/",
        "caption": "Dated construction milestones, dimensions, builder credits and photographs for named axis, diagonal and ring-road projects.",
        "attribution": "Motorway Extension Gurus (MEG)",
        "dateAddedUtc": "2026-09-18T01:40:47.4451881Z"
      }
    ],
    "editVersion": "8337154F491D5D692C3325A90CD8611D0321EE030C0E03110AEC1C0A595365A7",
    "id": 1,
    "apiUrl": "https://api.blackportal.cloud/api/highways/1",
    "mapUrl": "https://2b2tatlas.com/map?dimension=nether",
    "name": "+X Highway",
    "slug": "x-highway",
    "dimension": 1,
    "category": 0,
    "points": [
      {
        "x": 0,
        "z": 0
      }
    ],
    "ringRadius": null,
    "width": 6,
    "height": 4,
    "yLevel": null,
    "paved": true,
    "pavingMaterial": 1,
    "walls": false,
    "enclosed": false,
    "isRoofHighway": false,
    "lit": false,
    "status": 1,
    "builderGroupId": 7,
    "builderGroupName": "Highway Workers Union (HWU)",
    "builderGroups": [
      {
        "groupId": 7,
        "groupUrl": "https://2b2tatlas.com/group/7",
        "groupInteractiveUrl": "https://2b2tatlas.com/group/7",
        "groupRecordUrl": "https://2b2tatlas.com/entities/groups/7/",
        "groupApiUrl": "https://api.blackportal.cloud/api/groups/7",
        "groupName": "Highway Workers Union (HWU)",
        "role": "Primary builder and current steward",
        "evidence": "https://www.reddit.com/r/2b2t/comments/1ldirek/; https://www.reddit.com/r/2b2t/comments/1ob2ow8/"
      }
    ],
    "lengthBlocks": null,
    "description": "The HWU-linked May 2025 highway map records this route as 6 blocks wide and 4 blocks high. These are the map's dated construction dimensions. MEG's April 2023 project report also records these dimensions for the full route.\n\nMEG reported completing the 6-wide, 4-high tunnel to the Nether world border on July 25, 2022. Credited diggers: Justen and Apate. The completion dates were published in MEG's January 1, 2023 announcement; they describe the tunnel excavation, not the later paving work.",
    "wikiUrl": "https://2b2t.miraheze.org/wiki/Nether_highways#%2BX_(East)",
    "videoUrl": null,
    "color": null,
    "displayWeight": null,
    "visibility": 0,
    "reviewStatus": 2,
    "createdByUserId": null,
    "lastEditedByUserId": 1,
    "dateAddedUtc": "2026-07-22T13:27:29.8271879-06:00",
    "lastVerifiedUtc": null
  }
]

Fields in this example

Up to three levels. [] means an array item. Types describe this example, not the complete schema.

Field	Example type
$	array
$[]	object
$[].pageUrl	string
$[].canonicalUrl	string
$[].interactiveUrl	string
$[].recordUrl	string
$[].attachments	array
$[].attachments[]	object
$[].editVersion	string
$[].id	integer
$[].apiUrl	string
$[].mapUrl	string
$[].name	string
$[].slug	string
$[].dimension	integer
$[].category	integer
$[].points	array
$[].points[]	object
$[].ringRadius	null
$[].width	integer
$[].height	integer
$[].yLevel	null
$[].paved	boolean
$[].pavingMaterial	integer
$[].walls	boolean
$[].enclosed	boolean
$[].isRoofHighway	boolean
$[].lit	boolean
$[].status	integer
$[].builderGroupId	integer
$[].builderGroupName	string
$[].builderGroups	array
$[].builderGroups[]	object
$[].lengthBlocks	null
$[].description	string
$[].wikiUrl	string
$[].videoUrl	null
$[].color	null
$[].displayWeight	null
$[].visibility	integer
$[].reviewStatus	integer
$[].createdByUserId	null
$[].lastEditedByUserId	integer
$[].dateAddedUtc	string
$[].lastVerifiedUtc	null

Example request

https://api.blackportal.cloud/api/highways/1

Open live response

Parameters

Responses

200 The highway.

Response body application/json

Checked October 19, 2026. Recorded response, shortened to one item per array. Values can change. The field list describes this example; use OpenAPI for the full schema.

{
  "pageUrl": "https://2b2tatlas.com/highway/1",
  "canonicalUrl": "https://2b2tatlas.com/highway/1",
  "interactiveUrl": "https://2b2tatlas.com/highway/1",
  "recordUrl": "https://2b2tatlas.com/entities/highways/1/",
  "attachments": [
    {
      "id": 1,
      "apiUrl": "https://api.blackportal.cloud/api/highways/1/attachments/1",
      "locationRowid": 0,
      "fileName": "MEG project roundup (2023)",
      "path": "https://www.reddit.com/r/2b2t/comments/12sw870/",
      "mediaType": "Link",
      "thumbnailPath": null,
      "sourceUrl": "https://www.reddit.com/r/2b2t/comments/12sw870/",
      "caption": "Dated construction milestones, dimensions, builder credits and photographs for named axis, diagonal and ring-road projects.",
      "attribution": "Motorway Extension Gurus (MEG)",
      "dateAddedUtc": "2026-09-18T01:40:47.4451881Z"
    }
  ],
  "editVersion": "8337154F491D5D692C3325A90CD8611D0321EE030C0E03110AEC1C0A595365A7",
  "id": 1,
  "apiUrl": "https://api.blackportal.cloud/api/highways/1",
  "mapUrl": "https://2b2tatlas.com/map?dimension=nether",
  "name": "+X Highway",
  "slug": "x-highway",
  "dimension": 1,
  "category": 0,
  "points": [
    {
      "x": 0,
      "z": 0
    }
  ],
  "ringRadius": null,
  "width": 6,
  "height": 4,
  "yLevel": null,
  "paved": true,
  "pavingMaterial": 1,
  "walls": false,
  "enclosed": false,
  "isRoofHighway": false,
  "lit": false,
  "status": 1,
  "builderGroupId": 7,
  "builderGroupName": "Highway Workers Union (HWU)",
  "builderGroups": [
    {
      "groupId": 7,
      "groupUrl": "https://2b2tatlas.com/group/7",
      "groupInteractiveUrl": "https://2b2tatlas.com/group/7",
      "groupRecordUrl": "https://2b2tatlas.com/entities/groups/7/",
      "groupApiUrl": "https://api.blackportal.cloud/api/groups/7",
      "groupName": "Highway Workers Union (HWU)",
      "role": "Primary builder and current steward",
      "evidence": "https://www.reddit.com/r/2b2t/comments/1ldirek/; https://www.reddit.com/r/2b2t/comments/1ob2ow8/"
    }
  ],
  "lengthBlocks": null,
  "description": "The HWU-linked May 2025 highway map records this route as 6 blocks wide and 4 blocks high. These are the map's dated construction dimensions. MEG's April 2023 project report also records these dimensions for the full route.\n\nMEG reported completing the 6-wide, 4-high tunnel to the Nether world border on July 25, 2022. Credited diggers: Justen and Apate. The completion dates were published in MEG's January 1, 2023 announcement; they describe the tunnel excavation, not the later paving work.",
  "wikiUrl": "https://2b2t.miraheze.org/wiki/Nether_highways#%2BX_(East)",
  "videoUrl": null,
  "color": null,
  "displayWeight": null,
  "visibility": 0,
  "reviewStatus": 2,
  "createdByUserId": null,
  "lastEditedByUserId": 1,
  "dateAddedUtc": "2026-07-22T13:27:29.8271879-06:00",
  "lastVerifiedUtc": null
}

Fields in this example

Up to three levels. [] means an array item. Types describe this example, not the complete schema.

Field	Example type
$	object
$.pageUrl	string
$.canonicalUrl	string
$.interactiveUrl	string
$.recordUrl	string
$.attachments	array
$.attachments[]	object
$.attachments[].id	integer
$.attachments[].apiUrl	string
$.attachments[].locationRowid	integer
$.attachments[].fileName	string
$.attachments[].path	string
$.attachments[].mediaType	string
$.attachments[].thumbnailPath	null
$.attachments[].sourceUrl	string
$.attachments[].caption	string
$.attachments[].attribution	string
$.attachments[].dateAddedUtc	string
$.editVersion	string
$.id	integer
$.apiUrl	string
$.mapUrl	string
$.name	string
$.slug	string
$.dimension	integer
$.category	integer
$.points	array
$.points[]	object
$.points[].x	integer
$.points[].z	integer
$.ringRadius	null
$.width	integer
$.height	integer
$.yLevel	null
$.paved	boolean
$.pavingMaterial	integer
$.walls	boolean
$.enclosed	boolean
$.isRoofHighway	boolean
$.lit	boolean
$.status	integer
$.builderGroupId	integer
$.builderGroupName	string
$.builderGroups	array
$.builderGroups[]	object
$.builderGroups[].groupId	integer
$.builderGroups[].groupUrl	string
$.builderGroups[].groupInteractiveUrl	string
$.builderGroups[].groupRecordUrl	string
$.builderGroups[].groupApiUrl	string
$.builderGroups[].groupName	string
$.builderGroups[].role	string
$.builderGroups[].evidence	string
$.lengthBlocks	null
$.description	string
$.wikiUrl	string
$.videoUrl	null
$.color	null
$.displayWeight	null
$.visibility	integer
$.reviewStatus	integer
$.createdByUserId	null
$.lastEditedByUserId	integer
$.dateAddedUtc	string
$.lastVerifiedUtc	null

404 Not found.

Example request

https://api.blackportal.cloud/api/highways/1/attachments/1

Open live response

Parameters

Responses

200 Attachment metadata.

Response body application/json

Checked October 19, 2026. Recorded response, shortened to one item per array. Values can change. The field list describes this example; use OpenAPI for the full schema.

{
  "id": 1,
  "apiUrl": "https://api.blackportal.cloud/api/highways/1/attachments/1",
  "locationRowid": 0,
  "fileName": "MEG project roundup (2023)",
  "path": "https://www.reddit.com/r/2b2t/comments/12sw870/",
  "mediaType": "Link",
  "thumbnailPath": null,
  "sourceUrl": "https://www.reddit.com/r/2b2t/comments/12sw870/",
  "caption": "Dated construction milestones, dimensions, builder credits and photographs for named axis, diagonal and ring-road projects.",
  "attribution": "Motorway Extension Gurus (MEG)",
  "dateAddedUtc": "2026-09-18T01:40:47.4451881Z"
}

Fields in this example

Up to three levels. [] means an array item. Types describe this example, not the complete schema.

Field	Example type
$	object
$.id	integer
$.apiUrl	string
$.locationRowid	integer
$.fileName	string
$.path	string
$.mediaType	string
$.thumbnailPath	null
$.sourceUrl	string
$.caption	string
$.attribution	string
$.dateAddedUtc	string

404 Not found or not public.

Example request

https://api.blackportal.cloud/api/groups

Open live response

Responses

200 Group list.

Response body application/json

Checked October 19, 2026. Recorded response, shortened to one item per array. Values can change. The field list describes this example; use OpenAPI for the full schema.

[
  {
    "attachments": [
      {
        "id": 1,
        "apiUrl": "https://api.blackportal.cloud/api/groups/19/attachments/1",
        "locationRowid": 0,
        "fileName": "+Z Digging Group — group overview and history",
        "path": "https://2b2t.miraheze.org/wiki/%2BZ_Digging_Group",
        "mediaType": "Link",
        "thumbnailPath": null,
        "sourceUrl": "https://2b2t.miraheze.org/wiki/%2BZ_Digging_Group",
        "caption": "Community-written overview and history of +Z Digging Group.",
        "attribution": "2b2t Wiki contributors",
        "dateAddedUtc": "2026-09-28T07:03:23.7543516Z"
      }
    ],
    "id": 19,
    "canonicalUrl": "https://2b2tatlas.com/group/19",
    "recordUrl": "https://2b2tatlas.com/entities/groups/19/",
    "interactiveUrl": "https://2b2tatlas.com/group/19",
    "apiUrl": "https://api.blackportal.cloud/api/groups/19",
    "name": "+Z Digging Group",
    "aliases": [],
    "type": 1,
    "description": "Axis-highway crew formed around late 2016 after work began on the southern Nether highway. The group completed the +Z route to the Overworld world border on June 9, 2017 and built milestones and small bases along it.",
    "color": "#2986cc",
    "wikiUrl": "https://2b2t.wikioasis.org/wiki/%2BZ_Digging_Group",
    "websiteUrl": null,
    "discordUrl": null,
    "logoUrl": "https://blackportal.cloud/2b2t/MiscRenders/GroupLogos/plus-z-world-border-banner-82f485d0ecd6.png",
    "logoSourceUrl": "https://2b2tatlas.com/location/904?view=3d&render=19&object=0052fb2bba414060bafca695&generation=render-19-e135883e144a34c0f416a293ce085257dfbb244529830b0872dfea55d7a0441a-v5.24-equipment.1.ui3-p11&findX=25&findY=81&findZ=29999669",
    "founded": "Late 2016 / early 2017",
    "status": "Inactive",
    "locationCount": 1,
    "highwayCount": 1,
    "locations": [],
    "highways": [],
    "dateAddedUtc": "2026-07-22T20:06:32.6107102-06:00",
    "modifiedUtc": "2026-10-17T18:31:24.2918376-06:00"
  }
]

Fields in this example

Up to three levels. [] means an array item. Types describe this example, not the complete schema.

Field	Example type
$	array
$[]	object
$[].attachments	array
$[].attachments[]	object
$[].id	integer
$[].canonicalUrl	string
$[].recordUrl	string
$[].interactiveUrl	string
$[].apiUrl	string
$[].name	string
$[].aliases	array
$[].type	integer
$[].description	string
$[].color	string
$[].wikiUrl	string
$[].websiteUrl	null
$[].discordUrl	null
$[].logoUrl	string
$[].logoSourceUrl	string
$[].founded	string
$[].status	string
$[].locationCount	integer
$[].highwayCount	integer
$[].locations	array
$[].highways	array
$[].dateAddedUtc	string
$[].modifiedUtc	string

Example request

https://api.blackportal.cloud/api/groups/19

Open live response

Parameters

Responses

200 The group.

Response body application/json

Checked October 19, 2026. Recorded response, shortened to one item per array. Values can change. The field list describes this example; use OpenAPI for the full schema.

{
  "attachments": [
    {
      "id": 1,
      "apiUrl": "https://api.blackportal.cloud/api/groups/19/attachments/1",
      "locationRowid": 0,
      "fileName": "+Z Digging Group — group overview and history",
      "path": "https://2b2t.miraheze.org/wiki/%2BZ_Digging_Group",
      "mediaType": "Link",
      "thumbnailPath": null,
      "sourceUrl": "https://2b2t.miraheze.org/wiki/%2BZ_Digging_Group",
      "caption": "Community-written overview and history of +Z Digging Group.",
      "attribution": "2b2t Wiki contributors",
      "dateAddedUtc": "2026-09-28T07:03:23.7543516Z"
    }
  ],
  "id": 19,
  "canonicalUrl": "https://2b2tatlas.com/group/19",
  "recordUrl": "https://2b2tatlas.com/entities/groups/19/",
  "interactiveUrl": "https://2b2tatlas.com/group/19",
  "apiUrl": "https://api.blackportal.cloud/api/groups/19",
  "name": "+Z Digging Group",
  "aliases": [],
  "type": 1,
  "description": "Axis-highway crew formed around late 2016 after work began on the southern Nether highway. The group completed the +Z route to the Overworld world border on June 9, 2017 and built milestones and small bases along it.",
  "color": "#2986cc",
  "wikiUrl": "https://2b2t.wikioasis.org/wiki/%2BZ_Digging_Group",
  "websiteUrl": null,
  "discordUrl": null,
  "logoUrl": "https://blackportal.cloud/2b2t/MiscRenders/GroupLogos/plus-z-world-border-banner-82f485d0ecd6.png",
  "logoSourceUrl": "https://2b2tatlas.com/location/904?view=3d&render=19&object=0052fb2bba414060bafca695&generation=render-19-e135883e144a34c0f416a293ce085257dfbb244529830b0872dfea55d7a0441a-v5.24-equipment.1.ui3-p11&findX=25&findY=81&findZ=29999669",
  "founded": "Late 2016 / early 2017",
  "status": "Inactive",
  "locationCount": 1,
  "highwayCount": 1,
  "locations": [
    {
      "locationId": 904,
      "locationUrl": "https://2b2tatlas.com/location/904",
      "locationRecordUrl": "https://2b2tatlas.com/entities/locations/904/",
      "locationInteractiveUrl": "https://2b2tatlas.com/location/904",
      "locationApiUrl": "https://api.blackportal.cloud/api/locations/904",
      "name": "+Z Border",
      "role": "Builder",
      "dimension": 0,
      "x": 0,
      "z": 30000000,
      "renderCount": 10
    }
  ],
  "highways": [
    {
      "highwayId": 3,
      "canonicalUrl": "https://2b2tatlas.com/highway/3",
      "interactiveUrl": "https://2b2tatlas.com/highway/3",
      "recordUrl": "https://2b2tatlas.com/entities/highways/3/",
      "apiUrl": "https://api.blackportal.cloud/api/highways/3",
      "highwayApiUrl": "https://api.blackportal.cloud/api/highways/3",
      "mapUrl": "https://2b2tatlas.com/map?dimension=nether",
      "name": "+Z Highway",
      "dimension": 1,
      "role": "Historical builder"
    }
  ],
  "dateAddedUtc": "2026-07-22T20:06:32.6107102-06:00",
  "modifiedUtc": "2026-10-17T18:31:24.2918376-06:00"
}

Fields in this example

Up to three levels. [] means an array item. Types describe this example, not the complete schema.

Field	Example type
$	object
$.attachments	array
$.attachments[]	object
$.attachments[].id	integer
$.attachments[].apiUrl	string
$.attachments[].locationRowid	integer
$.attachments[].fileName	string
$.attachments[].path	string
$.attachments[].mediaType	string
$.attachments[].thumbnailPath	null
$.attachments[].sourceUrl	string
$.attachments[].caption	string
$.attachments[].attribution	string
$.attachments[].dateAddedUtc	string
$.id	integer
$.canonicalUrl	string
$.recordUrl	string
$.interactiveUrl	string
$.apiUrl	string
$.name	string
$.aliases	array
$.type	integer
$.description	string
$.color	string
$.wikiUrl	string
$.websiteUrl	null
$.discordUrl	null
$.logoUrl	string
$.logoSourceUrl	string
$.founded	string
$.status	string
$.locationCount	integer
$.highwayCount	integer
$.locations	array
$.locations[]	object
$.locations[].locationId	integer
$.locations[].locationUrl	string
$.locations[].locationRecordUrl	string
$.locations[].locationInteractiveUrl	string
$.locations[].locationApiUrl	string
$.locations[].name	string
$.locations[].role	string
$.locations[].dimension	integer
$.locations[].x	integer
$.locations[].z	integer
$.locations[].renderCount	integer
$.highways	array
$.highways[]	object
$.highways[].highwayId	integer
$.highways[].canonicalUrl	string
$.highways[].interactiveUrl	string
$.highways[].recordUrl	string
$.highways[].apiUrl	string
$.highways[].highwayApiUrl	string
$.highways[].mapUrl	string
$.highways[].name	string
$.highways[].dimension	integer
$.highways[].role	string
$.dateAddedUtc	string
$.modifiedUtc	string

404 Not found.

Example request

https://api.blackportal.cloud/api/groups/19/attachments/1

Open live response

Parameters

Responses

200 Attachment metadata.

Response body application/json

Checked October 19, 2026. Recorded response, shortened to one item per array. Values can change. The field list describes this example; use OpenAPI for the full schema.

{
  "id": 1,
  "apiUrl": "https://api.blackportal.cloud/api/groups/19/attachments/1",
  "locationRowid": 0,
  "fileName": "+Z Digging Group — group overview and history",
  "path": "https://2b2t.miraheze.org/wiki/%2BZ_Digging_Group",
  "mediaType": "Link",
  "thumbnailPath": null,
  "sourceUrl": "https://2b2t.miraheze.org/wiki/%2BZ_Digging_Group",
  "caption": "Community-written overview and history of +Z Digging Group.",
  "attribution": "2b2t Wiki contributors",
  "dateAddedUtc": "2026-09-28T07:03:23.7543516Z"
}

Fields in this example

Up to three levels. [] means an array item. Types describe this example, not the complete schema.

Field	Example type
$	object
$.id	integer
$.apiUrl	string
$.locationRowid	integer
$.fileName	string
$.path	string
$.mediaType	string
$.thumbnailPath	null
$.sourceUrl	string
$.caption	string
$.attribution	string
$.dateAddedUtc	string

404 Not found or not public.

Example request

https://api.blackportal.cloud/api/popularity

Open live response

Parameters

Responses

200 Rankings and tracking start date.

Response body application/json

Checked October 19, 2026. Recorded response, shortened to one item per array. Values can change. The field list describes this example; use OpenAPI for the full schema.

{
  "days": 30,
  "fromUtc": "2026-09-20T00:00:00+00:00",
  "updatedUtc": "2026-10-19T06:16:06.5662953+00:00",
  "trackingStartedUtc": "2026-09-20T18:25:08.3122374+00:00",
  "totalViews": 5117,
  "locations": [
    {
      "id": 2275,
      "name": "Spawnmason Lodge l17w26",
      "url": "/location/2275",
      "canonicalUrl": "https://2b2tatlas.com/location/2275",
      "views": 139,
      "recordUrl": "https://2b2tatlas.com/entities/locations/2275/",
      "interactiveUrl": "https://2b2tatlas.com/location/2275"
    }
  ],
  "groups": [
    {
      "id": 1,
      "name": "SpawnMasons",
      "url": "/group/1",
      "canonicalUrl": "https://2b2tatlas.com/entities/groups/1/",
      "views": 96,
      "recordUrl": "https://2b2tatlas.com/entities/groups/1/",
      "interactiveUrl": "https://2b2tatlas.com/group/1"
    }
  ],
  "highways": [
    {
      "id": 99,
      "name": "Nether World Border Ring Road",
      "url": "/highway/99",
      "canonicalUrl": "https://2b2tatlas.com/entities/highways/99/",
      "views": 28,
      "recordUrl": "https://2b2tatlas.com/entities/highways/99/",
      "interactiveUrl": "https://2b2tatlas.com/highway/99"
    }
  ],
  "dailyViews": [
    {
      "date": "2026-09-20",
      "views": 69
    }
  ]
}

Fields in this example

Up to three levels. [] means an array item. Types describe this example, not the complete schema.

Field	Example type
$	object
$.days	integer
$.fromUtc	string
$.updatedUtc	string
$.trackingStartedUtc	string
$.totalViews	integer
$.locations	array
$.locations[]	object
$.locations[].id	integer
$.locations[].name	string
$.locations[].url	string
$.locations[].canonicalUrl	string
$.locations[].views	integer
$.locations[].recordUrl	string
$.locations[].interactiveUrl	string
$.groups	array
$.groups[]	object
$.groups[].id	integer
$.groups[].name	string
$.groups[].url	string
$.groups[].canonicalUrl	string
$.groups[].views	integer
$.groups[].recordUrl	string
$.groups[].interactiveUrl	string
$.highways	array
$.highways[]	object
$.highways[].id	integer
$.highways[].name	string
$.highways[].url	string
$.highways[].canonicalUrl	string
$.highways[].views	integer
$.highways[].recordUrl	string
$.highways[].interactiveUrl	string
$.dailyViews	array
$.dailyViews[]	object
$.dailyViews[].date	string
$.dailyViews[].views	integer

400 Unsupported period.

Example request

https://api.blackportal.cloud/api/locations.php?rows=1&dimension=0&warps=1

Open live response

Parameters

Responses

200 Legacy snake_case locations.

Response body application/json

Checked October 19, 2026. Recorded response, shortened to one item per array. Values can change. The field list describes this example; use OpenAPI for the full schema.

[
  {
    "location_uuid": "032bdd64-e0d0-11ea-bb3c-0200516ae545",
    "user_uuid": "",
    "name": "Point Nemo",
    "x": "29999732",
    "y": "105",
    "z": "4",
    "description": "Point Nemo is a destroyed base located on the 2b2t X+ World Border, constructed by the +X Digging Group. The base was griefed a single week after construction began, and completely wiped out in the following months.\n\nThe landscape of the area was generated in 1.6. The first known people who reached the area were Pyrobyte and iTristan on December 7th, 2013 (most likely with a backdoor). They left a bedrock platform on the other side of the border, with two signs, reading:\n\n\"It's the end of the world -Pyrobyte December 7 2013\"\n\n\"iTristan was here. If you see this, shit went down\"\n\niTristan also left the 121 book from the Mein Kampf collection, created by Victormeriqui, and a super weapon on the other side of the border.\n\nOn December 9th 2016, Byrnsy started a journey towards the very same place, thus formed the +X Digging Group. It was established that once they reach the World Border, they were going to build a base there, just like they did at other notable points. They named it Point Nemo, after the oceanic pole of inaccessibility - the furthest point on Earth from land, located in the Southern Pacific Ocean.\n\nOn March 26th, 2017, the first group of diggers - househousehouse1, xxq, irql, rasqi, miningminecraft, and several others - reached the World Border, and discovered Pyro's and iTristan's signs. They also manged to retrieve the Mein Kampf book.\n\nAs other group members also arrived, the building of the base started. On March 28th, when Byrnsy finished his journey, the place had already started to take shape. However, a day later, it was griefed.\n\nOn April 24th, Fit finished his own journey to the world border, and several of the former diggers, including Byrnsy, gathered at the partially repaired base as a formal welcome party.\n\nOn April 30th, the base was griefed again.\n\nDuring May, the base was fully destroyed, and lavacasted beyond repair.",
    "tags": "",
    "time_added": "2020-08-17 21:24:20",
    "wiki": "https://2b2t.miraheze.org/wiki/Point_Nemo",
    "video_url": "",
    "end_dimension": 0,
    "warps": [
      {
        "name": "Point_Nemo_2017-04-24_x30m"
      }
    ]
  }
]

Fields in this example

Up to three levels. [] means an array item. Types describe this example, not the complete schema.

Field	Example type
$	array
$[]	object
$[].location_uuid	string
$[].user_uuid	string
$[].name	string
$[].x	string
$[].y	string
$[].z	string
$[].description	string
$[].tags	string
$[].time_added	string
$[].wiki	string
$[].video_url	string
$[].end_dimension	integer
$[].warps	array
$[].warps[]	object

Example request

https://api.blackportal.cloud/api/locationCount.php

Open live response

Responses

200 Object with an integer locationCount.

Response body application/json

Checked October 19, 2026. Recorded response, shortened to one item per array. Values can change. The field list describes this example; use OpenAPI for the full schema.

{
  "locationCount": 2253
}

Fields in this example

Up to three levels. [] means an array item. Types describe this example, not the complete schema.

Field	Example type
$	object
$.locationCount	integer

Example request

https://api.blackportal.cloud/api/nocom

Open live response

Responses

200 World Pulse metadata and a find descriptor with immutable manifest, integrity hashes, product counts, dimension coverage and query URLs.

Response body application/json

Checked October 19, 2026. Recorded response, shortened to one item per array. Values can change. The field list describes this example; use OpenAPI for the full schema.

{
  "id": "nocom-world-pulse-v1",
  "name": "Nocom World Pulse historical observations",
  "url": "https://2b2tatlas.com/nocom/",
  "sourceUrl": "https://github.com/nerdsinspace/nocom-explanation/blob/main/torrent.md",
  "manifestUrl": "https://blackportal.cloud/AtlasTiles/Nocom/v1/manifest.json",
  "periodsApiUrl": "https://api.blackportal.cloud/api/nocom/periods",
  "highwayActivityApiUrl": "https://api.blackportal.cloud/api/nocom/highways",
  "tilesGeneratedAtUtc": "2026-08-21T00:27:16.629706+00:00",
  "exploitPatchedDate": "2021-07-15",
  "groupedRows": 537689881,
  "observations": 3133950352,
  "periodLayerCount": 39,
  "dimensions": [
    {
      "dimension": "overworld",
      "atlasDimension": 0,
      "sourceDimension": 0,
      "periodCount": 17,
      "groupedRows": 269308795,
      "observations": 1445105895,
      "firstBucketStartUtc": "2020-03-09T00:00:00+00:00",
      "lastBucketEndExclusiveUtc": "2021-08-01T00:00:00+00:00",
      "totalTileUrlTemplate": "https://blackportal.cloud/AtlasTiles/Nocom/v1/total/overworld/{z}/{y}/{x}.png",
      "minNativeUrlZoom": -9,
      "maxNativeUrlZoom": 6,
      "canonicalUrl": "https://2b2tatlas.com/nocom/"
    }
  ],
  "groupedSourceSha256": "0dd61cbe65b1d4ef45f8791f7edb60ace805cd4d692601c31f71cf05e3674001",
  "groupedServerScope": "The official grouped release has no server_id column; it is used as published by the Nocom authors.",
  "highwaySourceSha256": "bfd8a77ae6a051187bbe24061a08ec632996a5538b2eda872502b28467b368f1",
  "highwaySourceScope": "Authors published temporary highway aggregate; no server_id column. Historical query notes filter 2b2t.org, but their month offset differs from the released table. Dates here use released Unix 30-day bucket IDs 611-627, matching the World Pulse periods.",
  "attribution": "Original Nocom release credited to Nerds Inc and contributors; upstream release terms remain separate from Atlas-authored catalog metadata.",
  "caveats": [
    "Counts are positive loaded-chunk observations, not unique players, visits, exact player positions or ownership evidence."
  ],
  "canonicalUrl": "https://2b2tatlas.com/nocom/",
  "find": {
    "id": "nocom-find-v2",
    "canonicalUrl": "https://2b2tatlas.com/nocom/find/",
    "manifestUrl": "https://blackportal.cloud/AtlasTiles/Nocom/find/7c95fabb5ea5cbd1607d89232e4f962d6042081f38b95f2f0db82e1047a898c9/manifest.json",
    "manifestSha256": "7c95fabb5ea5cbd1607d89232e4f962d6042081f38b95f2f0db82e1047a898c9",
    "integrityUrl": "https://blackportal.cloud/AtlasTiles/Nocom/find/7c95fabb5ea5cbd1607d89232e4f962d6042081f38b95f2f0db82e1047a898c9/integrity.json",
    "integritySha256": "75d1e235c05611d5462a009ee5658faac26318cab3d43d9639e0a49b7a3e3d06",
    "sourceUrl": "https://github.com/nerdsinspace/nocom-explanation/blob/main/torrent.md",
    "sourceSha256": "22d3ec296a47a5f1c7b5bff33cb8b4aa50cbce9d68d4482fe27176ddfb83d0ec",
    "sourceRows": 10122306352,
    "complete": true,
    "blockObservationFromUtc": "2020-04-29T21:36:56.55+00:00",
    "blockObservationToUtc": "2021-07-16T01:45:53.468+00:00",
    "counts": {
      "storagePositions": 1262073,
      "signPositions": 8456,
      "signObservations": 12122,
      "clusterRoots": 15364,
      "portalGroups": 10647,
      "portalBlocks": 1587686
    },
    "coverage": [
      {
        "dimension": "overworld",
        "sourceDimension": 0,
        "products": [
          "storage"
        ]
      }
    ],
    "attribution": "Original NoCom release: Nerds Inc and contributors. Atlas derives spatial indexes; original-source terms remain separate.",
    "accessNotes": [
      "Native Minecraft XYZ blocks, never latitude/longitude. Source dimensions: 0 Overworld, -1 Nether, 1 End; these differ from Atlas enum values."
    ],
    "storageApiUrl": "https://api.blackportal.cloud/api/nocom/find/storage",
    "signsApiUrl": "https://api.blackportal.cloud/api/nocom/find/signs",
    "portalsApiUrl": "https://api.blackportal.cloud/api/nocom/find/portals"
  },
  "dailyHitsApiUrl": "https://api.blackportal.cloud/api/nocom/hits",
  "rareBlocksApiUrl": "https://api.blackportal.cloud/api/nocom/find/rare",
  "clustersApiUrl": "https://api.blackportal.cloud/api/nocom/find/clusters",
  "signHistoryApiUrl": "https://api.blackportal.cloud/api/nocom/find/sign-history",
  "specialBlocksApiUrl": "https://api.blackportal.cloud/api/nocom/find/special",
  "rawSourceReleaseUrl": "https://github.com/nerdsinspace/nocom-explanation/blob/main/torrent.md",
  "rawSourceSchemaUrl": "https://github.com/nerdsinspace/nocomment-master/blob/master/schema.sql",
  "sourceProducts": [
    {
      "file": "hits.sql.gz",
      "contains": "Timestamped positive loaded-chunk checks",
      "atlasAccess": "/api/nocom/hits: complete server-1 daily counts, chunk records, CSV exports and maps",
      "interpretation": "Daily exports aggregate repeat observations; individual timestamps and track IDs remain in the upstream raw source."
    }
  ]
}

Fields in this example

Up to three levels. [] means an array item. Types describe this example, not the complete schema.

Field	Example type
$	object
$.id	string
$.name	string
$.url	string
$.sourceUrl	string
$.manifestUrl	string
$.periodsApiUrl	string
$.highwayActivityApiUrl	string
$.tilesGeneratedAtUtc	string
$.exploitPatchedDate	string
$.groupedRows	integer
$.observations	integer
$.periodLayerCount	integer
$.dimensions	array
$.dimensions[]	object
$.dimensions[].dimension	string
$.dimensions[].atlasDimension	integer
$.dimensions[].sourceDimension	integer
$.dimensions[].periodCount	integer
$.dimensions[].groupedRows	integer
$.dimensions[].observations	integer
$.dimensions[].firstBucketStartUtc	string
$.dimensions[].lastBucketEndExclusiveUtc	string
$.dimensions[].totalTileUrlTemplate	string
$.dimensions[].minNativeUrlZoom	integer
$.dimensions[].maxNativeUrlZoom	integer
$.dimensions[].canonicalUrl	string
$.groupedSourceSha256	string
$.groupedServerScope	string
$.highwaySourceSha256	string
$.highwaySourceScope	string
$.attribution	string
$.caveats	array
$.caveats[]	string
$.canonicalUrl	string
$.find	object
$.find.id	string
$.find.canonicalUrl	string
$.find.manifestUrl	string
$.find.manifestSha256	string
$.find.integrityUrl	string
$.find.integritySha256	string
$.find.sourceUrl	string
$.find.sourceSha256	string
$.find.sourceRows	integer
$.find.complete	boolean
$.find.blockObservationFromUtc	string
$.find.blockObservationToUtc	string
$.find.counts	object
$.find.counts.storagePositions	integer
$.find.counts.signPositions	integer
$.find.counts.signObservations	integer
$.find.counts.clusterRoots	integer
$.find.counts.portalGroups	integer
$.find.counts.portalBlocks	integer
$.find.coverage	array
$.find.coverage[]	object
$.find.attribution	string
$.find.accessNotes	array
$.find.accessNotes[]	string
$.find.storageApiUrl	string
$.find.signsApiUrl	string
$.find.portalsApiUrl	string
$.dailyHitsApiUrl	string
$.rareBlocksApiUrl	string
$.clustersApiUrl	string
$.signHistoryApiUrl	string
$.specialBlocksApiUrl	string
$.rawSourceReleaseUrl	string
$.rawSourceSchemaUrl	string
$.sourceProducts	array
$.sourceProducts[]	object
$.sourceProducts[].file	string
$.sourceProducts[].contains	string
$.sourceProducts[].atlasAccess	string
$.sourceProducts[].interpretation	string

Example request

https://api.blackportal.cloud/api/nocom/periods

Open live response

Parameters

Responses

200 Period array; may be empty.

Response body application/json

Checked October 19, 2026. Recorded response, shortened to one item per array. Values can change. The field list describes this example; use OpenAPI for the full schema.

[
  {
    "key": "2020-03-09",
    "dimension": "overworld",
    "atlasDimension": 0,
    "sourceDimension": 0,
    "periodStartUtc": "2020-03-09T00:00:00+00:00",
    "periodEndExclusiveUtc": "2020-04-08T00:00:00+00:00",
    "groupedRows": 3596435,
    "observations": 37696995,
    "observedExtentBlocks": {
      "minX": -23200064,
      "minZ": -19735568,
      "maxXInclusive": 30000047,
      "maxZInclusive": 30000063
    },
    "tileUrlTemplate": "https://blackportal.cloud/AtlasTiles/Nocom/v1/monthly/2020-03-09/overworld/{z}/{y}/{x}.png",
    "minNativeUrlZoom": -9,
    "maxNativeUrlZoom": 6,
    "canonicalUrl": "https://2b2tatlas.com/nocom/"
  }
]

Fields in this example

Up to three levels. [] means an array item. Types describe this example, not the complete schema.

Field	Example type
$	array
$[]	object
$[].key	string
$[].dimension	string
$[].atlasDimension	integer
$[].sourceDimension	integer
$[].periodStartUtc	string
$[].periodEndExclusiveUtc	string
$[].groupedRows	integer
$[].observations	integer
$[].observedExtentBlocks	object
$[].observedExtentBlocks.minX	integer
$[].observedExtentBlocks.minZ	integer
$[].observedExtentBlocks.maxXInclusive	integer
$[].observedExtentBlocks.maxZInclusive	integer
$[].tileUrlTemplate	string
$[].minNativeUrlZoom	integer
$[].maxNativeUrlZoom	integer
$[].canonicalUrl	string

400 Invalid dimension, date or reversed date range.

Example request

https://api.blackportal.cloud/api/nocom/highways

Open live response

Parameters

Responses

200 Highway observation array.

Response body application/json

Checked October 19, 2026. Recorded response, shortened to one item per array. Values can change. The field list describes this example; use OpenAPI for the full schema.

[
  {
    "dimension": "nether",
    "atlasDimension": 1,
    "direction": "east",
    "directionX": 1,
    "directionZ": 0,
    "periodStartUtc": "2020-03-09T00:00:00+00:00",
    "periodEndExclusiveUtc": "2020-04-08T00:00:00+00:00",
    "observations": 504846,
    "canonicalUrl": "https://2b2tatlas.com/nocom/"
  }
]

Fields in this example

Up to three levels. [] means an array item. Types describe this example, not the complete schema.

Field	Example type
$	array
$[]	object
$[].dimension	string
$[].atlasDimension	integer
$[].direction	string
$[].directionX	integer
$[].directionZ	integer
$[].periodStartUtc	string
$[].periodEndExclusiveUtc	string
$[].observations	integer
$[].canonicalUrl	string

400 Invalid dimension or direction.

Example request

https://api.blackportal.cloud/api/nocom/find/storage?x=858407&z=1177384&radius=1024&limit=5

Open live response

Parameters

Responses

200 Release-pinned page, exact total, coverage, nextOffset and source links.

Response body application/json

Checked October 19, 2026. Recorded response, shortened to one item per array. Values can change. The field list describes this example; use OpenAPI for the full schema.

{
  "kind": "storage",
  "dimension": "overworld",
  "coverage": "recorded",
  "x": 858407,
  "z": 1177384,
  "radius": 1024,
  "offset": 0,
  "limit": 5,
  "total": 29223,
  "nextOffset": 5,
  "releaseSha256": "7c95fabb5ea5cbd1607d89232e4f962d6042081f38b95f2f0db82e1047a898c9",
  "canonicalUrl": "https://2b2tatlas.com/nocom/find/",
  "sourceUrl": "https://github.com/nerdsinspace/nocom-explanation/blob/main/torrent.md",
  "attribution": "Original NoCom release: Nerds Inc and contributors. Atlas derives spatial indexes; original-source terms remain separate.",
  "interpretation": "Historical storage block positions, not inventories, ownership or current survival. Changed refers to a later recorded state; no destruction date is inferred.",
  "items": [
    {
      "id": "storage:0:858406:63:1177384",
      "kind": "storage",
      "dimension": "overworld",
      "sourceDimension": 0,
      "x": 858406,
      "y": 63,
      "z": 1177384,
      "distanceBlocks": 1,
      "blockType": "minecraft:chest",
      "text": null,
      "textTruncated": false,
      "firstObservedUtc": "2021-05-10T03:07:25.531+00:00",
      "lastObservedUtc": "2021-06-06T06:14:50.851+00:00",
      "changed": true,
      "portalBlockCount": null,
      "minY": null,
      "maxY": null,
      "textVersions": null,
      "lastRecordedBlockState": "minecraft:air",
      "lastStateObservedUtc": "2021-07-14T13:41:54.288+00:00",
      "conflictingLastState": false,
      "canonicalUrl": "https://2b2tatlas.com/map?dimension=overworld&x=858406&z=1177384&zoom=12&nocom=find",
      "sourceJsonUrl": "https://blackportal.cloud/AtlasTiles/Nocom/find/7c95fabb5ea5cbd1607d89232e4f962d6042081f38b95f2f0db82e1047a898c9/detail/0_6706_9198.json"
    }
  ]
}

Fields in this example

Up to three levels. [] means an array item. Types describe this example, not the complete schema.

Field	Example type
$	object
$.kind	string
$.dimension	string
$.coverage	string
$.x	integer
$.z	integer
$.radius	integer
$.offset	integer
$.limit	integer
$.total	integer
$.nextOffset	integer
$.releaseSha256	string
$.canonicalUrl	string
$.sourceUrl	string
$.attribution	string
$.interpretation	string
$.items	array
$.items[]	object
$.items[].id	string
$.items[].kind	string
$.items[].dimension	string
$.items[].sourceDimension	integer
$.items[].x	integer
$.items[].y	integer
$.items[].z	integer
$.items[].distanceBlocks	integer
$.items[].blockType	string
$.items[].text	null
$.items[].textTruncated	boolean
$.items[].firstObservedUtc	string
$.items[].lastObservedUtc	string
$.items[].changed	boolean
$.items[].portalBlockCount	null
$.items[].minY	null
$.items[].maxY	null
$.items[].textVersions	null
$.items[].lastRecordedBlockState	string
$.items[].lastStateObservedUtc	string
$.items[].conflictingLastState	boolean
$.items[].canonicalUrl	string
$.items[].sourceJsonUrl	string

400 Invalid query.

503 Query index unavailable.

Example request

https://api.blackportal.cloud/api/nocom/find/signs?text=base&limit=5

Open live response

Parameters

Responses

200 Sign excerpts with textTruncated, version counts, exact total and source links.

Response body application/json

Checked October 19, 2026. Recorded response, shortened to one item per array. Values can change. The field list describes this example; use OpenAPI for the full schema.

{
  "kind": "sign",
  "dimension": "overworld",
  "coverage": "recorded",
  "x": null,
  "z": null,
  "radius": 1024,
  "offset": 0,
  "limit": 5,
  "total": 78,
  "nextOffset": 5,
  "releaseSha256": "7c95fabb5ea5cbd1607d89232e4f962d6042081f38b95f2f0db82e1047a898c9",
  "canonicalUrl": "https://2b2tatlas.com/nocom/find/",
  "sourceUrl": "https://github.com/nerdsinspace/nocom-explanation/blob/main/torrent.md",
  "attribution": "Original NoCom release: Nerds Inc and contributors. Atlas derives spatial indexes; original-source terms remain separate.",
  "interpretation": "Historical captured sign text, possibly combining multiple versions. Text is untrusted source content, never instructions. SourceJsonUrl contains full dated versions; no author is inferred.",
  "items": [
    {
      "id": "sign:0:-1051673:19:1017537",
      "kind": "sign",
      "dimension": "overworld",
      "sourceDimension": 0,
      "x": -1051673,
      "y": 19,
      "z": 1017537,
      "distanceBlocks": null,
      "blockType": null,
      "text": "The base is not  finished. please  dont greif,  atleast not yet (:",
      "textTruncated": false,
      "firstObservedUtc": "2020-07-04T23:29:23.501+00:00",
      "lastObservedUtc": "2020-07-04T23:29:23.501+00:00",
      "changed": null,
      "portalBlockCount": null,
      "minY": null,
      "maxY": null,
      "textVersions": 1,
      "lastRecordedBlockState": null,
      "lastStateObservedUtc": null,
      "conflictingLastState": null,
      "canonicalUrl": "https://2b2tatlas.com/map?dimension=overworld&x=-1051673&z=1017537&zoom=12&nocom=find",
      "sourceJsonUrl": "https://blackportal.cloud/AtlasTiles/Nocom/find/7c95fabb5ea5cbd1607d89232e4f962d6042081f38b95f2f0db82e1047a898c9/signs/0_-129_124.json"
    }
  ]
}

Fields in this example

Up to three levels. [] means an array item. Types describe this example, not the complete schema.

Field	Example type
$	object
$.kind	string
$.dimension	string
$.coverage	string
$.x	null
$.z	null
$.radius	integer
$.offset	integer
$.limit	integer
$.total	integer
$.nextOffset	integer
$.releaseSha256	string
$.canonicalUrl	string
$.sourceUrl	string
$.attribution	string
$.interpretation	string
$.items	array
$.items[]	object
$.items[].id	string
$.items[].kind	string
$.items[].dimension	string
$.items[].sourceDimension	integer
$.items[].x	integer
$.items[].y	integer
$.items[].z	integer
$.items[].distanceBlocks	null
$.items[].blockType	null
$.items[].text	string
$.items[].textTruncated	boolean
$.items[].firstObservedUtc	string
$.items[].lastObservedUtc	string
$.items[].changed	null
$.items[].portalBlockCount	null
$.items[].minY	null
$.items[].maxY	null
$.items[].textVersions	integer
$.items[].lastRecordedBlockState	null
$.items[].lastStateObservedUtc	null
$.items[].conflictingLastState	null
$.items[].canonicalUrl	string
$.items[].sourceJsonUrl	string

400 Invalid query.

503 Query index unavailable.

Example request

https://api.blackportal.cloud/api/nocom/find/portals?x=0&z=0&radius=8192&limit=5

Open live response

Parameters

Responses

200 Portal group page with block counts, Y extent, dates, coverage and sources.

Response body application/json

Checked October 19, 2026. Recorded response, shortened to one item per array. Values can change. The field list describes this example; use OpenAPI for the full schema.

{
  "kind": "portal",
  "dimension": "overworld",
  "coverage": "recorded",
  "x": 0,
  "z": 0,
  "radius": 8192,
  "offset": 0,
  "limit": 5,
  "total": 0,
  "nextOffset": null,
  "releaseSha256": "7c95fabb5ea5cbd1607d89232e4f962d6042081f38b95f2f0db82e1047a898c9",
  "canonicalUrl": "https://2b2tatlas.com/nocom/find/",
  "sourceUrl": "https://github.com/nerdsinspace/nocom-explanation/blob/main/torrent.md",
  "attribution": "Original NoCom release: Nerds Inc and contributors. Atlas derives spatial indexes; original-source terms remain separate.",
  "interpretation": "Groups of face-adjacent historical portal blocks. Position is the group's representative block, not its center. These are not simultaneous active portals or verified interdimensional links.",
  "items": []
}

Fields in this example

Up to three levels. [] means an array item. Types describe this example, not the complete schema.

Field	Example type
$	object
$.kind	string
$.dimension	string
$.coverage	string
$.x	integer
$.z	integer
$.radius	integer
$.offset	integer
$.limit	integer
$.total	integer
$.nextOffset	null
$.releaseSha256	string
$.canonicalUrl	string
$.sourceUrl	string
$.attribution	string
$.interpretation	string
$.items	array

400 Invalid query.

503 Query index unavailable.

Example request

https://api.blackportal.cloud/api/nocom/hits

Open live response

Responses

200 Complete daily source coverage, source hash, per-day CSV manifest and tile discovery.

Response body application/json

Checked October 19, 2026. Recorded response, shortened to one item per array. Values can change. The field list describes this example; use OpenAPI for the full schema.

{
  "id": "nocom-daily-hits-v1",
  "complete": true,
  "sourceSha256": "abdf11e938f85384c1fa0bdff9979540f6f57cd5848168fa6e8fba9197c7aff1",
  "sourceRows": 3171483208,
  "observations": 3171475363,
  "manifestUrl": "https://blackportal.cloud/AtlasTiles/Nocom/daily/1d1934b135360774d43d248d/manifest.json",
  "dailyApiUrl": "https://api.blackportal.cloud/api/nocom/hits/daily",
  "chunksApiUrl": "https://api.blackportal.cloud/api/nocom/hits/chunks",
  "tileManifestUrl": "https://api.blackportal.cloud/api/nocom/hits/tiles/manifest",
  "dimensions": [
    {
      "dimension": "overworld",
      "firstDay": "2018-07-29",
      "lastDay": "2021-07-16",
      "observations": 1464327869,
      "dailyChunkRows": 405596423,
      "recordedDays": 777
    }
  ],
  "canonicalUrl": "https://2b2tatlas.com/nocom/",
  "sourceUrl": "https://github.com/nerdsinspace/nocom-explanation/blob/main/torrent.md",
  "interpretation": "Counts are released positive loaded-chunk observations, not unique players, visits or ownership. UTC calendar days, server_id=1 only, including legacy hits. Missing observations do not prove inactivity. Bounding boxes include each 16x16-block chunk that intersects the box; counts cannot be split within a chunk. Raw records may extend beyond the prose patch date and nominal +/-30M border; their timestamps and coordinates are retained. Query coordinate bounds -33554432..33554431 preserve the complete source encoding, not a claim about playable world bounds."
}

Fields in this example

Up to three levels. [] means an array item. Types describe this example, not the complete schema.

Field	Example type
$	object
$.id	string
$.complete	boolean
$.sourceSha256	string
$.sourceRows	integer
$.observations	integer
$.manifestUrl	string
$.dailyApiUrl	string
$.chunksApiUrl	string
$.tileManifestUrl	string
$.dimensions	array
$.dimensions[]	object
$.dimensions[].dimension	string
$.dimensions[].firstDay	string
$.dimensions[].lastDay	string
$.dimensions[].observations	integer
$.dimensions[].dailyChunkRows	integer
$.dimensions[].recordedDays	integer
$.canonicalUrl	string
$.sourceUrl	string
$.interpretation	string

400 Invalid parameters.

503 Complete release unavailable; no partial data returned.

Example request

https://api.blackportal.cloud/api/nocom/hits/daily?from=2020-04-01&to=2020-04-07&dimension=overworld

Open live response

Parameters

Responses

200 Exact per-day loaded-chunk observations and observed-chunk counts. Missing records do not prove inactivity.

Response body application/json

Checked October 19, 2026. Recorded response, shortened to one item per array. Values can change. The field list describes this example; use OpenAPI for the full schema.

{
  "dimension": "overworld",
  "from": "2020-04-01",
  "to": "2020-04-07",
  "bounds": null,
  "sourceSha256": "abdf11e938f85384c1fa0bdff9979540f6f57cd5848168fa6e8fba9197c7aff1",
  "canonicalUrl": "https://2b2tatlas.com/map?dimension=overworld&nocom=pulse&resolution=daily&from=2020-04-01&to=2020-04-07",
  "manifestUrl": "https://blackportal.cloud/AtlasTiles/Nocom/daily/1d1934b135360774d43d248d/manifest.json",
  "interpretation": "Counts are released positive loaded-chunk observations, not unique players, visits or ownership. UTC calendar days, server_id=1 only, including legacy hits. Missing observations do not prove inactivity. Bounding boxes include each 16x16-block chunk that intersects the box; counts cannot be split within a chunk. Raw records may extend beyond the prose patch date and nominal +/-30M border; their timestamps and coordinates are retained. Query coordinate bounds -33554432..33554431 preserve the complete source encoding, not a claim about playable world bounds.",
  "days": [
    {
      "date": "2020-04-01",
      "observations": 3760757,
      "observedChunks": 549263,
      "coverage": "recorded",
      "downloadCsvUrl": "https://blackportal.cloud/AtlasTiles/Nocom/daily/1d1934b135360774d43d248d/data/18353_0.csv.gz"
    }
  ]
}

Fields in this example

Up to three levels. [] means an array item. Types describe this example, not the complete schema.

Field	Example type
$	object
$.dimension	string
$.from	string
$.to	string
$.bounds	null
$.sourceSha256	string
$.canonicalUrl	string
$.manifestUrl	string
$.interpretation	string
$.days	array
$.days[]	object
$.days[].date	string
$.days[].observations	integer
$.days[].observedChunks	integer
$.days[].coverage	string
$.days[].downloadCsvUrl	string

400 Invalid parameters.

503 Complete release unavailable; no partial data returned.

Example request

https://api.blackportal.cloud/api/nocom/hits/chunks?date=2020-04-01&minX=-512&minZ=-512&maxX=511&maxZ=511&limit=5

Open live response

Parameters

Responses

200 One UTC day of native chunk positions, block bounds and counts; stable cursor paging.

Response body application/json

Checked October 19, 2026. Recorded response, shortened to one item per array. Values can change. The field list describes this example; use OpenAPI for the full schema.

{
  "dimension": "overworld",
  "date": "2020-04-01",
  "bounds": {
    "minX": -512,
    "minZ": -512,
    "maxXInclusive": 511,
    "maxZInclusive": 511
  },
  "limit": 5,
  "nextCursor": "1d1934b135360774d43d248d83aa2d9337328d28354030ac47749868a185329f.20200401.0.-512.-512.511.511.8795556143332",
  "sourceSha256": "abdf11e938f85384c1fa0bdff9979540f6f57cd5848168fa6e8fba9197c7aff1",
  "canonicalUrl": "https://2b2tatlas.com/map?dimension=overworld&nocom=pulse&day=2020-04-01&x=0&z=0&zoom=12",
  "downloadCsvUrl": "https://blackportal.cloud/AtlasTiles/Nocom/daily/1d1934b135360774d43d248d/data/18353_0.csv.gz",
  "interpretation": "Counts are released positive loaded-chunk observations, not unique players, visits or ownership. UTC calendar days, server_id=1 only, including legacy hits. Missing observations do not prove inactivity. Bounding boxes include each 16x16-block chunk that intersects the box; counts cannot be split within a chunk. Raw records may extend beyond the prose patch date and nominal +/-30M border; their timestamps and coordinates are retained. Query coordinate bounds -33554432..33554431 preserve the complete source encoding, not a claim about playable world bounds.",
  "items": [
    {
      "chunkX": -32,
      "chunkZ": -32,
      "bounds": {
        "minX": -512,
        "minZ": -512,
        "maxXInclusive": -497,
        "maxZInclusive": -497
      },
      "observations": 112,
      "extendsBeyondNominalWorldBorder": false
    }
  ]
}

Fields in this example

Up to three levels. [] means an array item. Types describe this example, not the complete schema.

Field	Example type
$	object
$.dimension	string
$.date	string
$.bounds	object
$.bounds.minX	integer
$.bounds.minZ	integer
$.bounds.maxXInclusive	integer
$.bounds.maxZInclusive	integer
$.limit	integer
$.nextCursor	string
$.sourceSha256	string
$.canonicalUrl	string
$.downloadCsvUrl	string
$.interpretation	string
$.items	array
$.items[]	object
$.items[].chunkX	integer
$.items[].chunkZ	integer
$.items[].bounds	object
$.items[].observations	integer
$.items[].extendsBeyondNominalWorldBorder	boolean

400 Invalid parameters.

503 Complete release unavailable; no partial data returned.