初心者向けBONELAB Mod作成手順とUnity設定ガイド

2026年5月27日

課金負担に悩む人へ

スポンサードリンク

貯め方で選べる

ギフト券を貯めてゲーム課金に使う方法3選

ガチャや追加課金の前に、ポイントやギフト券を活用する方法を知っておくと、課金の負担を抑えやすくなります。総合ポイント型、ゲーム型、アンケート型で向いている人が違うため、自分の使い方に近いものから確認してみてください。まずは1つ試して、使いやすいものを組み合わせていく方法もあります。

▷ 課金資金をまとめてGETできる主力アプリ1本が欲しいなら

ギフトゲッターを無料で試す

交換先や最低交換額を確認してから始められます。

▷ ゲームが好きでゲーム案件をこなしてギフト券を貯めたなら

GEMYでゲーム案件を見る

対象ゲームや達成条件を確認してから進められます。

短時間のアンケートですぐ貯めたいなら

Ipsosのアンケートに回答してAmazonギフトをもらう

わからない設問は無理に回答しなくてもOKです。

Contents

1 Unity バージョンと環境構築
2 BONELAB Modding SDK の取得と導入
3 プロジェクト作成とシーン設定
4 基本的な C# スクリプト例（LaserGun）
- 4.1 スクリプトのポイント解説
- 4.2 エフェクトの作成と割り当て
5 ビルド・テスト・配布手順
6 配布プラットフォームの必須要件（Thunderstore / Nexus Mods）
- 6.1 Thunderstore 用 manifest.json
- 6.2 Nexus Mods 用 mod.json
7 まとめ

スポンサードリンク

Unity バージョンと環境構築

BONELAB は Unity 2020.3 LTS 系列 をベースに動作します。正しいバージョンでプロジェクトを作成しないと、SDK が読み込めずコンパイルエラーや実行時クラッシュの原因になります。このセクションでは、推奨 Unity バージョンと Unity Hub を使ったインストール手順を説明します。

推奨 Unity バージョン

Unity 2020.3.44f1（2020.3 LTS 系列の最新パッチ）
安定性が高く、BONELAB の Modding SDK が公式にサポートしているバージョンです。

必要なモジュール

モジュール	用途
Windows Build Support (Mono)	PC 向けビルド必須
Android Build Support + OpenJDK	Quest 向け Mod 開発時に必要

Unity Hub でのインストール手順

Unity Hub の取得
https://unity.com/download から Unity Hub をダウンロードし、指示通りにインストールします。
Installs タブを開く
左サイドバーの「Installs」をクリックし、「Add」ボタンで新規インストール画面へ進みます。
2020.3 LTS 系列を選択
バージョン一覧から「Unity 2020.3 LTS (最新パッチ)」を選び、次へ進みます。
モジュールの追加
「Windows Build Support（Mono）」は必ずチェックし、Quest 用開発の場合は「Android Build Support」と「OpenJDK」も併せて選択します。
インストール開始
「Done」をクリックしてダウンロードとインストールが完了するまで待ちます。

重要：プロジェクト作成時は必ず 2020.3 LTS を使用してください。異なるバージョンで開くと SDK が正しく読み込めません。

BONELAB Modding SDK の取得と導入

BONELAB 用の公式 Modding SDK は 「BONELAB Modding SDK」 と呼ばれ、BONEWORKS 用とは別に配布されています。ここでは最新リリースの取得方法と Unity プロジェクトへのインポート手順を解説します。

SDK のダウンロード手順

上記リポジトリの「Releases」ページへ移動
最新リリースの Assets から BONELAB_Mod_SDK.unitypackage をダウンロード
ダウンロードしたファイルはプロジェクト外の安全なフォルダーに保存しておきます

注意：非公式サイトや改変版パッケージはセキュリティ上危険です。必ず公式 GitHub から取得してください。

Unity プロジェクトへのインポート

空の Unity プロジェクト（次章で作成）を開く
メニューバー Assets → Import Package → Custom Package... を選択し、ダウンロードした .unitypackage を指定
表示されたウィンドウですべてにチェックが入っていることを確認し、Import をクリック

インポート完了後、プロジェクトビューに BONELAB_ModdingSDK フォルダーが作成され、サンプルシーンや API ドキュメントが含まれます。

プロジェクト作成とシーン設定

ここでは BONELAB 用のクリーンな Unity プロジェクトを作り、SDK のサンプルシーンをベースに自分だけの Mod シーンを構築する手順を示します。オブジェクトのプレハブ化や階層管理のコツも併せて解説します。

新規 Unity プロジェクトの作成

