Bedrockサーバー(Ubuntu)でマップビューワー作成

⚠この記事が公開されたのは 2023年10月17日で、内容が古く、間違っている可能性があります。

MinecraftのBedrockサーバーでマップビューワー(Bedrock Viz)を実装しました。
前記事 Minecraft(Bedrock)複数ワールドをDockerで構築 を行った前提です。

環境

  • Ubuntu 22.04 (64bit)
  • Docker 24.0.5-64bit
  • Minecraft Bedrock Edition 1.20.31.01
  • nginx:alpine 1.25.2
  • Bedrock Viz 0.1.8

前提

ApatchやNginxでWebサーバー機能が起動している(設定やインストール方法は他の方の記事を参考に)

ディレクトリ/ファイル構成

htmlディレクトリはWebの公開ディレクトリです。

opt
└── bedrock
    └── data
        ├── worlds
        └── *worlds_cp
html

Bedrock Vizをインストール

Bedrock Viz は、Minecraft Bedrock Editionのワールド ファイルを Web アプリでGoogle マップのように表示することができるツールです。

git clone --recursive https://github.com/bedrock-viz/bedrock-viz.git
cd bedrock-viz
git apply -p0 patches/leveldb-1.22.patch
git apply -p0 patches/pugixml-disable-install.patch

mkdir build && cd build
cmake ..
make

参考: https://github.com/bedrock-viz/bedrock-viz/blob/master/docs/BUILD.md

ワールドファイルをディレクトリごとコピー

Bedrock VizのReadmeにオリジナルのワールドファイルを使用しないように記載があるため、コピーします。

mkdir /opt/bedrock/data/worlds_cp
cp -R /opt/bedrock/data/worlds/ /opt/bedrock/data/worlds_cp/

参考: https://github.com/bedrock-viz/bedrock-viz/blob/master/README.md

マップデータをhtmlにビルド

cd /usr/local/share/bedrock-viz/data/build/
./bedrock-viz --db ./opt/bedrock/data/worlds_cp --out ./opt/bedrock/html --html-most

参考: https://github.com/bedrock-viz/bedrock-viz/blob/master/README.md

公開ディレクトリにアクセスし、マップが表示されれば完成です。

マップの操作方法

拡大ダブルクリック or 左上の[+]ボタン or マウスホイール
縮小 Shift + ダブルクリック or 左上の[-]ボタン or マウスホイール
移動クリック&ドラッグ
回転Shit + Alt + クリック&ドラッグ
全画面表示ウィンドウ下のボタン
地上、ネザー、The Endの切り替え[Overworld]ボタン
レイヤー-64 (岩盤) から 319 (ビルド制限) まで ※今回の方法では対応していません
友好的Mobの表示[Passive Mobs]ボタン
敵対的Mobの表示[Hostile Mobs]ボタン
概要、バイオームなど[Overview]ボタン
Mob とオブジェクトの表示[Objects]ボタン
立面図オーバーレイ (陰影起伏)ON/OFF
チャンクグリッドの表示ON/OFF