---

# 플러그인 설치 방법

> slug: installation

## 1. 회원가입 및 라이센스 신청

**1. 오타쿠솔루션즈에서 회원가입 진행 ([https://otakusolutions.com/ko/](https://otakusolutions.com/ko/))**

![](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의 기본값 경로는 아래와 같으며, 이가 동일하지 않으면 올바른 경로인지 확인 후 설치해 주세요.

```
# 오토데스크 기본값 경로
C:\Users\<사용자>\AppData\Local\Autodesk\3dsMax\<version>...
```

- 이상 없는 경로라면 **[예 / Yes]**, 의도하지 않은 경로라면 **[아니요 / No]** 를 눌러주시고 오타쿠솔루션즈 이메일로 해당 부분을 캡쳐해서 문의 부탁드립니다.

![](installation/image5.png)

- 해당 안내창은 이미 설치되어 있을 때 나오는 안내창입니다. 올바른 경로이고 이상없다면 **[예 / Yes]** 를 눌러주시면 됩니다.

![](installation/image6.png)

- 설치 완료 시 위 이미지의 메세지가 나오며 Yes를 누르시면 3dsMax가 재시작 됩니다.

### 셀프창에 등록하기

Customize UI → 'OtakuSolutions_Tools' → Fast-Ref

위 이미지를 참고하여 매크로키를 Self 창에 등록하시면 됩니다.

![](installation/image7.png)

---

### 메뉴로 접근하기 (2025~)

Max 2025 이상 버전은 **OS Tools** 라는 메뉴가 생기며 해당 메뉴를 통해 접근하실 수도 있습니다.

![](installation/image8.png)

---

# 라이센스 활성화

> slug: license-activation

## 발급된 라이센스 확인

발급된 라이센스는 기본적으로 메일로 안내됩니다.

메일이 오지 않았다면 오타쿠솔루션즈 → **[내 계정] → [내 제품]** 에서 라이센스 코드를 확인하실 수 있습니다.

![](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안: 오프라인 인증 (방화벽 환경의 경우)

직장 등의 작업 환경에 방화벽이 설치되어 설치 오류가 발생할 수 있습니다.

이 경우 **오프라인 인증** 방법을 통해 안정적으로 툴을 설치할 수 있습니다.

인증 서버 연결이 실패하면 자동으로 **[오프라인 인증 모드]** 로 전환됩니다.

**[웹에서 코드 생성]** 버튼을 눌러 인증 페이지에 접속한 후 절차에 따라 **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. 오타쿠솔루션즈 → **[내 제품]** 페이지에서 최신 버전을 다운로드합니다.
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  Button: os_fast_ref\n\n위 버튼을 툴바에 드래그하여 사용하세요." 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)입니다.**

저희 툴은 라이센스와 코드 저작권 보호를 위해 파이썬 코드를 **암호화(난독화)** 하여 배포합니다. 이는 유료 상용 플러그인들이 흔히 사용하는 표준 보호 방식입니다.

이때 사용되는 보호 런타임 파일(`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 스마트 앱 컨트롤(Smart App Control) 확인 (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**