Unity Hub の Projects タブ で「New」ボタンをクリック
テンプレートは 3D (URP 非使用) を選択し、プロジェクト名に MyBonelabMod 等分かりやすい名前を付ける
保存場所は長すぎないパス（例：C:\UnityProjects\MyBonelabMod）に設定し、Create を実行

サンプルシーンのコピー

プロジェクトが開いたら File → Open Scene で BONELAB_ModdingSDK/SampleScene.unity を選択
シーンが正しく読み込めたことを確認したら、Hierarchy 上で右クリックし Save As... で MyModScene.unity として保存

この手順により、公式サンプルの構造を保ちつつ自由に改変できるベースシーンが作成できます。

基本オブジェクトの配置とプレハブ化

オブジェクト	作成手順	プレハブ保存先
箱（Cube）	Hierarchy → 右クリック → 3D Object → Cube → Transform を `(0,1,0)`、Scale `(0.5,0.5,0.5)` に設定。Rigidbody コンポーネントを追加	`Assets/Prefabs/Cube.prefab`
スイッチ（Button）	Hierarchy → 右クリック → UI → Button - TextMeshPro → Canvas の Render Mode を World Space に変更し、位置 `(0,1.5,0)` に設定。テキストは「Activate」へ変更	`Assets/Prefabs/SwitchButton.prefab`

作成したオブジェクトを Project ウィンドウ へドラッグすると自動的にプレハブ化され、シーン外でも再利用可能です。

ヒント：BONELAB の物理は PhysX ベースなので、Rigidbody を付け忘れるとオブジェクトが固定されたままになります。UI は必ず World Space にしないと VR 空間で正しく表示されません。

基本的な C# スクリプト例（LaserGun）

以下は「レーザー銃」の基本ロジックを実装したサンプルスクリプトです。Assets/Scripts/LaserGun.cs に保存し、シーン内の任意のオブジェクトにアタッチすれば動作します。

using UnityEngine;

/// &lt;summary&gt;
/// シンプルなレーザー発射スクリプト。
/// 左クリック（または VR コントローラのトリガー）で前方へ Ray を飛ばし、ヒットしたオブジェクトにダメージを与えます。
/// &lt;/summary&gt;
public class LaserGun : MonoBehaviour
{
    // 発射間隔（秒）
    [SerializeField] private float fireRate = 0.2f;
    // レーザーの最大距離
    [SerializeField] private float range = 30f;
    // ヒット時に再生するエフェクト
    [SerializeField] private GameObject impactEffect;

    private float _nextFireTime = 0f;

    void Update()
    {
        // VR 用入力は適宜書き換えてください
        if (Input.GetMouseButton(0) &amp;&amp; Time.time &gt;= _nextFireTime)
        {
            FireLaser();
            _nextFireTime = Time.time + fireRate;
        }
    }

    private void FireLaser()
    {
        Ray ray = new Ray(transform.position, transform.forward);
        if (Physics.Raycast(ray, out RaycastHit hit, range))
        {
            // エフェクト生成
            Instantiate(impactEffect, hit.point, Quaternion.LookRotation(hit.normal));

            // Damageable コンポーネントがあればダメージを適用
            var dmg = hit.collider.GetComponent&lt;Damageable&gt;();
            if (dmg != null)
                dmg.ApplyDamage(10);
        }
    }
}

using UnityEngine;

/// <summary>

/// シンプルなレーザー発射スクリプト。

/// 左クリック（または VR コントローラのトリガー）で前方へ Ray を飛ばし、ヒットしたオブジェクトにダメージを与えます。

/// </summary>

public class LaserGun : MonoBehaviour

