[FAQ] "Not an Autodesk path" Installation Error Resolution Guide

Applies to: Cases where a "Security violation: Not an Autodesk path" error occurs during MZP automatic installation

1. Error Symptoms

When installing automatically via an MZP file, the following security error occurs and the installation is interrupted.

Security violation: Not an Autodesk path

2. Cause

There are two types of User Scripts paths in 3ds Max.

This occurs in environments where the User Scripts path is set to a Documents-based location due to internal security policies, and the security verification fails to recognize that path.

This issue is planned to be fixed in a future update.

3. Manual Installation Method

Step 1. Extract the MZP File

Rename the MZP file extension to .zip, then extract it.

예)  fast_ref_v1_0_3_max2025_260213.mzp
  → fast_ref_v1_0_3_max2025_260213.zip

Note: MZP files are internally in ZIP format. Simply changing the extension allows them to be opened with standard archive programs.

Step 2. Verify the Installation Path

Open 3ds Max, then in the MAXScript Listener (F11), type the following command and press Enter.

getDir #userScripts

The output path is the target installation directory where files should be copied.

예시 결과:
  "C:\Users\사용자이름\Documents\3ds Max 2025\scripts"
  "C:\Users\사용자이름\AppData\Local\Autodesk\3dsMax\2023 - 64bit\ENU\scripts"

Step 3. Copy the Package Folder

Copy the os_fast_ref_package folder from the extracted archive directly into the scripts path identified in Step 2.

복사 후 결과 예시:
  C:\Users\...\scripts\os_fast_ref_package\

Caution: You must copy the entire os_fast_ref_package folder as-is. Do not copy only the files inside the folder.

Step 4. Register Macros and Menus

In the 3ds Max MAXScript Listener (F11), select all of the script below → copy → paste, then press Enter to execute.

This script automatically detects the 3ds Max version and operates accordingly.

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

    -- 3ds Max 버전 감지 (27000 = 2025, 26000 = 2024, 25000 = 2023)
    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
        print ("Macro created: " + macroFile)

        if is2025orLater then (
            -- 3ds Max 2025+: 메뉴 자동 등록 스크립트 복사
            local menuSrc = toolDir + "_register_menu.ms"
            local menuDst = startupDir + "\\os_fast_ref_menu.ms"
            if doesFileExist menuSrc then (
                copyFile menuSrc menuDst
                print ("Menu script copied: " + menuDst)
            ) else (
                print ("_register_menu.ms not found - menu registration skipped")
            )

            messageBox "설치 완료! 3ds Max를 재시작해주세요.\n\n재시작 후:\n  Main Menu > OS Tools > os_fast_ref" title:"os_fast_ref 설치 완료"
        ) else (
            -- 3ds Max 2022~2024: Customize UI 안내
            messageBox "설치 완료! 3ds Max를 재시작해주세요.\n\n실행 방법:\n  C

ustomize > Customize User Interface\n  Category: OtakuSolutions_Tools\n  Button: os_fast_ref\n\n위 버튼을 툴바에 드래그하여 사용하세요." title:"os_fast_ref 설치 완료"
        )
    )
)

When execution completes successfully, a completion message like the one below will be displayed.

Step 5. Restart 3ds Max

Fully close 3ds Max, then relaunch it.

Step 6. Verify Execution

4. FAQ

Q. In Step 4, I get the message "os_fast_ref_package folder is not in the scripts path."

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

Q. The OS Tools menu is not visible even after restarting. (2025)

→ Go to Customize → Customize User Interface → Category: OtakuSolutions_Tools, then drag the os_fast_ref button directly onto the toolbar to use it.

5. Contact

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

• OtakuSolutions Customer Support