{ "openapi": "3.1.1", "info": { "title": "2b2t Atlas public read-only API", "description": "Anonymous public data endpoints. Account, write, moderation and worker operations are excluded.", "version": "1.0.0" }, "servers": [ { "url": "http://api.blackportal.cloud/" } ], "paths": { "/api": { "get": { "tags": [ "ApiIndex" ], "summary": "GET /api - a discovery index of public endpoints and the OpenAPI document location.", "responses": { "200": { "description": "A static description of the public API surface." } } } }, "/api/Attachments": { "get": { "tags": [ "Attachments" ], "summary": "Returns public attachment metadata, optionally filtered by location or media type.", "parameters": [ { "name": "locationId", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" } }, { "name": "mediaType", "in": "query", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32", "default": 500 } }, { "name": "offset", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32", "default": 0 } } ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/AttachmentRecord" } } }, "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/AttachmentRecord" } } }, "text/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/AttachmentRecord" } } } } } } } }, "/api/Attachments/{id}": { "get": { "tags": [ "Attachments" ], "summary": "Returns one public attachment metadata record.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/AttachmentRecord" } }, "application/json": { "schema": { "$ref": "#/components/schemas/AttachmentRecord" } }, "text/json": { "schema": { "$ref": "#/components/schemas/AttachmentRecord" } } } } } } }, "/api/Groups": { "get": { "tags": [ "Groups" ], "summary": "Returns the public directory of 2b2t build and infrastructure groups, ordered by name.", "responses": { "200": { "description": "A cacheable projection of all persisted groups.", "content": { "text/plain": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/Group" } } }, "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/Group" } } }, "text/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/Group" } } } } } } } }, "/api/Groups/{id}": { "get": { "tags": [ "Groups" ], "summary": "Returns one group used for Atlas attribution.", "parameters": [ { "name": "id", "in": "path", "description": "The database identifier of the group.", "required": true, "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "The group projection, or `404` when it does not exist.", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/Group" } }, "application/json": { "schema": { "$ref": "#/components/schemas/Group" } }, "text/json": { "schema": { "$ref": "#/components/schemas/Group" } } } } } } }, "/api/Groups/{id}/attachments/{attachmentId}": { "get": { "tags": [ "Groups" ], "summary": "Returns the source metadata for one group attachment.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": "integer", "format": "int32" } }, { "name": "attachmentId", "in": "path", "required": true, "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "OK" } } } }, "/api/Highways": { "get": { "tags": [ "Highways" ], "summary": "All public, approved highways.", "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/Highway" } } }, "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/Highway" } } }, "text/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/Highway" } } } } } } } }, "/api/Highways/{id}": { "get": { "tags": [ "Highways" ], "summary": "A highway and the version required to edit it.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/Highway" } }, "application/json": { "schema": { "$ref": "#/components/schemas/Highway" } }, "text/json": { "schema": { "$ref": "#/components/schemas/Highway" } } } } } } }, "/api/Highways/{id}/attachments/{attachmentId}": { "get": { "tags": [ "Highways" ], "summary": "Metadata for a highway attachment; hidden routes remain private.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": "integer", "format": "int32" } }, { "name": "attachmentId", "in": "path", "required": true, "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "OK" } } } }, "/api/locations.php": { "get": { "tags": [ "LegacyApi" ], "summary": "Returns locations in the exact snake-case shape expected by historical PHP API clients.", "parameters": [ { "name": "x", "in": "query", "description": "Optional block X coordinate used with z to sort nearest locations first.", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" } }, { "name": "z", "in": "query", "description": "Optional block Z coordinate used with x to sort nearest locations first.", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" } }, { "name": "rows", "in": "query", "description": "Optional maximum row count, bounded to 10,000.", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" } }, { "name": "dimension", "in": "query", "description": "Legacy dimension code: 0 Overworld, 1 End, or -1 Nether.", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" } }, { "name": "warps", "in": "query", "description": "Set to 1 to retain only locations that have at least one warp.", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" } }, { "name": "search", "in": "query", "description": "Optional case-insensitive name fragment interpreted by SQLite `LIKE`.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "A cacheable compatibility projection with coordinates encoded as strings.", "content": { "text/plain": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/LegacyLocation" } } }, "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/LegacyLocation" } } }, "text/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/LegacyLocation" } } } } } } } }, "/api/locationCount.php": { "get": { "tags": [ "LegacyApi" ], "summary": "Returns the total location count using the legacy `locationCount` response property.", "responses": { "200": { "description": "A cacheable anonymous object containing the current persisted location count." } } } }, "/api/Locations": { "get": { "tags": [ "Locations" ], "summary": "Gets all locations with their warps", "responses": { "200": { "description": "List of locations with warps", "content": { "text/plain": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/Location" } } }, "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/Location" } } }, "text/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/Location" } } } } } } } }, "/api/Locations/map": { "get": { "tags": [ "Locations" ], "summary": "Map catalog with search text, warp names and public tile descriptors.", "description": "Detailed attachments, download provenance and 3D catalogs remain on the full location API.", "responses": { "200": { "description": "OK" } } } }, "/api/Locations/aliases": { "get": { "tags": [ "Locations" ], "summary": "Lists merged location IDs and UUIDs with their canonical location ID and Atlas URL, ordered by old ID.", "responses": { "200": { "description": "OK" } } } }, "/api/Locations/{id}": { "get": { "tags": [ "Locations" ], "summary": "Gets a location by ID with its warps. Merged IDs redirect permanently to the canonical location.", "parameters": [ { "name": "id", "in": "path", "description": "Location ID.", "required": true, "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" } } ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/Location" } }, "application/json": { "schema": { "$ref": "#/components/schemas/Location" } }, "text/json": { "schema": { "$ref": "#/components/schemas/Location" } } } } } } }, "/api/MapRenders": { "get": { "tags": [ "MapRenders" ], "summary": "GET /api/maprenders - published world renders (public map layers).", "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/MapRenderDto" } } }, "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/MapRenderDto" } } }, "text/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/MapRenderDto" } } } } } } } }, "/api/MapRenders/catalog": { "get": { "tags": [ "MapRenders" ], "summary": "GET /api/maprenders/catalog - a combined, external read-only view of every render the\r\natlas exposes: the dimension-level primary layers (full tile pyramids) and every\r\nper-location base render (with its owning location and block bounds).", "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/RenderCatalogResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/RenderCatalogResponse" } }, "text/json": { "schema": { "$ref": "#/components/schemas/RenderCatalogResponse" } } } } } } }, "/api/nocom": { "get": { "tags": [ "Nocom" ], "summary": "World Pulse provenance and complete-source Find discovery: counts, native dimension coverage, query API URLs, canonical citations, manifest/integrity links and access notes.", "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/NocomDataset" } }, "application/json": { "schema": { "$ref": "#/components/schemas/NocomDataset" } }, "text/json": { "schema": { "$ref": "#/components/schemas/NocomDataset" } } } } } } }, "/api/nocom/periods": { "get": { "tags": [ "Nocom" ], "summary": "At most 39 dimension/period aggregates; dates select overlapping fixed 30-day buckets, not exact-day counts.", "parameters": [ { "name": "dimension", "in": "query", "schema": { "type": "string" } }, { "name": "from", "in": "query", "schema": { "type": "string", "format": "date" } }, { "name": "to", "in": "query", "schema": { "type": "string", "format": "date" } } ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/NocomPeriod" } } }, "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/NocomPeriod" } } }, "text/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/NocomPeriod" } } } } } } } }, "/api/nocom/highways": { "get": { "tags": [ "Nocom" ], "summary": "Authors' historical highway observation aggregate: at most 136 rows per dimension, or 17 per compass direction. Not unique players or trips.", "parameters": [ { "name": "dimension", "in": "query", "schema": { "type": "string", "default": "nether" } }, { "name": "direction", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/NocomHighwayPeriod" } } }, "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/NocomHighwayPeriod" } } }, "text/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/NocomHighwayPeriod" } } } } } } } }, "/api/nocom/hits": { "get": { "tags": [ "NocomDaily" ], "summary": "Complete-source daily release, coverage, checksums and bulk-download manifest.", "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/NocomDailyDescriptor" } }, "application/json": { "schema": { "$ref": "#/components/schemas/NocomDailyDescriptor" } }, "text/json": { "schema": { "$ref": "#/components/schemas/NocomDailyDescriptor" } } } } } } }, "/api/nocom/hits/daily": { "get": { "tags": [ "NocomDaily" ], "parameters": [ { "name": "from", "in": "query", "required": true, "schema": { "type": "string", "format": "date" } }, { "name": "to", "in": "query", "required": true, "schema": { "type": "string", "format": "date" } }, { "name": "dimension", "in": "query", "schema": { "type": "string", "default": "overworld" } }, { "name": "minX", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" } }, { "name": "minZ", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" } }, { "name": "maxX", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" } }, { "name": "maxZ", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" } } ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/NocomDailySeries" } }, "application/json": { "schema": { "$ref": "#/components/schemas/NocomDailySeries" } }, "text/json": { "schema": { "$ref": "#/components/schemas/NocomDailySeries" } } } } } } }, "/api/nocom/hits/chunks": { "get": { "tags": [ "NocomDaily" ], "parameters": [ { "name": "date", "in": "query", "required": true, "schema": { "type": "string", "format": "date" } }, { "name": "minX", "in": "query", "required": true, "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" } }, { "name": "minZ", "in": "query", "required": true, "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" } }, { "name": "maxX", "in": "query", "required": true, "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" } }, { "name": "maxZ", "in": "query", "required": true, "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" } }, { "name": "dimension", "in": "query", "schema": { "type": "string", "default": "overworld" } }, { "name": "limit", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32", "default": 100 } }, { "name": "cursor", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/NocomDailyChunkPage" } }, "application/json": { "schema": { "$ref": "#/components/schemas/NocomDailyChunkPage" } }, "text/json": { "schema": { "$ref": "#/components/schemas/NocomDailyChunkPage" } } } } } } }, "/api/nocom/hits/tiles/range-v1/{releaseId}/{from}/{to}/{dimension}/{style}/{zoom}/{y}/{x}.png": { "get": { "tags": [ "NocomDailyTiles" ], "summary": "Inclusive date-range coverage union. Color is strongest daily intensity, not a sum of counts.", "parameters": [ { "name": "releaseId", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "from", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "to", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "dimension", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "style", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "zoom", "in": "path", "required": true, "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": "integer", "format": "int32" } }, { "name": "y", "in": "path", "required": true, "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": "integer", "format": "int32" } }, { "name": "x", "in": "path", "required": true, "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "OK" } } } }, "/api/nocom/hits/tiles/manifest": { "get": { "tags": [ "NocomDailyTiles" ], "summary": "Daily dimension coverage, checksums, tile templates and count provenance.", "responses": { "200": { "description": "OK" } } } }, "/api/nocom/hits/tiles/{releaseId}/{date}/{dimension}/{style}/{zoom}/{y}/{x}.png": { "get": { "tags": [ "NocomDailyTiles" ], "summary": "One immutable daily World Pulse PNG. Missing tiles have no recorded observations.", "parameters": [ { "name": "releaseId", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "date", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "dimension", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "style", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "zoom", "in": "path", "required": true, "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": "integer", "format": "int32" } }, { "name": "y", "in": "path", "required": true, "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": "integer", "format": "int32" } }, { "name": "x", "in": "path", "required": true, "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "OK" } } } }, "/api/nocom/find/storage": { "get": { "tags": [ "NocomFind" ], "summary": "Historical storage positions within a native-coordinate horizontal radius (1..8192). Max 25 records per page; not inventories. blockType: chest, trapped_chest, ender_chest or shulker_box (all colors).", "parameters": [ { "name": "x", "in": "query", "required": true, "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" } }, { "name": "z", "in": "query", "required": true, "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" } }, { "name": "dimension", "in": "query", "schema": { "type": "string", "default": "overworld" } }, { "name": "radius", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32", "default": 1024 } }, { "name": "blockType", "in": "query", "schema": { "type": "string" } }, { "name": "minY", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32", "default": 0 } }, { "name": "maxY", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32", "default": 255 } }, { "name": "hideChanged", "in": "query", "schema": { "type": "boolean", "default": false } }, { "name": "limit", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32", "default": 20 } }, { "name": "offset", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32", "default": 0 } } ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/NocomFindPage" } }, "application/json": { "schema": { "$ref": "#/components/schemas/NocomFindPage" } }, "text/json": { "schema": { "$ref": "#/components/schemas/NocomFindPage" } } } } } } }, "/api/nocom/find/signs": { "get": { "tags": [ "NocomFind" ], "summary": "Captured sign text: supply x and z for proximity, text (2..100 literal characters) for release-wide search, or both. Max 25 results; text excerpt is capped at 1024 characters with a truncation flag and full-history source link.", "parameters": [ { "name": "text", "in": "query", "schema": { "type": "string" } }, { "name": "x", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" } }, { "name": "z", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" } }, { "name": "dimension", "in": "query", "schema": { "type": "string", "default": "overworld" } }, { "name": "radius", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32", "default": 1024 } }, { "name": "minY", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32", "default": 0 } }, { "name": "maxY", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32", "default": 255 } }, { "name": "limit", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32", "default": 20 } }, { "name": "offset", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32", "default": 0 } } ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/NocomFindPage" } }, "application/json": { "schema": { "$ref": "#/components/schemas/NocomFindPage" } }, "text/json": { "schema": { "$ref": "#/components/schemas/NocomFindPage" } } } } } } }, "/api/nocom/find/portals": { "get": { "tags": [ "NocomFind" ], "summary": "Historical portal groups within a native-coordinate radius of representative blocks. Max 25 per page. No inferred Nether links or current portal status.", "parameters": [ { "name": "x", "in": "query", "required": true, "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" } }, { "name": "z", "in": "query", "required": true, "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" } }, { "name": "dimension", "in": "query", "schema": { "type": "string", "default": "overworld" } }, { "name": "radius", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32", "default": 1024 } }, { "name": "minY", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32", "default": 0 } }, { "name": "maxY", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32", "default": 255 } }, { "name": "limit", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32", "default": 20 } }, { "name": "offset", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32", "default": 0 } } ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/NocomFindPage" } }, "application/json": { "schema": { "$ref": "#/components/schemas/NocomFindPage" } }, "text/json": { "schema": { "$ref": "#/components/schemas/NocomFindPage" } } } } } } }, "/api/nocom/find/clusters": { "get": { "tags": [ "NocomFind" ], "summary": "Historical DBSCAN roots within a native-coordinate circle, nearest first. Follow nextOffset; footprint links expose all member chunks. Does not select footprints whose roots are outside the circle.", "parameters": [ { "name": "x", "in": "query", "required": true, "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" } }, { "name": "z", "in": "query", "required": true, "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" } }, { "name": "dimension", "in": "query", "schema": { "type": "string", "default": "overworld" } }, { "name": "radius", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32", "default": 1024 } }, { "name": "limit", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32", "default": 20 } }, { "name": "offset", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32", "default": 0 } } ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/NocomClusterPage" } }, "application/json": { "schema": { "$ref": "#/components/schemas/NocomClusterPage" } }, "text/json": { "schema": { "$ref": "#/components/schemas/NocomClusterPage" } } } } } } }, "/api/nocom/find/rare": { "get": { "tags": [ "NocomRareBlocks" ], "summary": "Page through all qualifying observed blocks, optionally filtered by kind, Y range and native horizontal circle. Only Overworld block coverage exists. These are not player inventories or confirmed surviving structures.", "parameters": [ { "name": "dimension", "in": "query", "schema": { "type": "string", "default": "overworld" } }, { "name": "kind", "in": "query", "schema": { "type": "string" } }, { "name": "x", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" } }, { "name": "z", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" } }, { "name": "radius", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32", "default": 1024 } }, { "name": "minY", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32", "default": 0 } }, { "name": "maxY", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32", "default": 255 } }, { "name": "limit", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32", "default": 20 } }, { "name": "offset", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32", "default": 0 } } ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/NocomRareBlockPage" } }, "application/json": { "schema": { "$ref": "#/components/schemas/NocomRareBlockPage" } }, "text/json": { "schema": { "$ref": "#/components/schemas/NocomRareBlockPage" } } } } } } }, "/api/nocom/find/sign-history": { "get": { "tags": [ "NocomSignHistory" ], "summary": "Search within individual captured text versions. UTC filters match actual reads; phrase, allWords and whole-word/username modes. Optional native viewport bounds, changed text and stable paging; max 25 results.", "parameters": [ { "name": "text", "in": "query", "schema": { "type": "string" } }, { "name": "dimension", "in": "query", "schema": { "type": "string", "default": "overworld" } }, { "name": "match", "in": "query", "schema": { "type": "string", "default": "phrase" } }, { "name": "from", "in": "query", "schema": { "type": "string", "format": "date" } }, { "name": "to", "in": "query", "schema": { "type": "string", "format": "date" } }, { "name": "changedOnly", "in": "query", "schema": { "type": "boolean", "default": false } }, { "name": "minX", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" } }, { "name": "minZ", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" } }, { "name": "maxX", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" } }, { "name": "maxZ", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" } }, { "name": "sort", "in": "query", "schema": { "type": "string", "default": "newest" } }, { "name": "limit", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32", "default": 20 } }, { "name": "offset", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32", "default": 0 } } ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/NocomSignSearch" } }, "application/json": { "schema": { "$ref": "#/components/schemas/NocomSignSearch" } }, "text/json": { "schema": { "$ref": "#/components/schemas/NocomSignSearch" } } } } } } }, "/api/nocom/find/sign-history/{id}": { "get": { "tags": [ "NocomSignHistory" ], "summary": "Complete captured text history for a sign ID returned by search, including every read timestamp and conflicting same-time text. Missing IDs return 404.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/NocomSignHistory" } }, "application/json": { "schema": { "$ref": "#/components/schemas/NocomSignHistory" } }, "text/json": { "schema": { "$ref": "#/components/schemas/NocomSignHistory" } } } } } } }, "/api/nocom/find/special": { "get": { "tags": [ "NocomSpecialBlock" ], "summary": "Only verified illegal-spawner positions; ordinary spawners are excluded. End gateways have zero recorded observations. Optional native horizontal proximity and paging; source and WDL evidence are kept separate.", "parameters": [ { "name": "kind", "in": "query", "schema": { "type": "string", "default": "illegalSpawner" } }, { "name": "dimension", "in": "query", "schema": { "type": "string", "default": "overworld" } }, { "name": "x", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" } }, { "name": "z", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" } }, { "name": "radius", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32", "default": 1024 } }, { "name": "limit", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32", "default": 20 } }, { "name": "offset", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32", "default": 0 } } ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/NocomSpecialBlockPage" } }, "application/json": { "schema": { "$ref": "#/components/schemas/NocomSpecialBlockPage" } }, "text/json": { "schema": { "$ref": "#/components/schemas/NocomSpecialBlockPage" } } } } } } }, "/api/popularity": { "get": { "tags": [ "Popularity" ], "parameters": [ { "name": "days", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32", "default": 30 } } ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/PopularitySnapshot" } }, "application/json": { "schema": { "$ref": "#/components/schemas/PopularitySnapshot" } }, "text/json": { "schema": { "$ref": "#/components/schemas/PopularitySnapshot" } } } } } } }, "/api/renders": { "get": { "tags": [ "Renders" ], "summary": "GET /api/renders - every per-location render with its owning location, optionally filtered.", "parameters": [ { "name": "locationId", "in": "query", "description": "When set, only renders for this location.", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" } }, { "name": "dimension", "in": "query", "description": "When set, only renders in this dimension (0 Overworld, 1 Nether, 2 End).", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" } }, { "name": "scale", "in": "query", "description": "When set, only renders with this scale label (case-insensitive, e.g. \"256k\").", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "description": "Maximum rows to return (default 500, clamped 1..1000).", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" } }, { "name": "offset", "in": "query", "description": "Rows to skip for paging (default 0).", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" } } ], "responses": { "200": { "description": "The matching renders, ordered by dimension then id.", "content": { "text/plain": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/LocationRenderDto" } } }, "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/LocationRenderDto" } } }, "text/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/LocationRenderDto" } } } } } } } }, "/api/renders/{id}": { "get": { "tags": [ "Renders" ], "summary": "GET /api/renders/{id} - a single render with its owning location.", "parameters": [ { "name": "id", "in": "path", "description": "The render id.", "required": true, "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "The render, or 404 when it does not exist.", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/LocationRenderDto" } }, "application/json": { "schema": { "$ref": "#/components/schemas/LocationRenderDto" } }, "text/json": { "schema": { "$ref": "#/components/schemas/LocationRenderDto" } } } } } } }, "/api/locations/{locationId}/renders": { "get": { "tags": [ "Renders" ], "summary": "GET /api/locations/{locationId}/renders - the renders attached to a location.", "parameters": [ { "name": "locationId", "in": "path", "description": "The owning location's row id.", "required": true, "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "The location's renders (possibly empty), or 404 when the location does not exist.", "content": { "text/plain": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/LocationRenderDto" } } }, "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/LocationRenderDto" } } }, "text/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/LocationRenderDto" } } } } } } } }, "/api/Warps": { "get": { "tags": [ "Warps" ], "summary": "Returns Archive warp records, optionally filtered by owning location.", "parameters": [ { "name": "locationId", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" } }, { "name": "limit", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32", "default": 500 } }, { "name": "offset", "in": "query", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32", "default": 0 } } ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/WarpRecord" } } }, "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/WarpRecord" } } }, "text/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/WarpRecord" } } } } } } } }, "/api/Warps/{id}": { "get": { "tags": [ "Warps" ], "summary": "Returns one Archive warp with owning-location context.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/WarpRecord" } }, "application/json": { "schema": { "$ref": "#/components/schemas/WarpRecord" } }, "text/json": { "schema": { "$ref": "#/components/schemas/WarpRecord" } } } } } } }, "/api/warps/{id}/world-download": { "get": { "tags": [ "WorldDownloads" ], "summary": "Returns metadata for one downloadable collector WDL without exposing its host path.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/WorldDownloadRecord" } }, "application/json": { "schema": { "$ref": "#/components/schemas/WorldDownloadRecord" } }, "text/json": { "schema": { "$ref": "#/components/schemas/WorldDownloadRecord" } } } } } } }, "/api/warps/{id}/world-download.zip": { "get": { "tags": [ "WorldDownloads" ], "summary": "Streams the immutable exact-footprint Minecraft Java save associated with an Archive warp.\r\nSupports byte ranges and a digest ETag so clients can resume and caches can revalidate safely.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "OK" } } } }, "/api/renders/{id}/world-download": { "get": { "tags": [ "WorldDownloads" ], "summary": "Returns metadata for a verified preserved source WDL used by a pre-Archive render.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/WorldDownloadRecord" } }, "application/json": { "schema": { "$ref": "#/components/schemas/WorldDownloadRecord" } }, "text/json": { "schema": { "$ref": "#/components/schemas/WorldDownloadRecord" } } } } } } }, "/api/renders/{id}/world-download.zip": { "get": { "tags": [ "WorldDownloads" ], "summary": "Streams the immutable source WDL associated with a verified public pre-Archive render.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "OK" } } } }, "/api/maprenders/{id}/world-download.zip": { "get": { "tags": [ "WorldDownloads" ], "summary": "Downloads a preserved source survey without inventing a location for it.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "Attachment": { "required": [ "locationRowid", "fileName", "path" ], "type": "object", "properties": { "id": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Unique identifier for the attachment.", "format": "int32" }, "apiUrl": { "type": [ "null", "string" ], "description": "Public API URL for this attachment metadata record." }, "locationRowid": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Gets or sets the ID of the associated location.", "format": "int32" }, "fileName": { "maxLength": 255, "minLength": 0, "type": [ "null", "string" ], "description": "Name of the file." }, "path": { "maxLength": 500, "minLength": 0, "type": [ "null", "string" ], "description": "Path to the file / URL." }, "mediaType": { "maxLength": 32, "minLength": 0, "type": [ "null", "string" ], "description": "Normalized media kind: Image, Video, Wiki, Link, Timeline, or Article." }, "thumbnailPath": { "maxLength": 500, "minLength": 0, "type": [ "null", "string" ], "description": "Gets or sets an optional lightweight HTTPS preview image." }, "sourceUrl": { "maxLength": 500, "minLength": 0, "type": [ "null", "string" ], "description": "Original publication page retained for provenance." }, "caption": { "maxLength": 500, "minLength": 0, "type": [ "null", "string" ], "description": "A concise public caption." }, "attribution": { "maxLength": 500, "minLength": 0, "type": [ "null", "string" ], "description": "Gets or sets creator, archive, and license credit." }, "dateAddedUtc": { "type": [ "null", "string" ], "description": "Date and time when the attachment was added (UTC)." } }, "description": "Represents a file attachment associated with a location." }, "AttachmentRecord": { "required": [ "locationRowid", "fileName", "path" ], "type": "object", "properties": { "locationName": { "type": "string", "description": "Owning location's display name." }, "dimension": { "description": "Owning location's dimension.", "$ref": "#/components/schemas/Dimension" }, "locationUrl": { "type": "string", "description": "Owning location's canonical entity URL." }, "locationRecordUrl": { "type": "string", "description": "Owning location semantic record for machine identity and provenance." }, "locationInteractiveUrl": { "type": "string", "description": "Preferred owning location destination for a human." }, "locationApiUrl": { "type": "string", "description": "Owning location's public API URL." }, "id": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Unique identifier for the attachment.", "format": "int32" }, "apiUrl": { "type": [ "null", "string" ], "description": "Public API URL for this attachment metadata record." }, "locationRowid": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Gets or sets the ID of the associated location.", "format": "int32" }, "fileName": { "maxLength": 255, "minLength": 0, "type": [ "null", "string" ], "description": "Name of the file." }, "path": { "maxLength": 500, "minLength": 0, "type": [ "null", "string" ], "description": "Path to the file / URL." }, "mediaType": { "maxLength": 32, "minLength": 0, "type": [ "null", "string" ], "description": "Normalized media kind: Image, Video, Wiki, Link, Timeline, or Article." }, "thumbnailPath": { "maxLength": 500, "minLength": 0, "type": [ "null", "string" ], "description": "Gets or sets an optional lightweight HTTPS preview image." }, "sourceUrl": { "maxLength": 500, "minLength": 0, "type": [ "null", "string" ], "description": "Original publication page retained for provenance." }, "caption": { "maxLength": 500, "minLength": 0, "type": [ "null", "string" ], "description": "A concise public caption." }, "attribution": { "maxLength": 500, "minLength": 0, "type": [ "null", "string" ], "description": "Gets or sets creator, archive, and license credit." }, "dateAddedUtc": { "type": [ "null", "string" ], "description": "Date and time when the attachment was added (UTC)." } }, "description": "A public attachment record with enough location context for independent API consumers." }, "Dimension": { "type": "integer", "description": "Represents the different dimensions in the game." }, "Group": { "type": "object", "properties": { "attachments": { "type": [ "null", "array" ], "items": { "$ref": "#/components/schemas/Attachment" }, "description": "Linked media and sources. Omit on updates to preserve existing links; send an empty list to clear them." }, "id": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Gets or sets the group's persistent identifier.", "format": "int32" }, "canonicalUrl": { "type": [ "null", "string" ], "description": "Gets or sets the preferred human/search URL for this group." }, "recordUrl": { "type": [ "null", "string" ], "description": "Stable provenance alias whose HTML permanently redirects to the interactive group page." }, "interactiveUrl": { "type": [ "null", "string" ], "description": "Gets or sets the interactive Atlas group-page URL." }, "apiUrl": { "type": [ "null", "string" ], "description": "Gets or sets the public API URL for this group record." }, "name": { "type": "string", "description": "Gets or sets the group's public name." }, "aliases": { "type": "array", "items": { "type": "string" }, "description": "Gets or sets reviewed alternate names; this public projection is derived from the canonical name." }, "type": { "description": "Gets or sets the group's primary activity category.", "$ref": "#/components/schemas/GroupType" }, "description": { "type": [ "null", "string" ], "description": "Gets or sets an optional description of the group." }, "color": { "type": [ "null", "string" ], "description": "Optional render hint (hex) for markers/labels." }, "wikiUrl": { "type": [ "null", "string" ], "description": "Gets or sets an optional absolute URL for the group's wiki article." }, "websiteUrl": { "type": [ "null", "string" ], "description": "Gets or sets the group's official website, when one is known." }, "discordUrl": { "type": [ "null", "string" ], "description": "Gets or sets the group's public Discord invite, when one is known and still current." }, "logoUrl": { "type": [ "null", "string" ], "description": "Gets or sets a public logo or representative emblem URL." }, "logoSourceUrl": { "type": [ "null", "string" ], "description": "Gets or sets the page that identifies the source and licensing context of the logo." }, "founded": { "type": [ "null", "string" ], "description": "Gets or sets a human-readable founding date because many historical dates are approximate." }, "status": { "type": [ "null", "string" ], "description": "Gets or sets the group's documented state, such as Active, Inactive, or Disbanded." }, "locationCount": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Gets or sets the number of Atlas locations explicitly attributed to the group.", "format": "int32" }, "highwayCount": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Gets or sets the number of Atlas highways explicitly attributed to the group.", "format": "int32" }, "locations": { "type": "array", "items": { "$ref": "#/components/schemas/GroupLocationSummary" }, "description": "Gets or sets locations explicitly attributed to this group on the detail endpoint." }, "highways": { "type": "array", "items": { "$ref": "#/components/schemas/GroupHighwaySummary" }, "description": "Gets or sets highways explicitly attributed to this group on the detail endpoint." }, "dateAddedUtc": { "type": "string", "description": "Gets or sets the UTC time at which the group was added to the Atlas.", "format": "date-time" }, "modifiedUtc": { "type": "string", "description": "Gets or sets when the public group record was last materially changed.", "format": "date-time" } }, "description": "A 2b2t group/organisation used to attribute highways and bases (GAMEPLAN §15)." }, "GroupHighwaySummary": { "type": "object", "properties": { "highwayId": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Gets or sets the highway identifier.", "format": "int32" }, "canonicalUrl": { "type": "string", "description": "Preferred human/search highway page." }, "interactiveUrl": { "type": "string", "description": "Interactive Atlas highway page." }, "recordUrl": { "type": "string", "description": "Stable provenance alias whose HTML permanently redirects to the interactive highway page." }, "apiUrl": { "type": [ "null", "string" ], "description": "Public JSON endpoint; HighwayApiUrl remains a compatibility alias." }, "highwayApiUrl": { "type": "string", "description": "Gets or sets the public API URL for the highway record." }, "mapUrl": { "type": "string", "description": "Gets or sets a map URL centered on the highway's dimension." }, "name": { "type": "string", "description": "Gets or sets the public highway name." }, "dimension": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Gets or sets the Minecraft dimension identifier.", "format": "int32" }, "role": { "type": "string", "description": "Gets or sets this group's documented role on the route." } }, "description": "A compact, navigable highway attributed to a group." }, "GroupLocationSummary": { "type": "object", "properties": { "locationId": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Gets or sets the Atlas location identifier.", "format": "int32" }, "locationUrl": { "type": "string", "description": "Gets or sets the preferred human/search URL for the location." }, "locationRecordUrl": { "type": "string", "description": "Stable provenance alias whose HTML permanently redirects to the owning location page." }, "locationInteractiveUrl": { "type": "string", "description": "Gets or sets the interactive Atlas URL for the location." }, "locationApiUrl": { "type": "string", "description": "Gets or sets the public API URL for the location." }, "name": { "type": "string", "description": "Gets or sets the public location name." }, "role": { "type": "string", "description": "Gets or sets the group's role at the location." }, "dimension": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Gets or sets the Minecraft dimension identifier.", "format": "int32" }, "x": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Gets or sets the location's X coordinate.", "format": "int32" }, "z": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Gets or sets the location's Z coordinate.", "format": "int32" }, "renderCount": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Gets or sets the number of public renders linked to the location.", "format": "int32" } }, "description": "A compact, navigable Atlas location attributed to a group." }, "GroupType": { "type": "integer", "description": "What a group primarily does on 2b2t." }, "Highway": { "type": "object", "properties": { "pageUrl": { "type": [ "null", "string" ], "description": "Public highway detail page." }, "canonicalUrl": { "type": [ "null", "string" ], "description": "Preferred human/search page; use RecordUrl for semantic identity and provenance." }, "interactiveUrl": { "type": [ "null", "string" ], "description": "Preferred human destination; PageUrl remains a compatibility alias." }, "recordUrl": { "type": [ "null", "string" ], "description": "Stable provenance alias whose HTML permanently redirects to the interactive highway page." }, "attachments": { "type": [ "null", "array" ], "items": { "$ref": "#/components/schemas/Attachment" }, "description": "Linked media and sources. Omit on updates to preserve existing links; send an empty list to clear them." }, "editVersion": { "type": [ "null", "string" ], "description": "Opaque current-state token required for edits; reload after a conflict." }, "id": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Gets or sets the highway's persistent identifier.", "format": "int32" }, "apiUrl": { "type": [ "null", "string" ], "description": "Gets or sets the public API URL for this highway record." }, "mapUrl": { "type": [ "null", "string" ], "description": "Gets or sets an interactive Atlas map URL for this highway." }, "name": { "type": "string", "description": "Gets or sets the highway's public name." }, "slug": { "type": "string", "description": "Gets or sets the stable URL-safe identifier used by API records and seeds." }, "dimension": { "description": "Dimension the geometry belongs to.", "$ref": "#/components/schemas/Dimension" }, "category": { "description": "Gets or sets the highway's geometric category.", "$ref": "#/components/schemas/HighwayCategory" }, "points": { "type": "array", "items": { "$ref": "#/components/schemas/HighwayPoint" }, "description": "Ordered path in native dimension coordinates." }, "ringRadius": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "description": "Radius (Nether units) for ring / diamond-ring roads.", "format": "int32" }, "width": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Walkable path width (blocks).", "format": "int32" }, "height": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "description": "Recorded vertical clearance / tunnel headroom (blocks); null means not recorded.", "format": "int32" }, "yLevel": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "description": "Build height (roof ≈128, lava ≈10 …).", "format": "int32" }, "paved": { "type": "boolean", "description": "Gets or sets whether the route has a deliberately constructed surface." }, "pavingMaterial": { "description": "Gets or sets the predominant material used for the paved surface.", "$ref": "#/components/schemas/PavingMaterial" }, "walls": { "type": "boolean", "description": "Gets or sets whether the route has side walls." }, "enclosed": { "type": "boolean", "description": "Gets or sets whether the route is enclosed by walls and a ceiling." }, "isRoofHighway": { "type": "boolean", "description": "Gets or sets whether the route runs on the Nether roof." }, "lit": { "type": "boolean", "description": "Gets or sets whether the route has installed lighting." }, "status": { "description": "Gets or sets the recorded construction or maintenance condition.", "$ref": "#/components/schemas/HighwayStatus" }, "builderGroupId": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "description": "Attributed builder group (FK → Group), if known.", "format": "int32" }, "builderGroupName": { "type": [ "null", "string" ], "description": "Resolved builder-group name for display (server-populated; not stored here)." }, "builderGroups": { "type": "array", "items": { "$ref": "#/components/schemas/HighwayGroupAttribution" }, "description": "All reviewed builder, maintainer, and contributor attributions for this route." }, "lengthBlocks": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "description": "Computed/stored path length in blocks.", "format": "int32" }, "description": { "type": [ "null", "string" ], "description": "Gets or sets an optional description of the route and its history." }, "wikiUrl": { "type": [ "null", "string" ], "description": "Gets or sets an optional absolute URL for the highway's wiki article." }, "videoUrl": { "type": [ "null", "string" ], "description": "Gets or sets an optional absolute URL for related video coverage." }, "color": { "type": [ "null", "string" ], "description": "Render hint; falls back to Category defaults when null." }, "displayWeight": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "description": "Gets or sets an optional map line weight override.", "format": "int32" }, "visibility": { "description": "Gets or sets whether the record is eligible for public listing.", "$ref": "#/components/schemas/HighwayVisibility" }, "reviewStatus": { "description": "Gets or sets the record's moderation state.", "$ref": "#/components/schemas/ReviewStatus" }, "createdByUserId": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "description": "Gets or sets the identifier of the user who created the record.", "format": "int32" }, "lastEditedByUserId": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "description": "Gets or sets the identifier of the user who most recently edited the record.", "format": "int32" }, "dateAddedUtc": { "type": "string", "description": "Gets or sets the UTC time at which the record was added.", "format": "date-time" }, "lastVerifiedUtc": { "type": [ "null", "string" ], "description": "Gets or sets the UTC time at which the route was last verified in-game.", "format": "date-time" } }, "description": "A 2b2t highway (lore-accurate; see GAMEPLAN §14). Geometry is stored in\r\nnative dimension coordinates. Rich attributes (material, walls, status…) let the\r\nmap show what kind of road it is and approved editors keep it current." }, "HighwayCategory": { "type": "integer", "description": "Geometry / role of a highway (drives default colour + weight)." }, "HighwayGroupAttribution": { "type": "object", "properties": { "groupId": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Gets or sets the attributed group identifier.", "format": "int32" }, "groupUrl": { "type": "string", "description": "Gets or sets the group's preferred human/search URL." }, "groupInteractiveUrl": { "type": "string", "description": "Interactive group page." }, "groupRecordUrl": { "type": "string", "description": "Stable provenance alias whose HTML permanently redirects to the interactive group page." }, "groupApiUrl": { "type": "string", "description": "Gets or sets the group's public API URL." }, "groupName": { "type": "string", "description": "Gets or sets the attributed group's public name." }, "role": { "type": "string", "description": "Gets or sets its role, such as Primary builder, Predecessor, or Contributor." }, "evidence": { "type": [ "null", "string" ], "description": "Gets or sets a concise public source note." } }, "description": "A reviewed group contribution to one highway." }, "HighwayPoint": { "type": "object", "properties": { "x": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Gets or sets the X coordinate in the highway's native dimension.", "format": "int32" }, "z": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Gets or sets the Z coordinate in the highway's native dimension.", "format": "int32" } }, "description": "A single point on a highway path in the route's native dimension coordinates." }, "HighwayStatus": { "type": "integer", "description": "Build/maintenance condition of a highway." }, "HighwayVisibility": { "type": "integer", "description": "Public visibility of a highway record." }, "LegacyLocation": { "type": "object", "properties": { "location_uuid": { "type": "string", "description": "Gets the stable Atlas location UUID used by legacy clients and warp associations." }, "user_uuid": { "type": "string", "description": "Gets the historical submitter UUID field, which this read-only adapter leaves empty." }, "name": { "type": "string", "description": "Gets the public Atlas location name." }, "x": { "type": "string", "description": "Gets the native-dimension block X coordinate encoded as legacy JSON text." }, "y": { "type": "string", "description": "Gets the Minecraft elevation encoded as legacy JSON text." }, "z": { "type": "string", "description": "Gets the native-dimension block Z coordinate encoded as legacy JSON text." }, "description": { "type": "string", "description": "Gets the public historical description, normalized to an empty string when absent." }, "tags": { "type": "string", "description": "Gets the legacy free-form tag text used for location discovery." }, "time_added": { "type": "string", "description": "Gets the persisted location creation timestamp in its historical text representation." }, "wiki": { "type": "string", "description": "Gets the optional public 2b2t wiki reference, normalized to an empty string." }, "video_url": { "type": "string", "description": "Gets the optional public video reference, normalized to an empty string." }, "end_dimension": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Gets 1 for End locations and 0 for all other dimensions, matching the legacy contract.", "format": "int32" }, "warps": { "type": [ "null", "array" ], "items": { "$ref": "#/components/schemas/LegacyWarp" }, "description": "Gets associated public warp names, or `null` when none exist." } }, "description": "Wire-compatible location payload for consumers of the retired PHP implementation." }, "LegacyWarp": { "required": [ "name" ], "type": "object", "properties": { "name": { "type": "string", "description": "The historical public warp command name." } }, "description": "Represents a warp name in the minimal legacy nested payload." }, "Location": { "required": [ "name", "dimension", "x", "z" ], "type": "object", "properties": { "rowid": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Gets or sets the unique identifier for the location.", "format": "int32" }, "canonicalUrl": { "type": [ "null", "string" ], "description": "Gets or sets the preferred search URL. Retained for compatibility; use InteractiveUrl for human links." }, "recordUrl": { "type": [ "null", "string" ], "description": "Gets or sets the stable provenance URL whose HTML permanently redirects to the interactive page." }, "interactiveUrl": { "type": [ "null", "string" ], "description": "Gets or sets the interactive Atlas detail-page URL for this location." }, "apiUrl": { "type": [ "null", "string" ], "description": "Gets or sets the public API URL for this location record." }, "locationUuid": { "maxLength": 36, "minLength": 0, "type": [ "null", "string" ], "description": "Gets or sets the UUID from the original database." }, "name": { "maxLength": 255, "minLength": 0, "type": "string", "description": "Gets or sets the name of the location." }, "description": { "maxLength": 2000, "minLength": 0, "type": [ "null", "string" ], "description": "Gets or sets the description of the location." }, "tags": { "maxLength": 1000, "minLength": 0, "type": [ "null", "string" ], "description": "Gets or sets the tags for the location." }, "dimension": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Gets or sets the dimension of the location (0=Overworld, 1=Nether, 2=End).", "format": "int32" }, "dimensionName": { "type": [ "null", "string" ], "description": "Gets the name of the dimension." }, "x": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Gets or sets the X coordinate of the location.", "format": "int32" }, "y": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "description": "Gets or sets the Y coordinate of the location.", "format": "int32" }, "z": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Gets or sets the Z coordinate of the location.", "format": "int32" }, "wiki": { "maxLength": 250, "minLength": 0, "type": [ "null", "string" ], "description": "Gets or sets the wiki URL for the location." }, "videoUrl": { "maxLength": 255, "minLength": 0, "type": [ "null", "string" ], "description": "Gets or sets the video URL for the location." }, "endDimension": { "type": "boolean", "description": "Gets or sets whether this is an End dimension location." }, "dateAddedUtc": { "type": "string", "description": "Legacy recorded wall-clock value; timezone may be unknown. Retained for compatibility. Use dateAddedInstantUtc (nullable) for a verified absolute instant and dateAddedTimezoneKnown to distinguish unknown timezone.", "deprecated": true }, "dateAddedInstantUtc": { "type": [ "null", "string" ], "description": "Known creation instant, or null for legacy values with unrecorded timezone.", "format": "date-time" }, "dateAddedTimezoneKnown": { "type": "boolean", "description": "Whether the legacy creation time has a recorded timezone." }, "modifiedUtc": { "type": "string", "description": "Gets or sets when this public location record last changed in a way that affects its entity page.", "format": "date-time" }, "warps": { "type": "array", "items": { "$ref": "#/components/schemas/Warp" }, "description": "Gets or sets the list of warps associated with the location." }, "attachments": { "type": "array", "items": { "$ref": "#/components/schemas/Attachment" }, "description": "Gets or sets the list of attachments associated with the location." }, "renders": { "type": "array", "items": { "$ref": "#/components/schemas/Render" }, "description": "Gets or sets the list of renders associated with the location." }, "groups": { "type": [ "null", "array" ], "items": { "$ref": "#/components/schemas/LocationGroupAttribution" }, "description": "Gets or sets explicit group attributions for this build. A null value on an update means\r\nthat an older client did not send attribution data and existing links should be preserved." }, "groupNames": { "type": [ "null", "string" ], "description": "Gets the reviewed group names as a single searchable value for directory clients." }, "warpCount": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Gets the number of warps associated with this location.\r\nThis property is sortable and filterable in data grids.", "format": "int32" }, "attachmentCount": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Gets the number of attachments associated with this location.\r\nThis property is sortable and filterable in data grids.", "format": "int32" }, "renderCount": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Gets the number of renders associated with this location.\r\nThis property is sortable and filterable in data grids.", "format": "int32" }, "blueMapReadyRenderCount": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Gets the number of distinct public renders with a validated BlueMap view.\r\nThis includes both Archive-warp-backed captures and older/manual preserved WDL renders.\r\nA validated relative path is the same availability signal used by the location-page 3D control.", "format": "int32" }, "totalRelatedItems": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Gets the total number of related items (warps + attachments + renders).\r\nThis property is sortable and filterable in data grids.", "format": "int32" }, "relatedContentSummary": { "type": [ "null", "string" ], "description": "Gets a summary string of all related content counts.\r\nUseful for display purposes." } }, "description": "Represents a location in the game world." }, "LocationGroupAttribution": { "type": "object", "properties": { "groupId": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Gets or sets the attributed group's identifier.", "format": "int32" }, "groupUrl": { "type": "string", "description": "Gets or sets the group's preferred human/search URL." }, "groupRecordUrl": { "type": "string", "description": "Stable provenance alias whose HTML permanently redirects to the interactive group page." }, "groupInteractiveUrl": { "type": "string", "description": "Gets or sets the group's interactive Atlas URL." }, "groupApiUrl": { "type": "string", "description": "Gets or sets the group's public API URL." }, "groupName": { "type": "string", "description": "Gets or sets the attributed group's public name." }, "role": { "type": "string", "description": "Gets or sets the group's role at the location." }, "color": { "type": [ "null", "string" ], "description": "Gets or sets the group's display color." }, "logoUrl": { "type": [ "null", "string" ], "description": "Gets or sets the group's optional logo URL." } }, "description": "Public group attribution embedded in a location record." }, "LocationRenderDto": { "type": "object", "properties": { "renderId": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Render's unique identifier.", "format": "int32" }, "apiUrl": { "type": "string", "description": "Public API URL for this render record." }, "locationId": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Owning location's row id.", "format": "int32" }, "locationUrl": { "type": "string", "description": "Owning location's canonical entity URL." }, "locationRecordUrl": { "type": "string", "description": "Owning location semantic record for machine identity and provenance." }, "locationInteractiveUrl": { "type": "string", "description": "Preferred owning location destination for a human." }, "locationApiUrl": { "type": "string", "description": "Owning location's public API URL." }, "locationName": { "type": "string", "description": "Owning location's name." }, "locationX": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Owning location's block X coordinate (in the location's own dimension).", "format": "int32" }, "locationZ": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Owning location's block Z coordinate (in the location's own dimension).", "format": "int32" }, "dimension": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Render's dimension (0 Overworld, 1 Nether, 2 End).", "format": "int32" }, "dimensionName": { "type": "string", "description": "Human-readable dimension name." }, "name": { "type": "string", "description": "Render's display name." }, "description": { "type": [ "null", "string" ], "description": "Optional render description." }, "source": { "type": [ "null", "string" ], "description": "Stable acquisition channel code for this render." }, "archiveWarpId": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "description": "Exact Archive warp row represented by this render, when applicable.", "format": "int32" }, "archiveWarpApiUrl": { "type": [ "null", "string" ], "description": "Public API URL for the represented Archive warp, when applicable." }, "archiveWarpName": { "type": [ "null", "string" ], "description": "Exact copyable Archive warp name represented by this render." }, "isSinglePlayerConcept": { "type": "boolean", "description": "Gets whether this is a preserved single-player concept rather than a live 2b2t snapshot." }, "scale": { "type": "string", "description": "Render scale label (e.g. \"256k\")." }, "tileUrlTemplate": { "type": "string", "description": "Gets or sets the XYZ tile URL template (with `{z}/{y}/{x}` placeholders)." }, "hasDayNight": { "type": "boolean", "description": "Whether the tile template contains a `{dn}` day/night token." }, "maxNativeZoom": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "description": "Deepest zoom level backed by native tile files (deeper zooms upscale).", "format": "int32" }, "coordinateScheme": { "type": [ "null", "string" ], "description": "Coordinate and tile-layout contract used by string LocationRenderDto.TileUrlTemplate." }, "worldDownloadDate": { "type": [ "null", "string" ], "description": "World-download date the render was produced from, when known." }, "worldDownloadUrl": { "type": [ "null", "string" ], "description": "A public ZIP URL for the preserved source WDL when available." }, "worldDownloadMetadataUrl": { "type": [ "null", "string" ], "description": "Source WDL metadata URL when available." }, "worldDownloadScope": { "type": [ "null", "string" ], "description": "Source WDL scope when available." }, "worldDownloadSha256": { "type": [ "null", "string" ], "description": "Source WDL SHA-256 digest when available." }, "worldDownloadSource": { "type": [ "null", "string" ], "description": "Source WDL provenance when available." }, "blueMapUrl": { "type": [ "null", "string" ], "description": "Public interactive 3D view URL when a validated BlueMap derivative exists." }, "blueMapPath": { "type": [ "null", "string" ], "description": "Gets or sets the API-relative path for the interactive 3D view." }, "blueMapProfileVersion": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "description": "Renderer profile version used by the 3D derivative.", "format": "int32" }, "minX": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "description": "Inclusive minimum rendered block X coordinate.", "format": "int32" }, "minZ": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "description": "Inclusive minimum rendered block Z coordinate.", "format": "int32" }, "maxXExclusive": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "description": "Exclusive maximum rendered block X coordinate.", "format": "int32" }, "maxZExclusive": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "description": "Exclusive maximum rendered block Z coordinate.", "format": "int32" }, "dateAddedUtc": { "type": [ "null", "string" ], "description": "Gets or sets the UTC time the render was added, in round-trip text form." } }, "description": "A per-location base render (a tile pyramid anchored at one base's coordinates) together with the owning\r\nlocation's identity and position. This is the external-facing shape for the `/api/renders` resource:\r\nit carries everything a map or tooling client needs to place and fetch a render's tiles - the tile URL\r\ntemplate, coordinate scheme, native zoom depth, block bounds, and the location it belongs to - without a\r\nsecond lookup. These are distinct from the dimension-level primary layers served by `/api/maprenders`." }, "MapRenderDto": { "type": "object", "properties": { "id": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Gets or sets the render's persistent identifier.", "format": "int32" }, "coordinateScheme": { "type": "string", "description": "Native tile addressing contract, including signed sparse tile indices." }, "minX": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "description": "Captured minimum native block X, inclusive.", "format": "int32" }, "minZ": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "description": "Captured minimum native block Z, inclusive.", "format": "int32" }, "maxXExclusive": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "description": "Captured maximum native block X, exclusive.", "format": "int32" }, "maxZExclusive": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "description": "Captured maximum native block Z, exclusive.", "format": "int32" }, "defaultEnabled": { "type": "boolean", "description": "Enable this bounded layer on a fresh map; users can turn it off." }, "archiveSha256": { "type": [ "null", "string" ], "description": "SHA-256 of the immutable preserved source WDL." }, "worldDownloadUrl": { "type": [ "null", "string" ], "description": "Public preserved-source download, when available." }, "slug": { "type": "string", "description": "Stable key for idempotent upsert by the ingestor (e.g. \"overworld-1m-2026\")." }, "name": { "type": "string", "description": "Label shown in the render picker." }, "dimension": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "0 = Overworld, 1 = Nether, 2 = End (matches the DB + client DIM_INDEX).", "format": "int32" }, "scale": { "type": "string", "description": "Human scale tag (e.g. \"1M\", \"256k\")." }, "urlTemplate": { "type": "string", "description": "Tile URL template containing `{z}/{y}/{x}`, and optionally a `{dn}`\r\ntoken replaced with `day`/`night` when bool MapRenderDto.HasDayNight is set." }, "hasDayNight": { "type": "boolean", "description": "True if the render has separate day/night tile sets (uses `{dn}`)." }, "maxNativeZoom": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "description": "Deepest native zoom if the pyramid is shallower than the map max (else null).", "format": "int32" }, "worldDownloadDate": { "type": [ "null", "string" ], "description": "ISO date of the underlying world download (drives the time slider)." }, "source": { "type": [ "null", "string" ], "description": "Attribution / provenance (e.g. \"2b2t.place 1M²\")." }, "sortOrder": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Ordering within a dimension's picker (lower = earlier).", "format": "int32" }, "isPublished": { "type": "boolean", "description": "Only published renders are returned on the public endpoint." }, "dateAddedUtc": { "type": "string", "description": "Gets or sets the UTC time at which the render was registered.", "format": "date-time" } }, "description": "A dimension-level world render (a full tile pyramid), as opposed to a\r\nper-location base render. These are what the map's render picker stacks\r\n(e.g. \"256k (2021)\", \"1M² (2026)\"). The ingest pipeline auto-registers these\r\nso new world downloads appear as map layers without any manual admin step\r\n(GAMEPLAN §6b / Phase 1)." }, "NocomBlockBounds": { "required": [ "minX", "minZ", "maxXInclusive", "maxZInclusive" ], "type": "object", "properties": { "minX": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int64" }, "minZ": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int64" }, "maxXInclusive": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int64" }, "maxZInclusive": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int64" } } }, "NocomClusterContext": { "required": [ "id", "x", "z", "rootDistanceBlocks", "memberChunks", "bounds", "canonicalUrl", "footprintJsonUrl" ], "type": "object", "properties": { "id": { "type": "string" }, "x": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "z": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "rootDistanceBlocks": { "pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$", "type": [ "number", "string" ], "format": "double" }, "memberChunks": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int64" }, "bounds": { "$ref": "#/components/schemas/NocomBlockBounds" }, "canonicalUrl": { "type": "string" }, "footprintJsonUrl": { "type": "string" } } }, "NocomClusterPage": { "required": [ "coverage", "total", "limit", "items", "sourceJsonUrl", "interpretation" ], "type": "object", "properties": { "coverage": { "type": "string" }, "total": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int64" }, "limit": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/NocomClusterContext" } }, "sourceJsonUrl": { "type": "string" }, "interpretation": { "type": "string" }, "offset": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32", "default": 0 }, "nextOffset": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "format": "int32" } } }, "NocomDailyChunk": { "required": [ "chunkX", "chunkZ", "bounds", "observations" ], "type": "object", "properties": { "chunkX": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "chunkZ": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "bounds": { "$ref": "#/components/schemas/NocomBlockBounds" }, "observations": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int64" }, "extendsBeyondNominalWorldBorder": { "type": "boolean" } } }, "NocomDailyChunkPage": { "required": [ "dimension", "date", "bounds", "limit", "nextCursor", "sourceSha256", "canonicalUrl", "downloadCsvUrl", "interpretation", "items" ], "type": "object", "properties": { "dimension": { "type": "string" }, "date": { "type": "string", "format": "date" }, "bounds": { "$ref": "#/components/schemas/NocomBlockBounds" }, "limit": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "nextCursor": { "type": [ "null", "string" ] }, "sourceSha256": { "type": "string" }, "canonicalUrl": { "type": "string" }, "downloadCsvUrl": { "type": "string" }, "interpretation": { "type": "string" }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/NocomDailyChunk" } } } }, "NocomDailyCount": { "required": [ "date", "observations", "observedChunks", "coverage", "downloadCsvUrl" ], "type": "object", "properties": { "date": { "type": "string", "format": "date" }, "observations": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int64" }, "observedChunks": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int64" }, "coverage": { "type": "string" }, "downloadCsvUrl": { "type": [ "null", "string" ] } } }, "NocomDailyCoverage": { "required": [ "dimension", "firstDay", "lastDay", "observations", "dailyChunkRows", "recordedDays" ], "type": "object", "properties": { "dimension": { "type": "string" }, "firstDay": { "type": "string", "format": "date" }, "lastDay": { "type": "string", "format": "date" }, "observations": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int64" }, "dailyChunkRows": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int64" }, "recordedDays": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" } } }, "NocomDailyDescriptor": { "required": [ "id", "complete", "sourceSha256", "sourceRows", "observations", "manifestUrl", "dailyApiUrl", "chunksApiUrl", "tileManifestUrl", "dimensions", "canonicalUrl", "sourceUrl", "interpretation" ], "type": "object", "properties": { "id": { "type": "string" }, "complete": { "type": "boolean" }, "sourceSha256": { "type": "string" }, "sourceRows": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int64" }, "observations": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int64" }, "manifestUrl": { "type": "string" }, "dailyApiUrl": { "type": "string" }, "chunksApiUrl": { "type": "string" }, "tileManifestUrl": { "type": [ "null", "string" ] }, "dimensions": { "type": "array", "items": { "$ref": "#/components/schemas/NocomDailyCoverage" } }, "canonicalUrl": { "type": "string" }, "sourceUrl": { "type": "string" }, "interpretation": { "type": "string" } } }, "NocomDailySeries": { "required": [ "dimension", "from", "to", "bounds", "sourceSha256", "canonicalUrl", "manifestUrl", "interpretation", "days" ], "type": "object", "properties": { "dimension": { "type": "string" }, "from": { "type": "string", "format": "date" }, "to": { "type": "string", "format": "date" }, "bounds": { "oneOf": [ { "type": "null" }, { "$ref": "#/components/schemas/NocomBlockBounds" } ] }, "sourceSha256": { "type": "string" }, "canonicalUrl": { "type": "string" }, "manifestUrl": { "type": "string" }, "interpretation": { "type": "string" }, "days": { "type": "array", "items": { "$ref": "#/components/schemas/NocomDailyCount" } } } }, "NocomDataset": { "required": [ "id", "name", "url", "sourceUrl", "manifestUrl", "periodsApiUrl", "highwayActivityApiUrl", "tilesGeneratedAtUtc", "exploitPatchedDate", "groupedRows", "observations", "periodLayerCount", "dimensions", "groupedSourceSha256", "groupedServerScope", "highwaySourceSha256", "highwaySourceScope", "attribution", "caveats" ], "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "url": { "type": "string" }, "sourceUrl": { "type": "string" }, "manifestUrl": { "type": "string" }, "periodsApiUrl": { "type": "string" }, "highwayActivityApiUrl": { "type": "string" }, "tilesGeneratedAtUtc": { "type": "string", "format": "date-time" }, "exploitPatchedDate": { "type": "string", "format": "date" }, "groupedRows": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int64" }, "observations": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int64" }, "periodLayerCount": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "dimensions": { "type": "array", "items": { "$ref": "#/components/schemas/NocomDimension" } }, "groupedSourceSha256": { "type": "string" }, "groupedServerScope": { "type": "string" }, "highwaySourceSha256": { "type": "string" }, "highwaySourceScope": { "type": "string" }, "attribution": { "type": "string" }, "caveats": { "type": "array", "items": { "type": "string" } }, "canonicalUrl": { "type": [ "null", "string" ] }, "find": { "$ref": "#/components/schemas/NocomFindRelease" }, "dailyHitsApiUrl": { "type": [ "null", "string" ] }, "rareBlocksApiUrl": { "type": [ "null", "string" ] }, "clustersApiUrl": { "type": [ "null", "string" ] }, "signHistoryApiUrl": { "type": [ "null", "string" ] }, "specialBlocksApiUrl": { "type": [ "null", "string" ] }, "rawSourceReleaseUrl": { "type": [ "null", "string" ] }, "rawSourceSchemaUrl": { "type": [ "null", "string" ] }, "sourceProducts": { "type": [ "null", "array" ], "items": { "$ref": "#/components/schemas/NocomSourceProduct" } } } }, "NocomDimension": { "required": [ "dimension", "atlasDimension", "sourceDimension", "periodCount", "groupedRows", "observations", "firstBucketStartUtc", "lastBucketEndExclusiveUtc", "totalTileUrlTemplate", "minNativeUrlZoom", "maxNativeUrlZoom" ], "type": "object", "properties": { "dimension": { "type": "string" }, "atlasDimension": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "sourceDimension": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "periodCount": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "groupedRows": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int64" }, "observations": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int64" }, "firstBucketStartUtc": { "type": "string", "format": "date-time" }, "lastBucketEndExclusiveUtc": { "type": "string", "format": "date-time" }, "totalTileUrlTemplate": { "type": "string" }, "minNativeUrlZoom": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "maxNativeUrlZoom": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "canonicalUrl": { "type": [ "null", "string" ] } } }, "NocomFindCounts": { "required": [ "storagePositions", "signPositions", "signObservations", "clusterRoots", "portalGroups", "portalBlocks" ], "type": "object", "properties": { "storagePositions": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int64" }, "signPositions": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int64" }, "signObservations": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int64" }, "clusterRoots": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int64" }, "portalGroups": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int64" }, "portalBlocks": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int64" } } }, "NocomFindCoverage": { "required": [ "dimension", "sourceDimension", "products" ], "type": "object", "properties": { "dimension": { "type": "string" }, "sourceDimension": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "products": { "type": "array", "items": { "type": "string" } } } }, "NocomFindPage": { "required": [ "kind", "dimension", "coverage", "x", "z", "radius", "offset", "limit", "total", "nextOffset", "releaseSha256", "canonicalUrl", "sourceUrl", "attribution", "interpretation", "items" ], "type": "object", "properties": { "kind": { "type": "string" }, "dimension": { "type": "string" }, "coverage": { "type": "string" }, "x": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "format": "int32" }, "z": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "format": "int32" }, "radius": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "offset": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "limit": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "total": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int64" }, "nextOffset": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "format": "int32" }, "releaseSha256": { "type": "string" }, "canonicalUrl": { "type": "string" }, "sourceUrl": { "type": "string" }, "attribution": { "type": "string" }, "interpretation": { "type": "string" }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/NocomFindRecord" } } } }, "NocomFindRecord": { "required": [ "id", "kind", "dimension", "sourceDimension", "x", "y", "z", "distanceBlocks", "blockType", "text", "textTruncated", "firstObservedUtc", "lastObservedUtc", "changed", "portalBlockCount", "minY", "maxY", "textVersions", "lastRecordedBlockState", "lastStateObservedUtc", "conflictingLastState", "canonicalUrl", "sourceJsonUrl" ], "type": "object", "properties": { "id": { "type": "string" }, "kind": { "type": "string" }, "dimension": { "type": "string" }, "sourceDimension": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "x": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "y": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "z": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "distanceBlocks": { "pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$", "type": [ "null", "number", "string" ], "format": "double" }, "blockType": { "type": [ "null", "string" ] }, "text": { "type": [ "null", "string" ] }, "textTruncated": { "type": "boolean" }, "firstObservedUtc": { "type": "string", "format": "date-time" }, "lastObservedUtc": { "type": "string", "format": "date-time" }, "changed": { "type": [ "null", "boolean" ] }, "portalBlockCount": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "format": "int32" }, "minY": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "format": "int32" }, "maxY": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "format": "int32" }, "textVersions": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "format": "int32" }, "lastRecordedBlockState": { "type": [ "null", "string" ] }, "lastStateObservedUtc": { "type": [ "null", "string" ], "format": "date-time" }, "conflictingLastState": { "type": [ "null", "boolean" ] }, "canonicalUrl": { "type": "string" }, "sourceJsonUrl": { "type": "string" } } }, "NocomFindRelease": { "required": [ "id", "canonicalUrl", "manifestUrl", "manifestSha256", "integrityUrl", "integritySha256", "sourceUrl", "sourceSha256", "sourceRows", "complete", "blockObservationFromUtc", "blockObservationToUtc", "counts", "coverage", "attribution", "accessNotes" ], "type": "object", "properties": { "id": { "type": "string" }, "canonicalUrl": { "type": "string" }, "manifestUrl": { "type": "string" }, "manifestSha256": { "type": "string" }, "integrityUrl": { "type": "string" }, "integritySha256": { "type": "string" }, "sourceUrl": { "type": "string" }, "sourceSha256": { "type": "string" }, "sourceRows": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int64" }, "complete": { "type": "boolean" }, "blockObservationFromUtc": { "type": "string", "format": "date-time" }, "blockObservationToUtc": { "type": "string", "format": "date-time" }, "counts": { "$ref": "#/components/schemas/NocomFindCounts" }, "coverage": { "type": "array", "items": { "$ref": "#/components/schemas/NocomFindCoverage" } }, "attribution": { "type": "string" }, "accessNotes": { "type": "array", "items": { "type": "string" } }, "storageApiUrl": { "type": [ "null", "string" ] }, "signsApiUrl": { "type": [ "null", "string" ] }, "portalsApiUrl": { "type": [ "null", "string" ] } }, "description": "Small verified release descriptor, not the full tile inventory or raw corpus." }, "NocomHighwayPeriod": { "required": [ "dimension", "atlasDimension", "direction", "directionX", "directionZ", "periodStartUtc", "periodEndExclusiveUtc", "observations" ], "type": "object", "properties": { "dimension": { "type": "string" }, "atlasDimension": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "direction": { "type": "string" }, "directionX": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "directionZ": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "periodStartUtc": { "type": "string", "format": "date-time" }, "periodEndExclusiveUtc": { "type": "string", "format": "date-time" }, "observations": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int64" }, "canonicalUrl": { "type": [ "null", "string" ] } } }, "NocomPeriod": { "required": [ "key", "dimension", "atlasDimension", "sourceDimension", "periodStartUtc", "periodEndExclusiveUtc", "groupedRows", "observations", "observedExtentBlocks", "tileUrlTemplate", "minNativeUrlZoom", "maxNativeUrlZoom" ], "type": "object", "properties": { "key": { "type": "string" }, "dimension": { "type": "string" }, "atlasDimension": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "sourceDimension": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "periodStartUtc": { "type": "string", "format": "date-time" }, "periodEndExclusiveUtc": { "type": "string", "format": "date-time" }, "groupedRows": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int64" }, "observations": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int64" }, "observedExtentBlocks": { "$ref": "#/components/schemas/NocomBlockBounds" }, "tileUrlTemplate": { "type": "string" }, "minNativeUrlZoom": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "maxNativeUrlZoom": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "canonicalUrl": { "type": [ "null", "string" ] } } }, "NocomRareBlock": { "required": [ "id", "kind", "x", "y", "z", "observations", "firstObservedUtc", "lastObservedUtc", "states", "distanceBlocks", "sourceJsonUrl", "canonicalUrl" ], "type": "object", "properties": { "id": { "type": "string" }, "kind": { "type": "string" }, "x": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "y": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "z": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "observations": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int64" }, "firstObservedUtc": { "type": "string", "format": "date-time" }, "lastObservedUtc": { "type": "string", "format": "date-time" }, "states": { "type": "array", "items": { "type": "string" } }, "distanceBlocks": { "pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$", "type": [ "null", "number", "string" ], "format": "double" }, "sourceJsonUrl": { "type": "string" }, "canonicalUrl": { "type": "string" } } }, "NocomRareBlockPage": { "required": [ "dimension", "coverage", "total", "limit", "offset", "nextOffset", "manifestUrl", "sourceSha256", "sourceRows", "interpretation", "items" ], "type": "object", "properties": { "dimension": { "type": "string" }, "coverage": { "type": "string" }, "total": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "limit": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "offset": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "nextOffset": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "format": "int32" }, "manifestUrl": { "type": "string" }, "sourceSha256": { "type": "string" }, "sourceRows": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int64" }, "interpretation": { "type": "string" }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/NocomRareBlock" } } } }, "NocomSignHistory": { "required": [ "id", "dimension", "x", "y", "z", "observations", "distinctTexts", "conflictingSameTimeText", "versions", "sourceSha256", "sourceJsonUrl", "canonicalUrl", "interpretation" ], "type": "object", "properties": { "id": { "type": "string" }, "dimension": { "type": "string" }, "x": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "y": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "z": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "observations": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "distinctTexts": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "conflictingSameTimeText": { "type": "boolean" }, "versions": { "type": "array", "items": { "$ref": "#/components/schemas/NocomSignVersion" } }, "sourceSha256": { "type": "string" }, "sourceJsonUrl": { "type": "string" }, "canonicalUrl": { "type": "string" }, "interpretation": { "type": "string" } } }, "NocomSignMatch": { "required": [ "id", "x", "y", "z", "text", "textTruncated", "distinctTexts", "matchingObservations", "firstMatchUtc", "lastMatchUtc", "matchingVersions", "historyApiUrl", "canonicalUrl" ], "type": "object", "properties": { "id": { "type": "string" }, "x": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "y": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "z": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "text": { "type": "string" }, "textTruncated": { "type": "boolean" }, "distinctTexts": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "matchingObservations": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "firstMatchUtc": { "type": "string", "format": "date-time" }, "lastMatchUtc": { "type": "string", "format": "date-time" }, "matchingVersions": { "type": "array", "items": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" } }, "historyApiUrl": { "type": "string" }, "canonicalUrl": { "type": "string" } } }, "NocomSignSearch": { "required": [ "dimension", "coverage", "text", "match", "from", "to", "changedOnly", "sort", "total", "limit", "offset", "nextOffset", "sourceSha256", "interpretation", "items" ], "type": "object", "properties": { "dimension": { "type": "string" }, "coverage": { "type": "string" }, "text": { "type": [ "null", "string" ] }, "match": { "type": "string" }, "from": { "type": [ "null", "string" ], "format": "date" }, "to": { "type": [ "null", "string" ], "format": "date" }, "changedOnly": { "type": "boolean" }, "sort": { "type": "string" }, "total": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "limit": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "offset": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "nextOffset": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "format": "int32" }, "sourceSha256": { "type": "string" }, "interpretation": { "type": "string" }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/NocomSignMatch" } } } }, "NocomSignVersion": { "required": [ "number", "lines", "observedUtc" ], "type": "object", "properties": { "number": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "lines": { "type": "array", "items": { "type": "string" } }, "observedUtc": { "type": "array", "items": { "type": "string", "format": "date-time" } } } }, "NocomSourceProduct": { "required": [ "file", "contains", "atlasAccess", "interpretation" ], "type": "object", "properties": { "file": { "type": "string" }, "contains": { "type": "string" }, "atlasAccess": { "type": "string" }, "interpretation": { "type": "string" } } }, "NocomSpecialBlock": { "required": [ "id", "kind", "dimension", "x", "y", "z", "observations", "firstObservedUtc", "lastObservedUtc", "states", "verification", "locationId", "locationName", "captureDate", "worldDownloadMetadataUrl", "worldDownloadSha256", "mobType" ], "type": "object", "properties": { "id": { "type": "string" }, "kind": { "type": "string" }, "dimension": { "type": "string" }, "x": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "y": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "z": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "observations": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int64" }, "firstObservedUtc": { "type": "string", "format": "date-time" }, "lastObservedUtc": { "type": "string", "format": "date-time" }, "states": { "type": "array", "items": { "type": "string" } }, "verification": { "type": "string" }, "locationId": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "locationName": { "type": "string" }, "captureDate": { "type": "string", "format": "date" }, "worldDownloadMetadataUrl": { "type": "string" }, "worldDownloadSha256": { "type": "string" }, "mobType": { "type": "string" }, "canonicalUrl": { "type": [ "null", "string" ] }, "locationUrl": { "type": [ "null", "string" ] } } }, "NocomSpecialBlockPage": { "required": [ "dimension", "kind", "coverage", "completeSourceScan", "sourceRows", "sourceSha256", "allSpawnerPositions", "reviewedSpawnerPositions", "reviewedCaptures", "verifiedIllegalSpawnerPositions", "endGatewayPositions", "total", "limit", "offset", "nextOffset", "interpretation", "items" ], "type": "object", "properties": { "dimension": { "type": "string" }, "kind": { "type": "string" }, "coverage": { "type": "string" }, "completeSourceScan": { "type": "boolean" }, "sourceRows": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int64" }, "sourceSha256": { "type": "string" }, "allSpawnerPositions": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "reviewedSpawnerPositions": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "reviewedCaptures": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "verifiedIllegalSpawnerPositions": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "endGatewayPositions": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "total": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "limit": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "offset": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "nextOffset": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "format": "int32" }, "interpretation": { "type": "string" }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/NocomSpecialBlock" } } } }, "PavingMaterial": { "type": "integer", "description": "Paving material - durability + prestige on 2b2t." }, "PopularDay": { "required": [ "date", "views" ], "type": "object", "properties": { "date": { "type": "string" }, "views": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int64" } } }, "PopularEntry": { "required": [ "id", "name", "url", "canonicalUrl", "views" ], "type": "object", "properties": { "id": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "name": { "type": "string" }, "url": { "type": "string" }, "canonicalUrl": { "type": "string" }, "views": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int64" }, "recordUrl": { "type": "string", "description": "Semantic record for machine identity and provenance." }, "interactiveUrl": { "type": "string", "description": "Preferred public destination for a human." } } }, "PopularitySnapshot": { "required": [ "days", "fromUtc", "updatedUtc", "trackingStartedUtc", "totalViews", "locations", "groups", "highways", "dailyViews" ], "type": "object", "properties": { "days": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "fromUtc": { "type": "string", "format": "date-time" }, "updatedUtc": { "type": "string", "format": "date-time" }, "trackingStartedUtc": { "type": "string", "format": "date-time" }, "totalViews": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int64" }, "locations": { "type": "array", "items": { "$ref": "#/components/schemas/PopularEntry" } }, "groups": { "type": "array", "items": { "$ref": "#/components/schemas/PopularEntry" } }, "highways": { "type": "array", "items": { "$ref": "#/components/schemas/PopularEntry" } }, "dailyViews": { "type": "array", "items": { "$ref": "#/components/schemas/PopularDay" } } } }, "Render": { "required": [ "locationRowid", "name", "dimension", "scale", "tilesPath", "dateAddedUtc" ], "type": "object", "properties": { "id": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Gets or sets the unique identifier for the render.", "format": "int32" }, "apiUrl": { "type": [ "null", "string" ], "description": "Gets or sets the public API URL for this render record." }, "locationRowid": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Gets or sets the ID of the associated location.", "format": "int32" }, "name": { "maxLength": 255, "minLength": 0, "type": "string", "description": "Gets or sets the name of the render." }, "description": { "maxLength": 1000, "minLength": 0, "type": [ "null", "string" ], "description": "Gets or sets the description of the render." }, "source": { "type": [ "null", "string" ], "description": "Gets or sets the stable acquisition channel code (for example, archive-collector)." }, "archiveWarpId": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "description": "Gets or sets the exact Archive warp whose WDL produced this render.", "format": "int32" }, "archiveWarp": { "oneOf": [ { "type": "null" }, { "description": "Gets or sets the exact Archive warp whose WDL produced this render.", "$ref": "#/components/schemas/Warp" } ] }, "isSinglePlayerConcept": { "type": "boolean", "description": "Gets whether this is a preserved single-player concept rather than a live 2b2t snapshot." }, "dimension": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Gets or sets the dimension of the render.", "format": "int32" }, "scale": { "maxLength": 50, "minLength": 0, "type": "string", "description": "Gets or sets the scale of the render." }, "tilesPath": { "maxLength": 500, "minLength": 0, "type": "string", "description": "Gets or sets the path to the render tiles." }, "hasDayNight": { "type": "boolean", "description": "Gets or sets whether the tile template contains separate day and night pyramids." }, "previewImagePath": { "maxLength": 500, "minLength": 0, "type": [ "null", "string" ], "description": "Gets or sets the path to the preview image." }, "worldDownloadDate": { "type": [ "null", "string" ], "description": "Gets or sets the world download date." }, "captureDatePrecision": { "type": [ "null", "string" ], "description": "Source precision: day, month, year, or unknown." }, "worldDownloadUrl": { "type": [ "null", "string" ], "description": "Gets or sets a public download URL for the preserved source WDL when this render is not Archive-warp-backed." }, "worldDownloadMetadataUrl": { "type": [ "null", "string" ], "description": "Gets or sets the public metadata URL for the preserved source WDL." }, "worldDownloadScope": { "type": [ "null", "string" ], "description": "Gets or sets the source-world scope, such as `preserved-render-source`." }, "worldDownloadSha256": { "type": [ "null", "string" ], "description": "Gets or sets the immutable SHA-256 digest of the preserved source WDL." }, "worldDownloadSource": { "type": [ "null", "string" ], "description": "Gets or sets the human-readable provenance recorded when the source WDL was ingested." }, "blueMapUrl": { "type": [ "null", "string" ], "description": "Gets or sets the public interactive 3D view URL when a validated BlueMap derivative exists." }, "blueMapPath": { "type": [ "null", "string" ], "description": "Gets or sets the same 3D view as an API-relative path for local and alternate-host clients." }, "blueMapProfileVersion": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "description": "Gets or sets the renderer profile version used by the advertised 3D derivative.", "format": "int32" }, "minX": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "description": "Gets or sets the inclusive minimum rendered block X coordinate.", "format": "int32" }, "minZ": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "description": "Gets or sets the inclusive minimum rendered block Z coordinate.", "format": "int32" }, "maxXExclusive": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "description": "Gets or sets the exclusive maximum rendered block X coordinate.", "format": "int32" }, "maxZExclusive": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "description": "Gets or sets the exclusive maximum rendered block Z coordinate.", "format": "int32" }, "maxNativeZoom": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "description": "Gets or sets the deepest zoom level backed by native tile files.", "format": "int32" }, "coordinateScheme": { "type": [ "null", "string" ], "description": "Gets or sets the coordinate and tile-layout contract used by string Render.TilesPath." }, "dateAddedUtc": { "type": "string", "description": "Gets or sets the date and time when the render was added (UTC)." }, "archiveWarps": { "type": "array", "items": { "$ref": "#/components/schemas/Warp" }, "description": "Gets or sets the list of archive warps associated with this render." } }, "description": "Represents a render associated with a location." }, "RenderCatalogEntry": { "type": "object", "properties": { "kind": { "type": "string", "description": "`primary` for a full-map layer, `location` for a per-location capture." }, "id": { "type": "string", "description": "Stable identifier: the layer slug for primary, `render-{id}` for location." }, "defaultEnabled": { "type": "boolean", "description": "Whether fresh map views select this bounded layer automatically." }, "worldDownloadUrl": { "type": [ "null", "string" ], "description": "Public source WDL when preserved." }, "name": { "type": "string", "description": "Display name (e.g. \"256k (2021)\" or \"+Z Border 2019-04-20\")." }, "dimension": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "0 = Overworld, 1 = Nether, 2 = End.", "format": "int32" }, "scale": { "type": [ "null", "string" ], "description": "Human scale tag (e.g. \"256k\", \"7k\"), when known." }, "tileUrlTemplate": { "type": [ "null", "string" ], "description": "Tile URL template with `{z}/{y}/{x}`, and `{dn}` (→ `day`/`night`)\r\nwhen bool RenderCatalogEntry.HasDayNight is set. Null for proxied layers (see string? RenderCatalogEntry.CoordinateScheme)." }, "hasDayNight": { "type": "boolean", "description": "True when the render has separate day/night tile sets (uses `{dn}`)." }, "maxNativeZoom": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "description": "Deepest native zoom before the client upscales, when the pyramid is shallow.", "format": "int32" }, "coordinateScheme": { "type": [ "null", "string" ], "description": "Tile contract: `atlas-sparse-v1`, `xyz-v1`, `atlas-nether-legacy-v1`, or `place-proxy`." }, "source": { "type": [ "null", "string" ], "description": "Attribution / provenance (e.g. \"2b2t.place\")." }, "worldDownloadDate": { "type": [ "null", "string" ], "description": "ISO date of the underlying world download, when known." }, "locationId": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "description": "Owning location row id (location renders only).", "format": "int32" }, "locationName": { "type": [ "null", "string" ], "description": "Owning location name (location renders only)." }, "locationX": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "description": "Owning location block X (location renders only).", "format": "int32" }, "locationZ": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "description": "Owning location block Z (location renders only).", "format": "int32" }, "minX": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "description": "Inclusive minimum rendered block X (location renders only).", "format": "int32" }, "minZ": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "description": "Inclusive minimum rendered block Z (location renders only).", "format": "int32" }, "maxXExclusive": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "description": "Exclusive maximum rendered block X (location renders only).", "format": "int32" }, "maxZExclusive": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "description": "Exclusive maximum rendered block Z (location renders only).", "format": "int32" } }, "description": "One render in the external catalog. Location-only fields are null for primary layers." }, "RenderCatalogResponse": { "type": "object", "properties": { "primary": { "type": "array", "items": { "$ref": "#/components/schemas/RenderCatalogEntry" }, "description": "Dimension-level full-map renders (the base layers of the map picker)." }, "locations": { "type": "array", "items": { "$ref": "#/components/schemas/RenderCatalogEntry" }, "description": "Per-location base renders (one or more captures anchored to a location)." } }, "description": "A combined, external-facing catalog of every render the atlas exposes: the\r\ndimension-level primary layers (full tile pyramids the map picker stacks)\r\nand the per-location base renders (captures anchored to a single location).\r\nServed read-only from `GET /api/maprenders/catalog` for third-party consumers." }, "ReviewStatus": { "type": "integer", "description": "Moderation state of a highway record (see GAMEPLAN §15)." }, "Warp": { "required": [ "name" ], "type": "object", "properties": { "id": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Gets or sets the unique identifier for the warp.", "format": "int32" }, "apiUrl": { "type": [ "null", "string" ], "description": "Gets or sets the public API URL for this Archive warp record." }, "warpUuid": { "maxLength": 36, "minLength": 0, "type": [ "null", "string" ], "description": "Gets or sets the UUID from the original database." }, "locationUuidFk": { "maxLength": 36, "minLength": 0, "type": [ "null", "string" ], "description": "Gets or sets the location UUID foreign key." }, "locationRowid": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "description": "Gets or sets the foreign key to the location.", "format": "int32" }, "name": { "maxLength": 255, "minLength": 0, "type": "string", "description": "Gets or sets the warp name." }, "isSinglePlayerConcept": { "type": "boolean", "description": "Gets whether Archive provenance explicitly marks this as a single-player concept build." }, "timeAdded": { "type": "string", "description": "Gets or sets the date and time when the warp was added.", "format": "date-time" }, "archiveSha256": { "type": [ "null", "string" ], "description": "Gets or sets the immutable WDL digest associated with this Archive warp." }, "worldDownloadUrl": { "type": [ "null", "string" ], "description": "Gets or sets the public URL of the immutable, bounded Minecraft world ZIP." }, "worldDownloadMetadataUrl": { "type": [ "null", "string" ], "description": "Gets or sets the public JSON metadata URL for the bounded world download." }, "worldDownloadScope": { "type": [ "null", "string" ], "description": "Gets or sets the capture scope, currently `bounded-footprint` for collector WDLs." }, "worldDownloadDate": { "type": [ "null", "string" ], "description": "Gets or sets the declared date of this warp's world download." }, "captureDatePrecision": { "type": [ "null", "string" ], "description": "Source precision: day, month, year, or unknown." }, "source": { "type": [ "null", "string" ], "description": "Gets or sets the human-readable provenance attribution for this warp." }, "archiveX": { "pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$", "type": [ "null", "number", "string" ], "description": "Gets or sets the live Archive landing X coordinate for this WDL warp.", "format": "double" }, "archiveY": { "pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$", "type": [ "null", "number", "string" ], "description": "Gets or sets the live Archive landing Y coordinate for this WDL warp.", "format": "double" }, "archiveZ": { "pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$", "type": [ "null", "number", "string" ], "description": "Gets or sets the live Archive landing Z coordinate for this WDL warp.", "format": "double" } }, "description": "Represents a named legacy warp associated with an Atlas location." }, "WarpRecord": { "required": [ "name" ], "type": "object", "properties": { "locationName": { "type": "string", "description": "Gets or sets the owning location's display name." }, "dimension": { "description": "Gets or sets the owning location's Minecraft dimension.", "$ref": "#/components/schemas/Dimension" }, "locationUrl": { "type": "string", "description": "Gets or sets the owning location's canonical entity URL." }, "locationRecordUrl": { "type": "string", "description": "Owning location semantic record for machine identity and provenance." }, "locationInteractiveUrl": { "type": "string", "description": "Preferred owning location destination for a human." }, "locationApiUrl": { "type": "string", "description": "Gets or sets the owning location's public API URL." }, "id": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Gets or sets the unique identifier for the warp.", "format": "int32" }, "apiUrl": { "type": [ "null", "string" ], "description": "Gets or sets the public API URL for this Archive warp record." }, "warpUuid": { "maxLength": 36, "minLength": 0, "type": [ "null", "string" ], "description": "Gets or sets the UUID from the original database." }, "locationUuidFk": { "maxLength": 36, "minLength": 0, "type": [ "null", "string" ], "description": "Gets or sets the location UUID foreign key." }, "locationRowid": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "description": "Gets or sets the foreign key to the location.", "format": "int32" }, "name": { "maxLength": 255, "minLength": 0, "type": "string", "description": "Gets or sets the warp name." }, "isSinglePlayerConcept": { "type": "boolean", "description": "Gets whether Archive provenance explicitly marks this as a single-player concept build." }, "timeAdded": { "type": "string", "description": "Gets or sets the date and time when the warp was added.", "format": "date-time" }, "archiveSha256": { "type": [ "null", "string" ], "description": "Gets or sets the immutable WDL digest associated with this Archive warp." }, "worldDownloadUrl": { "type": [ "null", "string" ], "description": "Gets or sets the public URL of the immutable, bounded Minecraft world ZIP." }, "worldDownloadMetadataUrl": { "type": [ "null", "string" ], "description": "Gets or sets the public JSON metadata URL for the bounded world download." }, "worldDownloadScope": { "type": [ "null", "string" ], "description": "Gets or sets the capture scope, currently `bounded-footprint` for collector WDLs." }, "worldDownloadDate": { "type": [ "null", "string" ], "description": "Gets or sets the declared date of this warp's world download." }, "captureDatePrecision": { "type": [ "null", "string" ], "description": "Source precision: day, month, year, or unknown." }, "source": { "type": [ "null", "string" ], "description": "Gets or sets the human-readable provenance attribution for this warp." }, "archiveX": { "pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$", "type": [ "null", "number", "string" ], "description": "Gets or sets the live Archive landing X coordinate for this WDL warp.", "format": "double" }, "archiveY": { "pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$", "type": [ "null", "number", "string" ], "description": "Gets or sets the live Archive landing Y coordinate for this WDL warp.", "format": "double" }, "archiveZ": { "pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$", "type": [ "null", "number", "string" ], "description": "Gets or sets the live Archive landing Z coordinate for this WDL warp.", "format": "double" } }, "description": "A public Archive warp record with its owning Atlas location and navigable links." }, "WorldDownloadBounds": { "type": "object", "properties": { "minX": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Gets or sets the inclusive minimum block X coordinate.", "format": "int32" }, "minZ": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Gets or sets the inclusive minimum block Z coordinate.", "format": "int32" }, "maxXExclusive": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Gets or sets the exclusive maximum block X coordinate.", "format": "int32" }, "maxZExclusive": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Gets or sets the exclusive maximum block Z coordinate.", "format": "int32" } }, "description": "Half-open native-dimension block bounds retained with a bounded world download." }, "WorldDownloadRecord": { "type": "object", "properties": { "warpId": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "description": "Gets or sets the Archive warp identifier.", "format": "int32" }, "warpName": { "type": [ "null", "string" ], "description": "Gets or sets the Archive warp name." }, "renderId": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "description": "Gets or sets the source render identifier for a preserved pre-Archive WDL.", "format": "int32" }, "renderName": { "type": [ "null", "string" ], "description": "Gets or sets the source render name for a preserved pre-Archive WDL." }, "isSinglePlayerConcept": { "type": "boolean", "description": "Gets whether this source is a preserved single-player concept rather than a live 2b2t snapshot." }, "locationId": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Gets or sets the owning Atlas location identifier.", "format": "int32" }, "locationName": { "type": "string", "description": "Gets or sets the owning Atlas location name." }, "locationUrl": { "type": "string", "description": "Gets or sets the canonical location entity URL." }, "locationRecordUrl": { "type": "string", "description": "Owning location semantic record for machine identity and provenance." }, "locationInteractiveUrl": { "type": "string", "description": "Preferred owning location destination for a human." }, "locationApiUrl": { "type": "string", "description": "Gets or sets the public location API URL." }, "metadataUrl": { "type": "string", "description": "Gets or sets this record's public metadata URL." }, "downloadUrl": { "type": "string", "description": "Gets or sets the immutable ZIP download URL." }, "fileName": { "type": "string", "description": "Gets or sets the suggested download file name." }, "contentType": { "type": "string", "description": "Gets or sets the ZIP media type." }, "byteLength": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Gets or sets the ZIP size in bytes.", "format": "int64" }, "sha256": { "type": "string", "description": "Gets or sets the lowercase SHA-256 digest of the ZIP." }, "captureType": { "type": "string", "description": "Gets or sets the capture scope." }, "worldFormat": { "type": "string", "description": "Gets or sets the saved-world format." }, "playability": { "type": "string", "description": "Gets or sets the save's playability classification." }, "isCompleteWorld": { "type": "boolean", "description": "Gets or sets whether the ZIP represents a complete world." }, "warning": { "type": "string", "description": "Gets or sets the historical-fidelity warning." }, "dimension": { "type": "string", "description": "Gets or sets the retained Minecraft dimension." }, "chunkCount": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "description": "Gets or sets the number of retained chunks when known.", "format": "int32" }, "bounds": { "oneOf": [ { "type": "null" }, { "description": "Gets or sets the half-open retained block bounds when known.", "$ref": "#/components/schemas/WorldDownloadBounds" } ] }, "worldDownloadDate": { "type": [ "null", "string" ], "description": "Gets or sets the declared source-world date." }, "captureDatePrecision": { "type": [ "null", "string" ], "description": "Source precision: day, month, year, or unknown." }, "source": { "type": [ "null", "string" ], "description": "Gets or sets the capture provenance." }, "attribution": { "type": "string", "description": "Gets or sets the human-readable preservation attribution." } }, "description": "Public metadata for one immutable, partial Minecraft Java world download." } } }, "tags": [ { "name": "ApiIndex" }, { "name": "Attachments" }, { "name": "Groups" }, { "name": "Highways" }, { "name": "LegacyApi" }, { "name": "Locations" }, { "name": "MapRenders" }, { "name": "Nocom" }, { "name": "NocomDaily" }, { "name": "NocomDailyTiles" }, { "name": "NocomFind" }, { "name": "NocomRareBlocks" }, { "name": "NocomSignHistory" }, { "name": "NocomSpecialBlock" }, { "name": "Popularity" }, { "name": "Renders" }, { "name": "Warps" }, { "name": "WorldDownloads" } ] }