2b2t Atlas

2b2tAtlas パブリック API

Atlas のデータを、ご自身のマップ、MOD、調査ツールでご利用ください。 場所、グループ、高速道路を調べたり、保存されたワールドを見つけたり、記録された看板、 インベントリ、モブ、マップアートを検索したりできます。公開データの読み取りにアカウントや API キーは不要です。

このリポジトリには、API リファレンス、HTTP の使用例、 アプリケーションソースの特定日付時点のコピーがあります。

2026 年 10 月 26 日確認：公開 GET ルート 57 件、読み取り専用 MCP ツール 38 個。 記録されたレスポンスの例は 10 月 19 日時点のものです。値や件数は変更される場合があります。 正確なパラメーターについては、ライブのウェブサイトリファレンスまたは 完全なルートカタログをご利用ください。

ベース URL： https://api.blackportal.cloud。 ブラウザー、コマンドライン、ご自身のコードからリクエストを送信できます。

• API リファレンス
• ライブ OpenAPI スキーマ
• 座標とレンダリングタイル
• BlueMap 3D ビュー
• 統合検索、インベントリ、保存済みオブジェクト
• Nocom データ
• MCP のセットアップとツール
• 連携用の最新情報と正規リンク
• 変更履歴
• ソースのバージョンと現在のアプリケーションスタック
• アプリケーションソースのスナップショット - 2026 年 9 月 26 日時点のソースとセットアップ手順。

試してみる

ブラウザーで場所の一覧を開くか、 以下のコマンドのいずれかを実行してください。Windows PowerShell 5.1 では、curl.exe を使用してください。

curl --fail "https://api.blackportal.cloud/api/locations"
curl --fail "https://api.blackportal.cloud/api/groups"
curl --fail "https://api.blackportal.cloud/api/renders?limit=10"
curl --fail "https://api.blackportal.cloud/api/nocom/highways?dimension=nether&direction=northeast"

一覧のレスポンスは JSON 配列です。ワープ、レンダリング、添付ファイルでは limit と offset を指定できます。デフォルトの上限は 500、最大は 1,000 です。場所の一覧では カタログ全体が返されます。

場所の選択画面やディレクトリには、/api/locations/directory をご利用ください。 名前、グループ、件数、おすすめのアクションを含むコンパクトな行が返されます。 レコードを開いたときに全履歴とメディアを取得するには、/api/locations/{id} を取得してください。

リクエストの例

examples/requests.http には、カタログのレコード、検索、インベントリ、 過去の観測データに対する通常の HTTP リクエストが含まれています。すでにお使いの言語や HTTP ツールから API をご利用ください。 Atlas クライアントパッケージは不要です。

アプリケーションのスナップショットは、現在の API リファレンスとは別のものです。 そのセットアップガイドは 2026 年 9 月 26 日時点のソースについて説明しており、 それ以降に追加された本番環境の機能やランタイムの変更については説明していません。

エンドポイント

以下のすべてのルートで GET を使用します。レスポンスフィールド、フィルター、キャッシュ、エラーについては リファレンスをご覧ください。

