---

# How to Install Plugins

> slug: installation

## 1. Sign Up and License Application

**1. Sign up on OtakuSolutions ([https://otakusolutions.com/en/](https://otakusolutions.com/en/))**

![](installation/image.png)

**2. Click [Apply for Trial] on Fast-Ref**

![](installation/image1.png)

**3. After admin approval, confirm your license issuance**

**4. Select the appropriate Max version and download the mzp installer**

![](installation/image2.png)

---

## 2. 💻 Download and Install the .mzp File

![](installation/image3.png)

- **Launch 3dsMax for the first time.**
- **Drag the downloaded .mzp file onto the 3dsMax viewport** for one-click installation. (Automatically installs for your version of 3dsMax.)

![](installation/image4.png)

- This step confirms the whitelist installation path. For security purposes, the installer runs only on the listed paths. Autodesk's default path is typically as shown below. If it differs, please verify the path before proceeding.

```
# Autodesk default path
C:\Users\<user>\AppData\Local\Autodesk\3dsMax\<version>...
```

- If the path is correct, click **[Yes]**. If unexpected, click **[No]** and contact OtakuSolutions with a screenshot.

![](installation/image5.png)

- This dialog appears when the plugin is already installed. If the path is correct, click **[Yes]**.

![](installation/image6.png)

- When installation is complete, the message shown above appears. Click **Yes** to restart 3dsMax.

### Registering in the Self Window

Customize UI → 'OtakuSolutions_Tools' → Fast-Ref

Refer to the image above to register the macro key in the Self window.

![](installation/image7.png)

---

### Accessing via Menu (2025+)

In 3dsMax 2025 and later, an **OS Tools** menu appears and can also be used to access the plugin.

![](installation/image8.png)

---

# License Activation

> slug: license-activation

## Checking Your Issued License

Your license is normally delivered by email.

If you did not receive an email, you can find your license code on OtakuSolutions → **[My Account] → [My Products]**.

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

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

## ✅ Choose Your License Activation Method

Please select the activation method that best suits your work environment.

### Option A: Online Activation (standard)

All tools have a **License → License Managing** menu. Open it, enter your issued license code and email, then click **[Update License]**.

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

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

Next, click **Machine ID → [Add] → [Confirm Machine ID] → [Register Current License]** to register your machine ID and license information with the server.

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

After restarting the tool, if the menu shows **License \<ONLINE\>**, activation is complete.

---

### Option B: Offline Activation (firewall environments)

A firewall at your workplace may block online license authentication.

In that case, use the **offline activation** method for a reliable installation.

If the connection to the authentication server fails, the tool automatically switches to **[Offline Activation Mode]**.

Click **[Generate Code on Web]** to open the authentication page, then follow the steps and enter **1. Email / 2. License Code / 3. Machine ID**.

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

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

Once authentication succeeds, an offline code is generated. Paste it into the offline code field and click **[Authenticate]**.

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

After restarting the tool, if the menu shows **License \<OFFLINE\>**, offline activation is complete.

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

---

# How to Update

> slug: update-guide

## How to Update the Plugin

When a new version is released, update to apply the latest features and bug fixes.

### Automatic Update Check

The plugin automatically checks for a new version on startup. If an update notification appears, follow the on-screen instructions.

You can also check manually via **Help → Check for Update**.

### Download the Latest Version

1. Go to OtakuSolutions → **[My Products]** and download the latest version.
2. Install the new .mzp file without removing the existing plugin.
3. Your existing settings and license are preserved.

> 📧 Update announcements are sent via newsletter. We recommend subscribing.

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

---

# How to Set Up a Firewall Whitelist

> slug: firewall-setup

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

## 🔒 Firewall Setup Guide

A firewall installed at your workplace may prevent online license authentication.

In that case, follow the steps below to get the information needed for your network administrator.

### 🛠️ How to Check

1. Launch the tool and click the **License** menu
2. Select **"Guide: Firewall Setup"**
3. Share the displayed information with your server or security administrator

### 💡 Alternative

If network access is unavailable, use **License menu → "Offline License"** for offline activation.

> See the [License Activation guide](../02_license-activation/) for offline activation details.

---

# Team License Management

> slug: team-license-management

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

## 👥 Team License Management

Users (companies or individuals) who have purchased 1 or more OtakuSolutions products are granted **Team Leader (LEADER)** status, allowing them to freely assign or revoke licenses to and from team members.

Manage everything from **"Team License"** in the profile menu. Licenses are grouped by product for a clear overview.

---

## 📊 Dashboard

The top of the page shows your license status at a glance.

| Item | Description |
| --- | --- |
| **Total Licenses** | Total number of licenses you own |
| **Active Licenses** | Licenses currently assigned to and in use by team members |
| **Unassigned** | Licenses not yet assigned and available for use |

---

## 🔧 Feature Overview

| Button | State | Description |
| --- | --- | --- |
| **Assign** | Unassigned license | Assigns an unassigned license to a team member by email. The member can use the product immediately. |
| **Change** | Assigned license | Transfers an already-assigned license to a different team member. |
| **Revoke** | Assigned license | Revokes an assigned license and returns it to unassigned status. The license is **deactivated** upon revocation. |

---

## ⚙️ Additional Options

| Option | Description |
| --- | --- |
| **Show unassigned only** | Enables a filter to display only currently unassigned licenses for quick access. |
| **Collapse / Expand by product** | Licenses are grouped by product; groups you don't need can be collapsed. |

---

## 💡 Notes

- The email used for assignment must be a **registered OtakuSolutions account email**.
- Revoked licenses can be reassigned to another team member at any time.

---

# [FAQ] Fixing the "Not an Autodesk path" Installation Error

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

> **Note**: You must copy the `os_fast_ref_package` folder itself — not just the files inside it.

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

---

### Step 4. Register Macros and Menus

In the 3ds Max **MAXScript Listener** (`F11`), **select all → copy → paste** the script below, then press `Enter` to run it.

> This script automatically detects your 3ds Max version:
>
> - **2025 and later**: Auto-registers the OS Tools menu
> - **2022 ~ 2024**: Guides you to register via 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 folder not found in scripts path.\nPlease complete Step 3 first." title:"Error"
    ) 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 "Installation complete! Please restart 3ds Max.\n\nAfter restart:\n  Main Menu > OS Tools > os_fast_ref" title:"os_fast_ref Installation Complete"
        ) else (
            messageBox "Installation complete! Please restart 3ds Max.\n\nTo launch:\n  Customize > Customize User Interface\n  Category: OtakuSolutions_Tools\n  Drag the os_fast_ref button to your toolbar." title:"os_fast_ref Installation Complete"
        )
    )
)
```

When completed successfully, a confirmation message will appear.

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

---

### Step 5. Restart 3ds Max

Fully **quit** and **relaunch** 3ds Max.

---

### Step 6. Verify Launch

| **3ds Max Version** | **How to Launch** |
| --- | --- |
| **2025 and later** | Top menu bar → **`OS Tools`** → **`os_fast_ref`** |
| **2022 ~ 2024** | **`Customize`** → **`Customize User Interface`** → Category: **`OtakuSolutions_Tools`** → Drag **`os_fast_ref`** to your toolbar |

---

### FAQ

**Q. Step 4 says "os_fast_ref_package folder not found in scripts path."**

→ Please check that the `os_fast_ref_package` folder was copied to the correct location in Step 3. The folder must be placed directly under the path printed by `getDir #userScripts`.

