MillicentのAggressor用リバリーローダー

ToolUnityBepInExModding

MillicentVonPupper/Millicents-Aggressor-LiveryLoader

GitHub で見る

GitHub →

概要

Millicents-Aggressor-LiveryLoaderは、Unity製ゲーム「Aggressor」向けのカスタムスキン（リバリー）を追加するための小さなプラグインです。BepInEx 5.4のプラグインとしてゲームに組み込み、外部で作成したUnityアセットバンドル（AssetBundle）を読み込むことで、ハンガー画面やミッション中の機体にカスタムテクスチャやマテリアルを適用できます。本プロジェクトは軽量・単機能ながら、なるべく普遍的にどの機体にもスキンを適用できるよう設計されており、アセットバンドルの作成にはゲーム側と適合するUnityバージョンでのビルドが推奨されています。導入によりユーザーは自作のスキンを簡単にゲームへ反映でき、コミュニティ製のリバリー配布も容易になります。

GitHub

リポジトリの統計情報

  • スター数: 1
  • フォーク数: 0
  • ウォッチャー数: 1
  • コミット数: 5
  • ファイル数: 9
  • メインの言語: C#

主な特徴

  • Unityアセットバンドルを読み込んで機体へカスタムスキンを適用するBepInExプラグイン
  • ハンガー表示とミッション中の両方へ適用可能なスキンロード機能
  • 軽量で単機能、既存のアセットバンドルを利用すれば導入が容易
  • C#で実装され、BepInEx 5.4に依存

技術的なポイント

このプラグインは、BepInExプラグインとしてゲーム起動時にロードされ、外部フォルダからUnityのAssetBundleファイルを検出して読み込むことで機能します。典型的な実装フローは、AssetBundle.LoadFromFile（もしくは同等の読み込みAPI）でバンドルを開き、中に含まれるテクスチャやマテリアル、プレハブ等を取り出してゲーム内の既存オブジェクトへ適用するというものです。AssetBundle内のアセット名やマテリアル名をキーとして、対象機体のRendererコンポーネント／マテリアルを差し替える処理を行うことで、ハンガーやミッション中の表示を差し替えます。

開発上の注意点として、AssetBundleはビルドに使ったUnityのバージョンと互換性が強く作用します。ゲーム側のUnityバージョンと異なるバージョンでビルドしたバンドルは正しく読み込めない場合があるため、READMEに記載されたUnityのバージョン（READMEでは途中で切れていますが、ゲームに合わせたバージョン）が重要です。また、シェーダー互換性やテクスチャのインポート設定（フォーマット、圧縮、sRGBなど）によって見た目が崩れたり読み込みに失敗することがある点も留意が必要です。

メモリ管理やアンロードも技術的に重要です。AssetBundle.Load後は使用しなくなったアセットやバンドルをAssetBundle.UnloadやResources.UnloadUnusedAssetsで解放しないと、長時間のプレイでメモリが膨らむ可能性があります。さらに、実行時にGameObjectを差し替える際は、既存のアニメーションやマテリアルのプロパティを維持する処理（プロパティのコピーやマテリアルインスタンスの作成）を行わないと、期待しない挙動が出ることがあります。

互換性面では、他のBepInExプラグインやゲームのアップデートによる内部クラス名の変更が影響します。プラグイン側は可能な限り汎用的なオブジェクト探索（タグ・名前・型に基づく検索）と例外処理を行い、変更に強くすることが望ましいでしょう。導入手順と要件はREADMEに明記されており、ユーザーはBepInEx 5.4を事前に導入した上で、作成したAssetBundleを所定のフォルダへ配置するだけで利用開始できる想定です。

プロジェクトの構成

主要なファイルとディレクトリ：

  • .gitattributes: file
  • .gitignore: file
  • Liveryloader.csproj: file
  • Liveryloader.sln: file
  • Plugin.cs: file

…他 4 ファイル

まとめ

簡潔で実用的なAggressor向けスキンローダー。導入が容易で拡張性も見込める。

リポジトリ情報：

READMEの抜粋：

Millicents Aggressor Livery Loader

version 0.1.0 ig

What is this mod

This mod is a hopefully universal way to add custom skins to any aircraft in the game, the mod takes a unity asset bundle and loads up the skin for use in the hangar and in missions :3

Requirements

関連記事

Tool

STS2_Learner — STS2（Slay the Spire 2）モッド学習サンプル

STS2_Learnerは、Slay the Spire 2（以後STS2）向けモッド作成の学習用サンプルプロジェクトです。C#で書かれた小規模なコードベースにより、ゲームのフック実装やモッド管理の基本構造を示します。商用利用や二次配布は禁止されており、チュートリアル動画への参照も含まれるため、学習目的で実践的に使うことを想定しています。

C#ModdingSTS2
Tool

PeakVoiceRedirect — ストリーム用ボイスリダイレクト

Unity（Photon Voice）を利用するゲーム向けのBepInExモッド。特定プレイヤーの音声を配信（OBS 等）からミュートしつつローカルでは聞き続けられるよう、ゲーム内オーディオミックスから当該音声を切り離して別プロセスへ転送・再生する仕組みを提供します。ストリーム用に特定参加者だけ非公開にしたいケースや、音声ルーティングを細かく制御したい配信者向けのツールです。（約300字）

UnityAudioMod
Tool

SubwayBuilder パッチャー

SubwayBuilder 用の非公式パッチツール。Linux の AppImage や Windows のインストールディレクトリを対象に、他の都市データや改造コンテンツを差し込む（パッチする）ためのスクリプト群を提供します。ユーザーは既にゲームを所有している必要があり、プラットフォーム別の設定ファイルにより処理を切り替えられます。シンプルな CLI 形式で、バックアップやファイル操作を自動化することを目的とした軽量ユーティリティです。（約300字）

JavaScriptModdingPatcher
Tool

UnityCppDumperの概要と技術解説

UnityCppDumperはUnityゲーム向けのランタイムダンプツールで、ゲームの実行時にメモリ情報を抽出し解析を支援します。BA-Cheetoプロジェクトのために開発され、UnityResolveと組み合わせて使用されることを想定しています。ジェネリクスの正確な処理や継承対応など、今後の拡張も計画中です。C++で実装されており、ゲームの解析や改造などに役立つツールとして注目されています。

UnityC++ダンプツール
Other

RPG-GAME — 2D ピクセル風ファンタジーRPG（学習用サンプル）

Unityで作られた2Dピクセル風アクションRPGの学習用プロジェクト。ゴシックな城や月夜を背景に、騎士／戦士キャラクターの探索・戦闘・成長を中心とした設計で、スキルツリー・鍛冶（クラフト）・装備合成などの典型的なRPG要素を実装。チュートリアルに沿って制作された教材成果物で、アート素材・UI・ゲームロジックが揃っているため、Unity学習や2Dゲーム開発のリファレンスとして有用です。

UnityRPGピクセルアート
Other

RandomGamemodeEverywhere — ゲームモードをランダム化するGeodeプラグイン

Geometry Dash向けのGeodeモッド「RandomGamemodeEverywhere」は、レベルギミックにおけるゲームモード（例：飛行・重力反転・小型化など）をランダム化して、どの箇所でも予期せぬモード変化を発生させることを目的としたC++製プラグインです。GD Quasarらが提案したギミックの発展系で、KUAAAやGlobedらの普及した手法をベースに実装されています。READMEにはデバッグ協力や無限再帰の修正への感謝が記されており、Geode SDKを用いてゲーム本体の関数にフックを掛ける設計になっています（コンパイルはCMakeで管理）。

GeometryDashGeodeModding