リソース	ルート
場所	/api/locations, /api/locations/directory, /api/locations/map, /api/locations/{id}, /api/locations/aliases
グループ	/api/groups, /api/groups/{id}
高速道路	/api/highways, /api/highways/{id}
アーカイブワープ	/api/warps, /api/warps/{id}
ワープの WDL メタデータと ZIP	/api/warps/{id}/world-download, /api/warps/{id}/world-download.zip
レンダリング	/api/renders, /api/renders/{id}, /api/locations/{id}/renders
保存されたレンダーソースの WDL メタデータと ZIP	/api/renders/{id}/world-download, /api/renders/{id}/world-download.zip
過去のメディア	/api/attachments, /api/attachments/{id}
マップレイヤー	/api/maprenders, /api/maprenders/catalog
統合検索	/api/find, /api/find/map, /api/find/sources, /api/find/source-options, /api/find/history, /api/find/inventory, /api/find/objects/{renderId}/{objectId}
保存済みギャラリー	/api/renders/{renderId}/explore/objects, /api/renders/{renderId}/explore/objects/{id} およびその /art.png プレビュー
NoCom	/api/nocom, /api/nocom/periods, /api/nocom/highways, /api/nocom/hits とその日別／チャンク別／タイル別ルート、/api/nocom/find/*
人気度	/api/popularity?days=7、30 または 90

クライアントの動作

• カタログのレスポンスをキャッシュし、HTTP キャッシュヘッダーに従ってください。Minecraft クライアントでは、HTTP リクエストと画像のデコードをレンダー／ティック処理のスレッド外で行ってください。
• ロケーションページには interactiveUrl、JSON には apiUrl、保存されたワールドには worldDownloadUrl を使用してください。Find オブジェクトの 3D の遷移先には、savedObject.locationLink を優先し、https://2b2tatlas.com を基準に解決してください。blueMapUrl は単独のビューワーを開くためのもので、省略可能であり、レンダー方法に固有です。
• null フィールドを処理し、未知の JSON プロパティは無視してください。
• 座標はレコードのネイティブディメンションを使用します。0 はオーバーワールド、1 はネザー、2 はエンドです。タイルテンプレートの {y} はタイルの行であり、Minecraft の標高ではありません。
• WDL は、過去の Java ワールドの部分的なセーブデータです。メタデータには、対象範囲、出所、サイズ、SHA-256 が含まれます。ZIP のダウンロードは HTTP レンジリクエストに対応しています。
• 過去の座標やレンダーは、現在のサーバーの状態を示すものではありません。NoCom の観測回数は、ユニークプレイヤー数ではありません。
• 保存されたインベントリは WDL のキャプチャに基づいています。NoCom が記録するのはコンテナの位置であり、中身ではありません。古いキャプチャも、結果がないことも、後にチェストが空にされた、または略奪されたことを示すものではありません。
• レコードをコピーする場合は、元の資料を確認できるよう、ソース URL、キャプション、クレジット表記、証拠フィールドを保持してください。

MCP

エンドポイント：https://api.blackportal.cloud/mcp。トランスポート：Streamable HTTP。 サーバーはステートレスかつ読み取り専用で、認証は不要です。

MCP ガイドには、クライアントの設定、現在のツール、リソース URI が記載されています。レジストリ名は io.github.bobymicjohn/2b2t-atlasです。 マニフェストは server.json です。

一括データ

静的エクスポートは 2b2tatlas.com でホストされています。

ファイル	内容
dataset.json	データセットのメタデータとカタログへのリンク
locations.jsonl	ロケーションレコード
groups.jsonl	グループと関係性
highways.jsonl	承認済みのハイウェイと関係性
media.jsonl	過去のメディアレコード
world-downloads.jsonl	利用可能な部分的 WDL、チェックサム、ソースリンク
llms.txt	データとドキュメントのインデックス

一括インポートには、これらのエクスポートを使用してください。インポートしたレコードには、エンティティ ID と正規 URL を保持してください。WDL カタログには HTML ビューもあります。

既存の連携

XaeroTools は、Atlas の画像のローカルコピーとソースリンクを含む、任意の Atlas ロケーションオーバーレイに対応しています。

貢献

ローカルでのチェックとプルリクエストについては、CONTRIBUTING.md を参照してください。ドキュメントの誤りや不正確なリクエスト例は、issues から報告してください。

ライセンス

Atlas が作成したコード、ドキュメント、およびフルスタックは、Unlicense の下で公開されています。自由に使用、変更、共有してください。許可も Atlas のクレジット表記も必要ありません。Atlas の事実に基づくカタログについても同様です。ATTRIBUTION.md には任意のクレジット表記の形式が記載されており、NOTICE.md ではサードパーティのメディアとソースの利用条件を扱っています。

2b2tAtlas は、Mojang Studios、Microsoft、または 2b2t の運営者とは提携していません。