**Q. After restarting, I can't see the OS Tools menu. (2025)**

→ Go to `Customize` → `Customize User Interface` → Category: `OtakuSolutions_Tools` and drag the `os_fast_ref` button directly onto your toolbar.

---

If you have any issues or questions during installation, feel free to contact us anytime.

- **OtakuSolutions Customer Support**

---

# [FAQ] Tool Won't Open — Fixing the "Application Control / DLL load failed" Security Block

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

## Symptom

When launching the tool (os_bipedPlus / os_fast_ref) in 3ds Max, the following error appears and the window does not open:

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

Characteristics:
- Installation succeeds, but the error only occurs **when launching** the tool.
- It may occur only in a **specific 3ds Max version (e.g., a freshly installed 2027)** while **another version on the same PC (e.g., 2025) works fine**.
- It works perfectly on other people's PCs.

## Conclusion First (You Can Relax)

**This is NOT malware. It is a false positive from a security program.**

Our tool ships its Python code **encrypted (obfuscated)** to protect licensing and code copyright. This is a standard protection method commonly used by commercial paid plugins.

The protection runtime file used for this (`pyarmor_runtime.pyd`) is not separately code-signed, so some Windows security features mistake it for an **"unknown, unfamiliar file"** and block it from loading.

- Therefore, **adding an exception (allow) in your security program immediately fixes it.**
- Why only a specific Max version: it simply reflects the moment this file was first loaded after a **fresh install** of that version. It is not a problem with the tool or the Max version itself.

## Cause (Technical)

| Item | Details |
|------|---------|
| Blocked by | Windows Application Control (Smart App Control / WDAC), or antivirus / EDR / corporate security policy |
| Blocked file | The unsigned protection runtime `pyarmor_runtime.pyd` |
| Why only some PCs | Security policy On/Off and reputation status differ per machine (expected behavior) |

## Solution

### Option A — Add the tool folder to your security program's exceptions (Recommended)

Add the tool's install folder below to the **exceptions (exclusion / allow list)** of your antivirus / security program.

- os_bipedPlus:
  `%LOCALAPPDATA%\Autodesk\3dsMax\<version>\ENU\scripts\os_bipedPlus_package`
- os_fast_ref:
  `%LOCALAPPDATA%\Autodesk\3dsMax\<version>\ENU\scripts\os_fast_ref_package`

> If you don't know the folder path, type `getDir #userScripts` in the 3ds Max **MAXScript Listener (F11)** to print the exact parent path.

After adding the exception, **restart 3ds Max** and launch the tool again.

### Option B — Check Windows Smart App Control (Windows 11)

1. Open **Settings → Privacy & security → Windows Security**
2. Click **App & browser control**
3. Find **Smart App Control**
4. If it is **On / Evaluation**, switch it to **Off**
5. **Reboot the PC** and relaunch 3ds Max

> If this is a corporate/managed PC and you cannot change the setting, ask your IT admin to add the folder from Option A to the security exception list.

## If You Want Extra Peace of Mind

You may upload the files from the excepted folder to [VirusTotal](https://www.virustotal.com/) and scan them yourself. We plan to apply Code Signing in the future to prevent such false positives.


---

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

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

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