{

// 発射間隔（秒）

[SerializeField] private float fireRate = 0.2f;

// レーザーの最大距離

[SerializeField] private float range = 30f;

// ヒット時に再生するエフェクト

[SerializeField] private GameObject impactEffect;

private float _nextFireTime = 0f;

void Update()

{

// VR 用入力は適宜書き換えてください

if (Input.GetMouseButton(0) && Time.time >= _nextFireTime)

{

FireLaser();

_nextFireTime = Time.time + fireRate;

}

private void FireLaser()

{

Ray ray = new Ray(transform.position, transform.forward);

if (Physics.Raycast(ray, out RaycastHit hit, range))

{

// エフェクト生成

Instantiate(impactEffect, hit.point, Quaternion.LookRotation(hit.normal));

// Damageable コンポーネントがあればダメージを適用

var dmg = hit.collider.GetComponent<Damageable>();

if (dmg != null)

dmg.ApplyDamage(10);

}

スクリプトのポイント解説

fireRate と _nextFireTime で連射速度を制御
Physics.Raycast により前方にレイを飛ばし、ヒット位置にエフェクトを生成
ダメージは対象が Damageable コンポーネントを持つ場合のみ適用

エフェクトの作成と割り当て

GameObject → Create Empty → 名前を LaserImpact に変更
Add Component → Particle System を追加し、以下の設定例で調整
Shape: Sphere、Radius: 0.05
Lifetime: 0.2 s、Start Color: 赤→黄の Gradient
作成したオブジェクトを Prefab 化し Assets/Effects/LaserImpact.prefab として保存
LaserGun コンポーネントの Impact Effect フィールドに作成したプレハブをドラッグ＆ドロップ

VR 環境ではパーティクルが遠距離で見えづらくなることがあります。ParticleSystem.main.maxParticles を抑えて描画負荷も管理しましょう。

ビルド・テスト・配布手順

この章では、作成した Mod のビルド方法、ゲーム内への導入手順、およびエラー対策を詳しく解説します。

MOD Builder を使ったビルド

Unity メニューバー BONELAB → Mod Builder を選択
Mod Name に MyFirstMod 等任意の名前、Output Folder に Mods\MyFirstMod（※正しいパスは BONELAB/Mods）を指定
ビルド対象は DLL と AssetBundle の両方にチェックし、Build ボタンをクリック

ビルドが成功すると以下のファイルが生成されます。

MyFirstMod/
├─ MyFirstMod.dll
└─ myfirstmod.bundle

MyFirstMod/

├─ MyFirstMod.dll

└─ myfirstmod.bundle

ゲーム内へのインストール

Steam 版 のインストールフォルダー（例）
C:\Program Files (x86)\Steam\steamapps\common\BONELAB
フォルダー直下に Mods が無い場合は作成
ビルドした MyFirstMod フォルダー全体を BONELAB/Mods にコピー

重要：Quest 版の場合は公式の mod.io クライアント経由で有効化します。手順は公式 Reddit スレッド（r/BONELAB）をご参照ください。

ゲーム起動後、メインメニューの Mods タブに自作 Mod が表示されればインストール完了です。

デバッグとよくあるエラー対策

エラー例	主な原因	対処法
`Failed to load assembly`	Unity バージョン不一致	2020.3 LTS で再ビルド
`MissingMethodException`	SDK API のバージョン違い（例：`Damageable.ApplyDamage` が削除）	最新 SDK に更新し、サンプルコードを合わせる
`NullReferenceException at LaserGun.FireLaser`	`impactEffect` が未設定	インスペクタでプレハブを割り当て直す
`AssetBundle load failed`	出力フォルダー名や拡張子が間違っている	Mod Builder の Output Folder 設定を確認

デバッグ時は Unity コンソールだけでなく、ゲーム起動時に出力されるログファイルも併せて確認すると原因特定が容易です。
%AppData%\LocalLow\StressLevelZero\BONELAB\output_log.txt

配布プラットフォームの必須要件（Thunderstore / Nexus Mods）

Mod を公開する際は、各プラットフォームが要求する mod.json（または同等のメタデータ）を正しく記述する必要があります。以下に代表的な必須項目と例を示します。

Thunderstore 用 `manifest.json`

キー	説明	例
`name`	Mod の識別子（小文字・ハイフン推奨）	`"my-first-mod"`
`version_number`	SemVer 形式のバージョン	`"1.0.0"`
`website_url`	プロジェクトページや GitHub URL	`"https://github.com/username/MyFirstMod"`
`description`	簡潔な概要（200文字以内）	`"BONELAB 用レーザー銃 Mod。VR で射撃体験を拡張します。"`
`dependencies`	必要な他の Mod（例：公式 SDK）	`[ { "dependency": "StressLevelZero-BONELAB-ModdingSDK", "version": ">=0.4.0" } ]`
`loaders`	対応 Unity/ゲームローダー	`[ "bonelab" ]`

アップロード手順
1. 上記 JSON をプロジェクトルートに manifest.json として保存
2. 必要ファイル（.dll, .bundle, README.md, スクリーンショット等）を同梱し ZIP 圧縮
3. Thunderstore のマイページから Upload Mod → ファイル選択 → 必須情報の入力 → 公開

Nexus Mods 用 `mod.json`

キー	説明	例
`name`	Mod 名（英数字・スペース可）	`"My First Mod"`
`version`	バージョン文字列	`"1.0.0"`
`author`	作者名またはハンドル	`"YourName"`
`description`	詳細説明（HTML 可）	`"BONELAB 用レーザー銃です。VR で使用できます。"`
`game_version`	対応 BONELAB バージョン	`"1.0.0"`
`mod_loader`	使用した SDK のバージョン	`"BONELAB-ModdingSDK v0.4.2"`

アップロード手順
1. 必要情報を記載した mod.json を作成
2. MyFirstMod/ ディレクトリ全体（DLL・AssetBundle・JSON 等）を ZIP 圧縮
3. Nexus Mods の Add Mod からファイルを選択し、タイトル・カテゴリ・画像等を入力して公開

共通の注意点：必ず「依存関係」に公式 SDK のバージョン（例 v0.4.x）を明記し、利用者が同バージョンを導入できるよう案内してください。

まとめ

Unity バージョンは 2020.3 LTS を Unity Hub 経由でインストールし、必要モジュール（Windows / Android）を追加する。
BONELAB Modding SDK は公式 GitHub のリリースページから取得し、unitypackage としてプロジェクトにインポートすれば使用可能になる。
サンプルシーンのコピー をベースにオブジェクトを配置・プレハブ化し、VR 向け UI は必ず World Space に設定する。
C# スクリプト例（LaserGun） を参考に、レイキャストとパーティクルエフェクトで基本的な武器ロジックを実装できる。
Mod Builder で .dll と .bundle を生成し、正しいフォルダー BONELAB/Mods に配置すればゲーム内テストが可能になる。
エラーは Unity バージョン・SDK のバージョン不整合が主因なので、常に公式情報を確認しながらビルドすること。
配布は Thunderstore と Nexus Mods が主流で、それぞれ manifest.json / mod.json に必須項目（名前・バージョン・依存関係など）を正確に記載する必要がある。

以上の手順とポイントを押さえれば、初心者でも BONELAB の Mod を作成し、コミュニティへ安全かつスムーズに共有できます。ぜひ自分だけのユニークなコンテンツで VR 世界を広げてみてください！

スポンサードリンク

課金負担に悩む人へ

スポンサードリンク

貯め方で選べる

ギフト券を貯めてゲーム課金に使う方法3選

▷ 課金資金をまとめてGETできる主力アプリ1本が欲しいなら

ギフトゲッターを無料で試す

交換先や最低交換額を確認してから始められます。

▷ ゲームが好きでゲーム案件をこなしてギフト券を貯めたなら

GEMYでゲーム案件を見る

対象ゲームや達成条件を確認してから進められます。

短時間のアンケートですぐ貯めたいなら

Ipsosのアンケートに回答してAmazonギフトをもらう

わからない設問は無理に回答しなくてもOKです。

-BONELAB

comment コメントをキャンセル

: BONELAB

BONELABセール攻略（2026）｜価格推移と購入ライン

BONELABの2026年Steamセール最安値の傾向と、歴史的最安値を基準とした実務的購入ライン、通知ツール設定法をまとめた実用ガイド。

: BONELAB

BONELABおすすめカスタム武器比較2024‑2026 | ベスト5と導入方法

BONELABの最新カスタム武器ベスト5を機能・性能・導入方法で比較し、QuestとPC VRに最適な選び方を解説します。

: BONELAB

Quest 2 と Pro のハードウェア比較と BONELAB 最適設定ガイド

本記事では、Quest 2 と Quest Pro のハードウェアスペックとメモリ上限を比較し、BONELAB を快適にプレイするための起動前準備、最適設定例、視覚系 MOD の安全な導入方法、そしてパフォーマンス監視・トラブルシューティング手順を詳しく紹介します。

: BONELAB

PC不要でMeta Questに『BONELAB』MODをインストールする手順

開発者モードとSideQuestだけで、PC不要でMeta QuestにBONELABのMOD環境を構築する方法をご紹介します。

: BONELAB

BONELAB VR 初心者ガイド：導入・設定・最適化まとめ

BONELAB VRを最短で快適に始めるための実務的ガイド。対応プラットフォーム比較、インストール手順、初期設定、パフォーマンス最適化、MOD管理とトラブル対処を網羅します。

VITURE Pro XRグラス 2024仕様・価格比較と購入ガイド

2026年Twitch UI刷新とWindows・macOSでのPWAインストール方法

初心者向けBONELAB Mod作成手順とUnity設定ガイド

Unity バージョンと環境構築

推奨 Unity バージョン

必要なモジュール

Unity Hub でのインストール手順

BONELAB Modding SDK の取得と導入

最新リリースの確認

SDK のダウンロード手順

Unity プロジェクトへのインポート

プロジェクト作成とシーン設定

新規 Unity プロジェクトの作成

サンプルシーンのコピー

基本オブジェクトの配置とプレハブ化

基本的な C# スクリプト例（LaserGun）

スクリプトのポイント解説

エフェクトの作成と割り当て

ビルド・テスト・配布手順

MOD Builder を使ったビルド

ゲーム内へのインストール

デバッグとよくあるエラー対策

配布プラットフォームの必須要件（Thunderstore / Nexus Mods）

Thunderstore 用 manifest.json

Nexus Mods 用 mod.json

まとめ

Thunderstore 用 `manifest.json`

Nexus Mods 用 `mod.json`