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

対象: MZP 自動インストール時に「Security violation: Not an Autodesk path」エラーが発生する場合

1. エラーの症状

MZP ファイルによる自動インストール時、以下のセキュリティエラーが発生し、インストールが中断されます。

Security violation: Not an Autodesk path

2. 発生原因

3ds Max の User Scripts パスには2つのタイプがあります。

社内セキュリティ規定などにより User Scripts パスが Documents 方式に設定されている環境で、セキュリティ検証がそのパスを認識できないために発生します。

この問題は今後のアップデートで修正される予定です。

3. 手動インストール方法

Step 1. MZP ファイルを解凍する

MZP ファイルの拡張子を .zip に変更してから解凍します。

예)  fast_ref_v1_0_3_max2025_260213.mzp
  → fast_ref_v1_0_3_max2025_260213.zip

参考: MZP ファイルは内部的に ZIP 形式です。拡張子を変更するだけで一般的な解凍ソフトで開けます。

Step 2. インストールパスを確認する

3ds Max を開き、MAXScript Listener（F11 キー）で以下のコマンドを入力して Enter を押します。

getDir #userScripts

出力されたパスが、ファイルをコピーするインストール先のパスです。

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

Step 3. パッケージフォルダをコピーする

解凍したフォルダ内の os_fast_ref_package フォルダを、Step 2 で確認した scripts パスにそのままコピーします。

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

注意: os_fast_ref_package フォルダをそのまま丸ごとコピーしてください。フォルダ内のファイルだけをコピーしてはいけません。

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

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

このスクリプトは 3ds Max のバージョンを自動検出して動作します。

(
    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 설치 완료"
        )
    )
)

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

Step 5. 3ds Max を再起動する

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

Step 6. 実行を確認する

4. 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 ボタンを直接ツールバーにドラッグして使用できます。

5. お問い合わせ

インストール中に問題が発生したり、ご不明な点がございましたら、いつでもお問い合わせください。

• OtakuSolutions カスタマーサポート