BlueMap — Minecraft向けブラウザ内インタラクティブ3Dワールドマップ生成プラグイン

BlueMap — Minecraft向けブラウザ内インタラクティブ3Dワールドマップ生成プラグイン

BlueMapは、ワールドファイルを読み込み、ブラウザからアクセス可能な3Dの表面モデルを構築するMinecraftプラグインです。標準クライアントはプレイヤーの周囲のみをレンダリングし、上空や外部からの視点を提供しません。このプラグインは、カメラの回転、パースペクティブまたはアイソメトリック（フラット）モードへの切り替え機能を備えた完全なマップを生成し、URLにアクセスするだけで建築物を見ることができます。ゲームにログインすることなくサーバーのワールドを外部から閲覧するという課題を解決します。

レンダリングの仕組み

プラグインはチャンクをタイルに分割し、2つの詳細レイヤーを生成します。完全なブロックジオメトリを持つhiresモデルと、遠景用のlowresマップです。ズームインするとHiresがアクティブになり、特定のブロック、テクスチャ、高さが表示されます。さらにズームアウトすると、バイオームの色の斑点と風景を備えた簡略化されたレイヤーが読み込まれます。

Webインターフェースでのレンダリングプロセス：ズームするとタイルが徐々に読み込まれます。 

レンダリングは、独立したスレッドプールで非同期に実行されます。Minecraftのサーバースレッドはブロックされません。CPUに空きコアがある限り、プレイヤーはマップの構築によるラグを感じることはありません。プラグイン自体がワールドの変更を追跡します：BlueMapは定期的にmcaファイルを確認し、変更されたチャンクを検知してそこだけを再レンダリングします。/bluemap updateのような手動コマンドはめったに必要ありません — 主に診断目的です。

Webインターフェースでの一人称視点でのレンダリング 

コマンド

プラグインは、サブコマンドを持つ1つのルートコマンド/bluemapを登録します。ほとんどの場合、コマンドは一切必要ありません — レンダリングは自動的に機能します。

/bluemapコマンドの実行 

設定

プラグインフォルダには4つの設定ファイルが含まれています：core.conf、plugin.conf、webapp.conf、webserver.conf。そして3つのサブフォルダ：maps/（ワールドごとに1つの.conf）、packs/（レンダリング用のリソースパック）、およびstorages/（ファイルシステム用のfile.conf、SQLデータベース用のsql.conf）。

core.conf

メインファイル。重要なパラメータはaccept-downloadで、初回起動時にtrueに設定する必要があります。render-thread-countパラメータ（デフォルトは1）はレンダリングスレッドの数を設定します — 負の値は「CPUコア数からその数値の絶対値を引いた数」を意味します。metrics（true）は匿名の統計情報の送信を制御します。

plugin.conf

マップ上のプレイヤーの可視性とレンダリング動作のパラメータ：

webapp.conf

Webアプリケーションの設定。default-to-flat-view（false）は初期表示を決定します — パースペクティブまたはアイソメトリック。スライダーのhires-slider-default（100）とlowres-slider-default（2000）は、ブロック単位で詳細および簡易レンダリングの距離を設定します。resolution-default（1）は0.5、1、または2の値を受け入れます。scriptsとstylesの配列は、カスタムJSおよびCSSファイルをリンクします。

webserver.conf

組み込みWebサーバー。enabled（true） — 有効または無効にします。port（8100） — ポート。webroot ("bluemap/web") — Webアプリケーションファイルのあるディレクトリ（webapp.confのwebrootと一致する必要があります）。logセクションはHTTPアクティビティのファイルへの記録を設定します。

結論

BlueMapは、カメラの回転や自由な飛行が可能な本格的な3Dモデルの形式で、ワールドを外部から閲覧する機会を提供します。このプラグインは、プレイヤーが座標を共有し、建物を検査することが重要なサバイバルやRPGサーバーに適しています。永続的なワールドのないミニゲームサーバーには不要です。