Metroidvania Studio

Metroidvania Studio

Metroidvania Studio は、メトロイドヴァニアゲーム向けの無料のオープンソース 2D レベルエディターです。接続された部屋を作成し、自動タイルマップをペイントして、複数のゲームエンジンに対応した JSON エクスポートでミニマップをデザインできます。部屋をベースとするマップエディターは、ブラウザーまたは Windows プログラム上でローカルに動作します。

ウェブサイト · ドキュメント · ダウンロード

ワークフローを自動化： Lua スクリプト、ヘッドレス CLI、AI エージェント向けローカル MCP サーバー。

部屋を追加してタイルをペイントする

タイルパレットを設定する

部屋のサイズ変更、回転、接続を行う

ミニマップをデザインする

ゲームプレビューで探索する

はじめに

Windows、macOS、Linux 上でローカルに動作します。ゲームエンジンのインストールは不要です。

GitHub Releases からすぐに実行できるパッケージをダウンロードして展開し、最上位階層にある起動ファイルを開いてください。ビルド済みのウェブパッケージには ASP.NET Core Runtime 10 が必要です。

ソースからビルドするには、以下をインストールしてください。

要件	用途
Node.js 24+	ウェブ UI のビルドとビルドスクリプトの実行
.NET SDK 10	ローカルサーバーとコマンドラインツールのビルド
Git	ビルド中のソースファイルの検証

次に、お使いのプラットフォームに対応するスクリプトを実行してください。

プラットフォーム	ビルド	実行
Windows	platform/win/web/build.bat	platform/win/web/run.bat
macOS	platform/mac/build.command	platform/mac/run.command
Linux	bash platform/linux/build.sh	bash platform/linux/run.sh

実行すると、ローカルのビルドが現在のバージョンおよびソースファイルと照合されます。必要に応じて自動的にビルドした後、ブラウザーで Studio を開きます。最新のビルドであれば、すぐに起動します。

Maps と Textures は、ランチャーの隣、またはソースプロジェクトのルートに保存されます。File → Storage folders から確認できます。部屋の JSON は Maps/AutoExport に自動更新され、パレット設定は .studio/catalog.json で管理されます。Studio を更新する際は、Maps、Textures、.studio を残してください。

サンプルワールドを試す

新しいワークスペースを開くと、ループするルート、垂直シャフト、側面の部屋、坂、背景タイル、オブジェクトマーカーを備えた6部屋のワールドが開きます。Help → Open sample world から開くこともできます。

部屋をペイントしたり、2つの部屋を Ctrl-click してまとめて移動したり、ミニマップに切り替えて部屋を double-click し、編集に戻ったりできます。5分間のチュートリアルまたはサンプル JSONをご覧ください。

基本的な編集

• **描画：**アクティブな部屋の中で左ドラッグします。別の部屋を最初にクリックすると、その部屋が選択されます。

• **消去：**アクティブな部屋の中で右ドラッグします。

• **パンとズーム：**中ボタンドラッグでパンし、マウスホイールでズームします。Ctrl + ホイールでブラシサイズを変更します。何もない場所を右ドラッグしてもパンできます。

• **部屋の配置：**何もない場所を右クリックして部屋を追加し、部屋のタイトルバーをドラッグして移動するか、外側のハンドルをドラッグしてサイズを変更します。回転はインスペクターで設定できます。

• マップの保存と交換：保存と JSON のインポート／エクスポートにはファイルを使用します。元に戻す／やり直しには編集を使用します。上部のツールバーで PPU と解像度を設定します（デフォルト：16、320×180）。

• プレビュー：****ゲームカメラを選択し、白いフレームをドラッグします。ゲームプレビューはすぐに追従します。必要に応じて展開、最大化、または折りたたんでください。

すべての操作一覧は、ヘルプ → ショートカットを参照してください。インターフェースはブラウザーの言語に従います。言語選択メニューから変更できます。

検索可能なガイドと API リファレンス（オフラインアクセスを含む）を確認するには、ヘルプ → ドキュメントを開いてください。

エンジンパッケージ

エンジン	パッケージ	インストール
Unity	.unitypackage	ガイド
Godot	アドオン ZIP	ガイド
Unreal Engine 4	プラグイン ZIP	ガイド
Unreal Engine 5	プラグイン ZIP	ガイド
SDL3	C++ ソース ZIP	ガイド

各エンジンのフォルダーには、翻訳済みのインストールガイドが含まれています。マップは共通の JSON 形式を使用します。エンジンパッケージがインポートと描画を担い、ゲームプレイはゲームプロジェクト内で実装します。

スクリプトと自動化

ファイル → スクリプトを使用して、部屋を生成したり編集タスクを繰り返したりできます。同じ操作をヘッドレスでCLIから実行することも、ローカルのMCP サーバーを通じてAI エージェントを接続することもできます。ドライラン、アトミックな更新、リビジョンチェックにより、スクリプトによる編集を確認しやすくできます。

Node.js 24+ と .NET 10 runtime を使用して CLI と MCP ツールをインストールします。

npm install --global metroidvania-studio

プログラムをダウンロードして使用する場合は、Windows では metroidvania-studio-cli.cmd help、macOS/Linux では bash metroidvania-studio-cli.sh help を実行してください。ダウンロード版でのヘッドレス実行を参照してください。

ドキュメント、API リファレンス、Lua の例、または MCP のセットアップから始めてください。

ライセンス

プロジェクト所有のコードとアセットには MIT License が適用されます。 外部コンポーネントとその利用条件については、サードパーティに関する通知を参照してください。