---

# プラグインのインストール方法

> slug: installation

## 1. 会員登録およびライセンス申請

**1. OtakuSolutions で会員登録（[https://otakusolutions.com/ja/](https://otakusolutions.com/ja/)）**

![](installation/image.png)

**2. Fast-Ref の「体験申請する」をクリック**

![](installation/image1.png)

**3. 管理者承認後、ライセンス発行を確認**

**4. 対応する Max バージョンを選択し、mzp インストーラーをダウンロード**

![](installation/image2.png)

---

## 2. 💻 .mzp ファイルのダウンロードとインストール

![](installation/image3.png)

- **3dsMax を初めて起動**してください。
- ダウンロードした **mzp ファイルを 3dsMax の画面にドラッグ**するだけでワンクリックインストールが完了します。（使用する 3dsMax のバージョンに合わせて自動的にインストールされます。）

![](installation/image4.png)

- インストール前にホワイトリストパスを確認するステップです。セキュリティのため、インストールは指定パスのみに行われます。Autodesk のデフォルトパスは通常以下のとおりです。異なる場合はパスを確認の上インストールしてください。

```
# Autodesk デフォルトパス
C:\Users\<ユーザー>\AppData\Local\Autodesk\3dsMax\<version>...
```

- パスに問題がなければ **[はい / Yes]**、意図しないパスであれば **[いいえ / No]** をクリックし、OtakuSolutions までスクリーンショットをお送りください。

![](installation/image5.png)

- このダイアログはすでにインストール済みの場合に表示されます。パスに問題がなければ **[はい / Yes]** をクリックしてください。

![](installation/image6.png)

- インストール完了時に上記メッセージが表示されます。**Yes** をクリックすると 3dsMax が再起動します。

### セルフウィンドウへの登録

Customize UI → 'OtakuSolutions_Tools' → Fast-Ref

上記の画像を参考に、マクロキーを Self ウィンドウに登録してください。

![](installation/image7.png)

---

### メニューからのアクセス（2025 以降）

3dsMax 2025 以降のバージョンでは **OS Tools** メニューが追加され、こちらからもプラグインにアクセスできます。

![](installation/image8.png)

---

# ライセンスの有効化

> slug: license-activation

## 発行されたライセンスの確認

発行されたライセンスは通常メールでご案内します。

メールが届いていない場合は、OtakuSolutions → **[マイアカウント] → [マイプロダクト]** でライセンスコードをご確認ください。

![](license-activation/image.png)

![](license-activation/image1.png)

## ✅ ライセンス認証方法の選択

作業環境に合わせて便利な認証方法をお選びください。

### A案：オンライン認証（通常の場合）

すべてのツールに **License → License Managing** メニューがあります。クリック後、発行されたライセンスコードとメールアドレスを入力し、**[Update License]** ボタンで更新します。

![](license-activation/image2.png)

![](license-activation/image3.png)

次に **Machine ID → [Add] → [マシン ID 登録確認] → [Register Current License]** をクリックして、ライセンス情報とマシン ID をサーバーに登録します。

![](license-activation/image4.png)

ツール再起動後、メニューが **License \<ONLINE\>** と表示されれば認証完了です。

---

### B案：オフライン認証（ファイアウォール環境の場合）

職場などの環境にファイアウォールが設置されている場合、オンライン認証に失敗することがあります。

その場合は**オフライン認証**で安定してツールをインストールできます。

認証サーバーへの接続が失敗すると、自動的に **[オフライン認証モード]** に切り替わります。

**[Webでコード生成]** ボタンをクリックして認証ページを開き、手順に従って **1. メールアドレス / 2. ライセンスコード / 3. マシン ID** を入力してください。

![](license-activation/image5.png)

![](license-activation/image6.png)

認証が成功するとオフラインコードが生成されます。そのコードをオフラインコード入力欄に貼り付け、**[認証する]** ボタンをクリックしてください。

![](license-activation/image7.png)

ツール再起動後、メニューが **License \<OFFLINE\>** と表示されればオフライン認証完了です。

![](license-activation/image8.png)

---

# アップデート方法

> slug: update-guide

## プラグインのアップデート方法

新しいバージョンがリリースされたら、最新の機能とバグ修正を適用するためにアップデートしてください。

### 自動アップデート確認

プラグイン起動時に自動で新バージョンを確認します。アップデート通知が表示された場合は案内に従って進めてください。

**Help → Check for Update** から現在のバージョンが最新かどうかを手動で確認することもできます。

### 最新バージョンのダウンロード

1. OtakuSolutions → **[マイプロダクト]** ページから最新バージョンをダウンロードします。
2. 既存のプラグインを削除せずに新しい .mzp ファイルをインストールします。
3. 既存の設定とライセンスはそのまま維持されます。

> 📧 アップデート情報はニュースレターでお知らせします。ご購読をお勧めします。

![](update-guide/image.png)

---

# ファイアウォールホワイトリストの設定方法

> slug: firewall-setup

![](firewall-setup/image.png)

## 🔒 ファイアウォール設定ガイド

会社に設置されたファイアウォールにより、オンラインライセンス認証ができない場合があります。

その場合、以下の手順でネットワーク管理者に必要な情報を提供できます。

### 🛠️ 確認方法

1. ツールを起動して **License** メニューをクリック
2. **"Guide: Firewall Setup"** を選択
3. 表示された情報をサーバーまたはセキュリティ担当者に伝える

### 💡 代替手段

ネットワークアクセスが不可能な場合、**License メニュー → "Offline License"** からオフライン認証を使用できます。

> オフライン認証の詳細は [ライセンス有効化ガイド](../02_license-activation/) を参照してください。

---

# チームライセンス管理

> slug: team-license-management

![](team-license-management/image.png)

## 👥 チームライセンス管理

OtakuSolutions 製品を 1 つ以上ご購入の企業・個人の方には **チームリーダー（LEADER）** 権限が付与され、保有ライセンスをチームメンバーに自由に割り当て・回収できます。

プロフィールメニューの **「チームライセンス」** から管理でき、製品ごとにグループ化されて一目で状況を把握できます。

---

## 📊 ダッシュボード

ページ上部で保有ライセンスの状況を確認できます。

| 項目 | 説明 |
| --- | --- |
| **全ライセンス** | 保有するライセンスの総数 |
| **有効ライセンス** | 現在チームメンバーに割り当てられ使用中のライセンス数 |
| **未割り当て** | まだ割り当てられておらず使用可能なライセンス数 |

---

## 🔧 機能説明

| ボタン | 状態 | 説明 |
| --- | --- | --- |
| **割り当て** | 未割り当てライセンス | 未割り当てのライセンスをチームメンバーのメールアドレスに割り当てます。割り当て後すぐに使用可能になります。 |
| **変更** | 割り当て済みライセンス | すでに割り当てられたライセンスのユーザーを別のメンバーに変更します。 |
| **回収** | 割り当て済みライセンス | 割り当て済みライセンスを回収し未割り当て状態に戻します。回収時にそのライセンスは**無効化**されます。 |

---

## ⚙️ 追加オプション

| オプション | 説明 |
| --- | --- |
| **未割り当てのみ表示** | フィルターをオンにすると未割り当てのライセンスのみ表示されます。 |
| **製品別に折りたたむ/展開する** | 製品ごとにグループ分けされており、不要なグループは折りたたむことができます。 |

---

## 💡 注意事項

- 割り当てるメールは **OtakuSolutions アカウントに登録済みのメール** である必要があります。
- 回収したライセンスはいつでも別のメンバーに再割り当てできます。

---

# [FAQ] 「Not an Autodesk path」インストールエラー解決ガイド

> slug: faq-not-an-autodesk-path-error

> **注意**: `os_fast_ref_package` フォルダ自体をそのままコピーしてください。フォルダ内のファイルだけをコピーしても動作しません。

![image.png](faq-not-an-autodesk-path-error/image.png)

---

### Step 4. マクロとメニューの登録

3ds Max の **MAXScript Listener**（`F11` キー）に以下のスクリプトを **全選択 → コピー → 貼り付け** して `Enter` を押して実行します。

> このスクリプトは 3ds Max のバージョンを自動で検出して動作します。
>
> - **2025 以降**: OS Tools メニューを自動登録
> - **2022 ~ 2024**: Customize UI への登録を案内

```maxscript
(
    local scriptsDir = getDir #userScripts
    local macrosDir = getDir #userMacros
    local startupDir = getDir #userStartupScripts
    local toolDir = scriptsDir + "\\os_fast_ref_package\\"

    local maxVer = (maxVersion())[1]
    local is2025orLater = maxVer >= 27000

    if not (doesDirectoryExist toolDir) then (
        messageBox "os_fast_ref_package フォルダが scripts パスにありません。\nまず Step 3 を完了してください。" title:"エラー"
    ) else (
        local macroFile = macrosDir + "\\os_fast_ref.mcr"
        local toolDirSlash = substituteString toolDir "\\" "/"
        local pyCode = "import sys; tool_dir = r'" + toolDirSlash + "'; sys.path.insert(0, tool_dir) if tool_dir not in sys.path else None; from os_fast_ref.main import openWindow; openWindow()"

        local f = createFile macroFile
        format "macroScript Osfastref\n" to:f
        format "    category:\"OtakuSolutions_Tools\"\n" to:f
        format "    toolTip:\"os_fast_ref\"\n" to:f
        format "    buttonText:\"os_fast_ref\"\n" to:f
        format "(\n" to:f
        format "    python.Execute \"%\"\n" pyCode to:f
        format ")\n" to:f
        close f
        macros.load macroFile

        if is2025orLater then (
            local menuSrc = toolDir + "_register_menu.ms"
            local menuDst = startupDir + "\\os_fast_ref_menu.ms"
            if doesFileExist menuSrc then (
                copyFile menuSrc menuDst
            )
            messageBox "インストール完了！3ds Max を再起動してください。\n\n再起動後:\n  Main Menu > OS Tools > os_fast_ref" title:"os_fast_ref インストール完了"
        ) else (
            messageBox "インストール完了！3ds Max を再起動してください。\n\n起動方法:\n  Customize > Customize User Interface\n  Category: OtakuSolutions_Tools\n  os_fast_ref ボタンをツールバーにドラッグ" title:"os_fast_ref インストール完了"
        )
    )
)
```

実行が正常に完了すると、以下のような完了メッセージが表示されます。

![image.png](faq-not-an-autodesk-path-error/image_1.png)

---

### Step 5. 3ds Max の再起動

3ds Max を**完全に終了**してから**再度起動**します。

---

### Step 6. 起動確認

| **3ds Max バージョン** | **起動方法** |
| --- | --- |
| **2025 以降** | 上部メニューバー → **`OS Tools`** → **`os_fast_ref`** |
| **2022 ~ 2024** | **`Customize`** → **`Customize User Interface`** → Category: **`OtakuSolutions_Tools`** → **`os_fast_ref`** ボタンをツールバーにドラッグ |

---

### FAQ

**Q. Step 4 で「os_fast_ref_package フォルダが scripts パスにありません」と表示されます。**

→ Step 3 で `os_fast_ref_package` フォルダが正しい場所にコピーされているか確認してください。`getDir #userScripts` で出力されたパスの直下にフォルダがある必要があります。

**Q. 再起動後も OS Tools メニューが表示されません。（2025）**

→ `Customize` → `Customize User Interface` → Category: `OtakuSolutions_Tools` から `os_fast_ref` ボタンをツールバーに直接ドラッグして使用できます。

---

インストール中に問題が発生した場合や不明な点がある場合は、いつでもご連絡ください。

- **OtakuSolutions カスタマーサポート**

---

# [FAQ] ツールが開かない — 「Application Control / DLL load failed」セキュリティブロック解決

> slug: faq-security-block-dll-error

## 症状

3ds Max でツール（os_bipedPlus / os_fast_ref）を起動すると、以下のエラーが表示されウィンドウが開きません。

```
ImportError: DLL load failed while importing pyarmor_runtime:
An Application Control policy has blocked this file.
```

特徴:
- インストールは成功しているのに、**起動時のみ** このエラーが出ます。
- **同じ PC の別の 3ds Max バージョン（例: 2025）は正常**なのに、特定バージョン（例: 新しく入れた 2027）でのみ発生することがあります。
- 他の人の PC では問題なく動作します。

## 結論から（ご安心ください）

**マルウェアではありません。セキュリティソフトの誤検知（false positive）です。**

当ツールはライセンスとコード著作権を保護するため、Python コードを **暗号化（難読化）** して配布しています。これは有料の商用プラグインが一般的に用いる標準的な保護方式です。

この際に使用される保護ランタイムファイル（`pyarmor_runtime.pyd`）には個別のコード署名がないため、一部の Windows セキュリティ機能がこのファイルを **「初めて見る未知のファイル」と誤認** して読み込みをブロックします。

- そのため、**セキュリティソフトで例外（許可）に登録すればすぐに正常起動**します。
- 特定の Max バージョンだけで発生する理由: そのバージョンを **新規インストール** した際にこのファイルが初めて読み込まれたタイミングでセキュリティソフトが反応しただけで、ツール自体や Max バージョンの問題ではありません。

## 原因（技術説明）

| 項目 | 内容 |
|------|------|
| ブロック主体 | Windows Application Control（スマートアプリコントロール / WDAC）、またはウイルス対策・EDR・企業セキュリティポリシー |
| ブロック対象 | 署名のない保護ランタイム `pyarmor_runtime.pyd` |
| なぜ一部の PC だけ | セキュリティポリシーの On/Off・評価状態が PC ごとに異なるため（正常動作） |

## 解決方法

### 方法 A — セキュリティソフトの例外にツールフォルダを追加（推奨）

ご使用のウイルス対策 / セキュリティソフトの **例外（除外 / 許可リスト）** に、以下のツールインストールフォルダを追加します。

- os_bipedPlus:
  `%LOCALAPPDATA%\Autodesk\3dsMax\<バージョン>\ENU\scripts\os_bipedPlus_package`
- os_fast_ref:
  `%LOCALAPPDATA%\Autodesk\3dsMax\<バージョン>\ENU\scripts\os_fast_ref_package`

> フォルダパスが分からない場合、3ds Max の **MAXScript Listener（F11）** で `getDir #userScripts` を入力すると正確な親パスが出力されます。

例外を追加した後、**3ds Max を再起動** してツールを再度起動してください。

### 方法 B — Windows スマートアプリコントロールの確認（Windows 11）

1. **設定 → プライバシーとセキュリティ → Windows セキュリティ** を開く
2. **アプリとブラウザーの制御** をクリック
3. **スマートアプリコントロール（Smart App Control）** の項目を確認
4. **オン / 評価（Evaluation）** の場合は **オフ** に変更
5. **PC を再起動** して 3ds Max を再起動

> 会社/組織の PC で上記設定を変更できない場合は、IT 担当者に方法 A のフォルダをセキュリティ例外に登録するよう依頼してください。

## さらにご安心いただくために

例外に追加したフォルダのファイルを [VirusTotal](https://www.virustotal.com/) にアップロードしてご自身で検査いただくことも可能です。今後はコード署名（Code Signing）を適用し、このような誤検知が発生しないよう改善する予定です。


---

## 문의 / Contact / お問い合わせ / 联系

설치·실행 중 문제가 지속되면 언제든지 연락 주세요.
If the problem persists during installation or launch, feel free to contact us anytime.

- **OtakuSolutions 고객지원 / Customer Support**