libsm64: 外部ゲームエンジンで使用可能なライブラリとしてのMario 64
Libsm64: Mario 64 as a library for use in external game engines (github.com)
要約
libsm64は、Super Mario 64の移動およびレンダリングコードを、外部ゲームエンジンに容易に統合できるライブラリ形式で提供するプロジェクトです。SM64の逆コンパイルプロジェクトから派生したコードを使用し、実行時に公式ROMからテクスチャとアニメーションデータを抽出します。このライブラリは、Windows、macOS、Linux、およびWeb(Emscripten)でのビルドをサポートしています。
全文翻訳
libsm64 - Super Mario 64をライブラリとして
このプロジェクトの目的は、SM64逆コンパイルプロジェクトによってSM64からリバースエンジニアリングされた移動およびレンダリングコードにクリーンなインターフェースを提供し、マリオを既存のゲームエンジンや他のシステムに最小限の労力で組み込めるようにすることです。このプロジェクトは、逆コンパイルプロジェクトからのコードを主に含む共有ライブラリファイルを生成し、アセット(テクスチャやアニメーションデータ)を取得するために公式のSM64 ROMをランタイム時にロードします。そのため、このライブラリを利用するいかなるプロジェクトも、ユーザーにROMの提供を求める必要があります。
共有ライブラリの外部公開API全体は libsm64.h にあります。ライブラリを利用するクライアントプロジェクトは、そのヘッダーのみを含め、ライブラリをロードする必要があります。ライブラリの使用方法を示す最小限のサンプルプロジェクトが test ディレクトリの下にあります。
バインディングとプラグイン
- Rustバインディング
- Odinバインディング
- Unityプラグイン
- Blenderアドオン
- Godotアドオン
- Game Maker 8拡張機能
- Unity MelonLoader mod
- Unity BepInExプラグイン
- C#バインディング
MacおよびLinuxでのビルド
- python3がインストールされていることを確認してください。
- テストプログラムをビルドする場合、SDL2およびGLEWライブラリがインストールされていることを確認してください(Ubuntuの場合: libsdl2-dev, libglew-dev)。
- ビルドするには
makeを実行します。glibcの代わりにmusl libcをリンクしたい場合は、代わりにLIBSM64_MUSL=1 makeを実行してください。 - テストプログラムを実行するには、リポジトリのルートに
baserom.us.z64という名前のSM64 US ROMが必要です。
Windowsでのビルド
- ここにあるMSYS2 MinGW 64の設定手順1〜4に従ってくださいが、リポジトリURLを
https://github.com/libsm64/libsm64.gitに置き換えてください。 - テストプログラムをビルドする場合、SDL2およびGLEWライブラリがインストールされていることを確認してください。
- 64ビット:
pacman -S mingw-w64-x86_64-SDL2 mingw-w64-x86_64-glew。 - 32ビット:
pacman -S mingw-w64-i686-SDL2 mingw-w64-i686-glew。
- 64ビット:
- ビルドするには
makeを実行します。 - テストプログラムを実行するには、リポジトリのルートに
baserom.us.z64という名前のSM64 US ROMが必要です。
Emscripten(Web)向けビルド(開発中)
emmake make CC=emcc を実行します。
libsm64スタンドアロンをJSから呼び出したい場合(あまり有用ではないかもしれません?)、その後 emcc dist/libsm64.so -o libsm64.js を実行して libsm64.wasm と libsm64.js を生成してください。
それ以外の場合、dist/libsm64.so は、独自のCプロジェクトにリンクできるコンパイル済みのWebAssemblyオブジェクトになるはずです。
Makeターゲット(全プラットフォーム)
make lib: (デフォルト)共有オブジェクトまたはDLLと公開ヘッダーを含むdistディレクトリをビルドします。make test: ライブラリdistディレクトリとテストプログラムをビルドします。make run: SDL+OpenGLテストプログラムをビルドして実行します。