제출 플러그인: DCC별 설치 및 문제 해결

SuperRenders 제출 플러그인은 3D 소프트웨어 내에 "SuperRenders" 메뉴 또는 쉘프 버튼을 추가하는 소형 확장 기능으로, DCC를 벗어나지 않고도 저희 팜에 렌더 작업을 제출할 수 있습니다. 플러그인은 장면을 패키징하고, 사전 비행 에셋 및 버전 확인을 실행하고, 단일 단계로 팜 큐에 작업을 전달합니다.

대부분의 사용자는 SuperRenders App의 PLUGIN 탭에서 제출 플러그인을 설치합니다. App이 워크스테이션에서 지원되는 각 DCC를 감지하고 일치하는 플러그인을 설치합니다. 아래 섹션에서는 DCC별 설치, 업데이트, 메뉴가 나타나지 않을 때의 해결 방법, 플러그인을 깔끔하게 제거하는 방법을 다룹니다.

이 페이지에서는 제출 플러그인의 기능, 지원되는 DCC 및 엔진, SuperRenders App을 통한 DCC별 설치, 업데이트 절차, 누락 쉘프/메뉴 수정 방법, 플러그인을 깔끔하게 제거하는 방법, 기능 매트릭스를 다룹니다.

플러그인이 설치된 후 작업 제출 워크플로우는 빠른 시작 가이드와 렌더러별 참고 사항에 대한 관련 DCC 설정 문서를 참조하시기 바랍니다. Client App 설치에 대해서는 Client App을 참조하시기 바랍니다.

플러그인 개요

제출 플러그인은 Client App의 DCC 측 동반자입니다. Client App은 데스크톱에서 업로드, 작업 추적, 다운로드를 처리하고, 플러그인은 DCC 내에서 "장면 → 작업"을 처리합니다.

DCC 내에서 플러그인이 하는 일:

SuperRenders 메뉴 또는 쉘프 버튼 추가 — DCC를 벗어나지 않고 제출 대화상자를 실행할 수 있습니다.
활성 장면 읽기 — 프레임 범위, 출력 경로, 렌더 설정, 참조 에셋을 읽어 작업 양식을 미리 채웁니다.
사전 제출 에셋 확인 실행 — 업로드가 시작되기 전에 누락된 텍스처, 누락된 레퍼런스, 끊어진 파일 경로를 표시합니다.
장면 파일 버전 관리 — 에셋과 함께 장면 파일의 버전을 관리하여 나중에 편집된 것이 아닌 제출한 정확한 장면 상태로 팜이 렌더링합니다.
패키징된 작업을 Client App에 전달 (Client App이 실행 중이어야 합니다. 시스템 트레이나 메뉴 막대에 있어도 됩니다)하여 업로드합니다.

이 페이지는 SuperRenders App의 PLUGIN 탭에서 설치하는 제출 플러그인을 문서화합니다. 3ds Max(2023 이상), Maya(2022–2027), Cinema 4D(2023–2026), Houdini, Blender(4.2 LTS 이상)를 지원합니다. 아래 각 DCC 섹션에서 설치 경로와 지원 버전 범위를 다룹니다.

설치 전 확인 사항

App에서 플러그인을 설치하기 전에 몇 가지를 확인하시기 바랍니다:

DCC를 실행하는 것과 동일한 사용자 계정을 사용합니다. 플러그인은 DCC의 프로그램 파일 디렉토리가 아닌 사용자의 DCC 스크립트 폴더에 설치됩니다. 다른 사용자(예: 소프트웨어 설치에만 사용하는 관리자 계정)로 로그인된 상태에서 설치하면 일반 사용자가 DCC를 열 때 플러그인이 나타나지 않습니다. 실제로 DCC를 여는 사용자로 로그인하고 설치 프로그램을 다시 실행하시기 바랍니다.
설치 전에 DCC를 최소 한 번 실행합니다. 대부분의 DCC는 첫 실행 시 사용자별 스크립트 폴더를 만듭니다. 해당 폴더가 존재하기 전에 설치하면 일부 Maya 및 3ds Max 버전에서 자동으로 실패합니다.
설치 중에는 DCC를 닫습니다. 플러그인의 시작 스크립트는 DCC가 로드될 때 읽힙니다. 설치 중에 DCC가 실행 중이라면 스크립트가 선택되도록 설치 후 재시작하시기 바랍니다.
Super Renders Farm 계정이 준비되어 있어야 합니다. 플러그인은 첫 실행 시 로그인을 요청합니다.

스튜디오에서 자체 Documents 폴더에 쓸 수 없는 잠긴 워크스테이션 이미지를 실행하는 경우, 지원팀에 연락하시기 바랍니다. 플러그인은 표준 DCC 스크립트 디렉토리에 대한 쓰기 액세스가 필요합니다.

DCC별 설치

모든 DCC에서 플러그인을 설치하려면 Client App을 설치하고 Plugins 패널을 열고 Scan to update를 클릭하시기 바랍니다. Client App이 설치된 DCC를 감지하고 각각에 올바른 플러그인을 설치합니다. scan-to-update가 DCC를 감지하지 못하면 DCC 버전과 OS를 포함하여 티켓을 등록하시기 바랍니다.

3ds Max

3ds Max 플러그인은 SuperRenders App의 PLUGIN 탭에서 설치합니다.

SuperRenders App을 설치하고 PLUGIN 탭을 엽니다.
3ds Max 플러그인을 설치합니다. App이 감지한 각 3ds Max 버전에 플러그인을 설치합니다.
SuperRenders 메뉴가 나타나지 않으면 3ds Max를 재시작합니다. 일부 3ds Max 버전은 실행 시에만 최상위 메뉴 정의를 다시 읽습니다.

3ds Max 버전 지원. 렌더팜은 3ds Max 2013–2027을 지원합니다. SuperRenders App의 PLUGIN 탭에서 설치하는 플러그인은 3ds Max 2023 이상을 지원합니다.

3ds Max 2026의 PySide / Qt 버전에 관한 안내: Autodesk는 최근 3ds Max 릴리즈에서 Qt 버전을 변경했으며, 이는 역사적으로 플러그인 GUI에 영향을 미쳤습니다. SuperRenders 메뉴가 나타나지만 제출 대화상자가 빈 상태로 열리거나 Python 오류가 발생한다면, 티켓을 제출하시기 바랍니다. 플러그인 측 패치가 필요한지 확인해 드립니다.

Maya

Maya 플러그인은 SuperRenders App의 PLUGIN 탭에서 설치하며, 감지된 Maya 2022부터 2027까지의 각 버전에 설치됩니다.

설치 방법:

SuperRenders App을 설치하고 PLUGIN 탭을 엽니다.
Maya 플러그인을 설치합니다. App이 감지한 각 Maya 버전에 플러그인을 설치합니다.
Maya를 재시작합니다. SuperRenders 쉘프가 나타납니다.

Maya 버전 지원. 렌더팜은 Maya 2014–2027을 지원합니다. SuperRenders App의 PLUGIN 탭에서 설치하는 플러그인은 Maya 2022부터 2027까지를 지원합니다.

Cinema 4D

Cinema 4D 플러그인은 SuperRenders App의 PLUGIN 탭에서 설치합니다.

설치하려면:

SuperRenders Client App을 설치합니다.
Client App 내 Plugins 패널을 엽니다.
Scan to update를 클릭합니다. Client App이 워크스테이션에 설치된 각 Cinema 4D 버전을 감지하고 C4D 플러그인 디렉토리에 일치하는 플러그인을 설치합니다.
Cinema 4D를 재시작합니다. SuperRenders 제출 항목이 C4D 확장 메뉴에 나타납니다.

scan-to-update에서 Cinema 4D 버전이 "지원되지 않음"으로 표시되면, C4D 버전 및 OS와 함께 티켓을 제출하시기 바랍니다. Maxon이 새 Cinema 4D 릴리즈를 출시하면 플러그인 지원을 해당 릴리즈로 순차적으로 확장합니다.

Cinema 4D 버전 지원. SuperRenders App의 PLUGIN 탭에서 설치하는 플러그인은 Cinema 4D 2023부터 2026까지를 지원합니다. 렌더팜 자체는 Cinema 4D R14–2027을 지원합니다. Cinema 4D 2027 씬은 업로드 전에 문의하여 확인해 주십시오.

Blender

Blender 4.2 LTS 이상에는 SuperRenders 제출 애드온이 있습니다. SuperRenders App(Client App)의 PLUGIN 탭에서 설치합니다. Blender를 재시작하면 SuperRenders 메뉴가 나타나며, 이 메뉴에서 열려 있는 장면을 제출합니다.

4.2보다 오래된 Blender 버전을 사용하거나 애드온을 설치하지 않으려는 경우에는 Client App의 드래그 앤 드롭 업로드 흐름 또는 웹 대시보드를 통해 제출하십시오. .blend 파일의 메타데이터가 업로드 시 파싱되며, Client App이 대부분의 제출 필드를 자동으로 미리 채웁니다.

재시작한 뒤에도 SuperRenders 메뉴가 나타나지 않으면 Blender 버전이 4.2 이상인지 확인한 다음, Blender 버전과 OS 정보를 첨부하여 지원팀에 문의해 주십시오.

기타 DCC

Houdini에도 제출 플러그인이 있으며, SuperRenders App의 PLUGIN 탭에서 설치합니다. 팜 자체가 렌더링하는 After Effects 및 기타 DCC의 경우, 제출 흐름은 다음을 통해 이루어집니다.

웹 대시보드 (빠른 시작 가이드) — 팜이 렌더링하는 모든 DCC에서 작동합니다.
Client App의 드래그 앤 드롭 업로드 (Client App) — 모든 DCC에서 작동하며 재개 가능한 업로드와 자동 다운로드의 이점이 있습니다.

Houdini 특유의 제출 팁은 Houdini 설정을 참조하시고, After Effects는 After Effects 설정을 참조하시기 바랍니다. After Effects에는 SuperRenders 제출 플러그인이 없으며, 해당 설정 문서에서 플러그인 없이 프로젝트를 패키징하고 제출하는 방법을 다룹니다.

업데이트 절차

SuperRenders App은 플러그인을 자동으로 최신 상태로 유지합니다. SuperRenders가 업데이트(새 DCC 버전, 에셋 재연결기 수정)를 출시하면, App이 새 플러그인을 가져와 다음 실행 시 설치를 제안합니다.

수동으로 업데이트를 실행하려면:

3D 소프트웨어를 닫습니다. DCC는 실행 중에 플러그인 파일을 잠그고 자동으로 업데이트를 차단할 수 있습니다.
Client App의 Plugins 패널을 열고 Scan to update를 클릭합니다. Client App이 설치된 플러그인 버전을 최신 버전과 비교하고 사용 가능한 경우 새 버전을 설치합니다.
각 행에 "Up to date"가 표시될 때까지 기다립니다.
DCC를 재시작합니다. 새 플러그인 버전이 다음 실행 시 읽힙니다.

특정 DCC에 대해 "Scan to update"가 실패하는 경우, 일반적인 원인은 DCC가 여전히 실행 중이어서 파일 잠금을 보유하고 있거나, Client App을 실행하는 사용자 계정이 DCC의 스크립트 폴더에 대한 쓰기 권한이 없거나(DCC를 실행하는 것과 동일한 Windows 사용자로 Client App 실행), 또는 이전에 실패한 설치가 불완전한 플러그인 폴더를 남긴 경우(플러그인 제거에 따라 제거하고 다시 검색)입니다.

App이 DCC의 플러그인을 업데이트할 수 없는 경우, 플러그인을 제거하고(플러그인 제거 참조) Scan to update를 다시 실행하시기 바랍니다.

누락된 플러그인 메뉴 또는 쉘프 (문제 해결)

플러그인이 오류 없이 설치되었지만 SuperRenders 메뉴 또는 쉘프 아이콘이 나타나지 않는 경우, 근본 원인은 거의 항상 두 가지 중 하나입니다. 플러그인이 잘못된 디렉토리에 설치되었거나, 써드파티 도구가 DCC의 시작 설정을 손상시킨 경우입니다.

원인 1 — 플러그인이 잘못된 스크립트 디렉토리에 설치된 경우.

플러그인은 실행 중인 DCC 버전에 대한 사용자별 스크립트 폴더에 있어야 합니다. 다른 Maya 버전의 폴더나 다른 Windows 사용자의 프로필에 위치하면 DCC가 시작 시 찾을 수 없습니다.

Maya에서 스크립트 에디터를 열고 다음을 실행하여 확인합니다.

text

import superrenders_runner
superrenders_runner.init()

SuperRenders 제출 창이 열리면 플러그인이 올바르게 설치된 것이고 쉘프 문제는 UI 문제입니다(원인 2). ImportError: No module named superrenders_runner가 발생하면 플러그인이 Maya의 Python 경로에 없습니다. 플러그인을 제거하고(플러그인 제거 참조) App에서 다시 설치한 다음 확인하시기 바랍니다:

경로의 Maya 버전이 실행하는 Maya와 일치합니다(예: Maya 2023의 경우 maya/2023/scripts/superrenders).
경로의 Windows 사용자가 Maya를 실행하는 사용자와 일치합니다.
userSetup.mel 내의 경로가 역슬래시가 아닌 전방 슬래시를 사용합니다.

동일한 논리가 3ds Max와 Cinema 4D에도 적용됩니다. 설치 경로는 실행 중인 사용자 계정 및 DCC 버전과 일치해야 합니다.

원인 2 — 써드파티 도구가 DCC의 쉘프 설정을 손상시킨 경우.

스크립트 에디터에서 superrenders_runner가 가져오기를 확인하지만 쉘프 아이콘이 여전히 없는 경우, DCC의 저장된 쉘프 설정이 손상된 것입니다. 일반적으로 다른 플러그인이 설정을 덮어쓴 경우입니다.

Maya에서:

Maya를 종료합니다.
userPrefs.mel을 찾습니다: C:\Users\<YourWindowsUser>\Documents\maya\<MayaVersion>\prefs\userPrefs.mel
userPrefs.mel을 userPrefs.mel.backup으로 이름을 변경합니다(삭제하지 마시기 바랍니다. 병합하고 싶은 사용자 지정 쉘프 레이아웃을 보존합니다).
Maya를 재시작합니다. Maya가 새 userPrefs.mel을 재생성하고 SuperRenders 쉘프가 나타납니다.

사용자 지정 쉘프 및 최근 파일 목록이 손실됩니다. 필요한 경우 백업에서 병합하시기 바랍니다.

3ds Max에서 동등한 수정은 사용자 지정 → 시작 UI 레이아웃으로 되돌리기 후 SuperRenders App의 PLUGIN 탭에서 플러그인을 다시 설치하는 것입니다.

두 원인 중 어느 것도 해당되지 않으면, DCC 이름과 버전, OS 및 사용자 계정, 스크립트 에디터/MAXScript Listener의 전체 오류 텍스트, userSetup.mel(Maya) 또는 MAXScript 설치 로그(3ds Max)의 내용을 포함하여 지원 티켓을 제출하시기 바랍니다.

플러그인 제거

플러그인을 제거하려면(깔끔한 재설치 또는 공유 워크스테이션 정리) DCC별 절차가 있습니다.

Maya:

Maya를 종료합니다.
Maya의 스크립트 디렉토리 아래 superrenders 폴더를 삭제합니다: C:\Users\<YourWindowsUser>\Documents\maya\<MayaVersion>\scripts\superrenders
userSetup.mel을 열고 /***superrenders_begin***/와 /***superrenders_end***/ 사이의 블록을 제거합니다. 저장합니다.
Maya를 재시작합니다. 워크스테이션의 각 Maya 버전에 대해 반복합니다.

3ds Max:

3ds Max를 닫습니다.
다음 실행 시 사용자 지정 → 시작 UI 레이아웃으로 되돌리기에서 UI를 기본값으로 재설정하거나, C:\Users\<YourWindowsUser>\AppData\Local\Autodesk\3dsMax\<Version>\ENU\usermacros\에서 SuperRenders 매크로스크립트 파일(SuperRenders_로 시작하는 파일)을 삭제합니다.
3ds Max를 재시작합니다.

Cinema 4D: Cinema 4D를 닫고, 해당 C4D 버전의 C4D 플러그인 디렉토리에서 SuperRenders 플러그인 폴더를 삭제하고, Cinema 4D를 재시작합니다. Client App은 현재 DCC별 제거 버튼을 제공하지 않습니다.

제거 후에도 Client App과 웹 대시보드는 플러그인 없이도 작업을 제출합니다.

제출 플러그인 지원 기능 매트릭스

아래 매트릭스는 DCC별 제출 플러그인 기능을 요약합니다. 버전 행은 현재 SuperRenders App에서 설치하는 플러그인을 반영합니다. 그 외 3ds Max, Maya, Cinema 4D 행은 이전 플러그인 세대(2023–2024)에 대해 문서화된 기능 목록에서 가져온 것이며, 현재 플러그인에 대해 하나씩 다시 확인되지는 않았습니다. Blender 애드온(Blender 4.2 LTS 이상)은 SuperRenders App의 PLUGIN 탭에서 설치하며 열려 있는 장면을 제출합니다. 그 외 기능은 아직 여기에 문서화되어 있지 않습니다. Houdini 플러그인도 SuperRenders App에서 설치하며, 아직 이 매트릭스에 포함되어 있지 않습니다.

기능	3ds Max	Maya	Cinema 4D	Blender
제출 플러그인이 지원하는 DCC 버전(렌더팜 자체 지원 범위보다 좁음)	2023 이상(SuperRenders App)	2022–2027(SuperRenders App)	2023–2026(SuperRenders App)	4.2 LTS 이상(SuperRenders App)
제출 시 장면 패키징	예	예	예	아직 문서화되지 않음
사전 제출 에셋 확인	예	예	예	아직 문서화되지 않음
에셋 재연결기(텍스처 추적기)	예	예	예(C4D 텍스처 추적기)	아직 문서화되지 않음
프레임 범위/단일 프레임/범위/선택된 프레임 제출	예	예	예	아직 문서화되지 않음
참조 장면/XRef	예	예(바이너리 .mb + ASCII .ma)	예(XRef, 파일 시퀀스, 텍스처, GI 맵)	아직 문서화되지 않음
렌더 패스/멀티 패스 출력	예	예	예(메인 + 멀티 패스 + 렌더 요소 + AOV + Corona 버퍼)	아직 문서화되지 않음
팜 측 장면 버전 관리	예	예(완전 자동화 통합)	예(서버 측 장면 버전 관리 + 확인)	아직 문서화되지 않음
타일/고해상도 스틸 렌더링	—	—	예(C4D 타일 카메라)	아직 문서화되지 않음
여러 GI 캐시 모드	—	—	예(Irradiance 캐시, QMC, Light Mapping, Radiosity, UHD Cache, HD Cache, Path Tracing, Light Cache, Brute Force)	아직 문서화되지 않음
지원되는 엔진	V-Ray, Corona(렌더러 지원은 팜 측이며 플러그인은 장면을 패키징)	Arnold, V-Ray, Redshift(렌더러 지원은 팜 측이며 플러그인은 장면을 패키징)	Advanced Render, Physical, V-Ray, Corona(렌더러 지원은 팜 측이며 플러그인은 장면을 패키징)	렌더러 지원은 팜 측입니다. Blender 설정 참조

이 매트릭스는 DCC 내에서 플러그인이 처리하는 것을 추적합니다. 실제로 작업을 렌더링하는 팜 측 엔진 지원은 더 광범위하며 관련 DCC 설정 문서에서 추적됩니다. 플러그인은 장면을 패키징합니다. 렌더러(Arnold, V-Ray, Redshift 등)는 팜 측에서 실행됩니다.

통화 메모

SuperRenders App은 3ds Max 2023 이상, Maya 2022–2027, Cinema 4D 2023–2026, Blender 4.2 LTS 이상용 플러그인을 설치합니다. 렌더팜 자체의 지원 범위는 이보다 넓습니다. 최신 DCC에서 플러그인 문제가 발생하면 티켓을 제출하시기 바랍니다. P1로 처리합니다.

플러그인이 올바른 경로가 아닌 경우

일부 워크플로우는 플러그인이 설치되고 작동하더라도 플러그인 없이 더 잘 처리됩니다.

설치하고 싶지 않은 일회성 제출. 웹 대시보드를 사용하시기 바랍니다.
사용자가 자체 스크립트 폴더에 쓰기 액세스 권한이 없는 잠긴 스튜디오 워크스테이션. 웹 대시보드를 사용하시기 바랍니다.
플러그인의 제출 대화상자를 클릭할 GUI가 없는 헤드리스 렌더 준비 머신. Client App의 드래그 앤 드롭을 사용하시기 바랍니다.
제출 플러그인이 없는 DCC(예: After Effects) 및 4.2보다 오래된 Blender 버전. Client App 또는 웹 대시보드를 통해 제출하시기 바랍니다.

Client App, 웹 대시보드, 제출 플러그인은 상호 배타적이지 않습니다. 단일 프로젝트를 Client App으로 업로드하고 플러그인으로 제출하거나, 웹으로 업로드하고 플러그인으로 제출할 수 있습니다. 워크스테이션에 맞는 경로를 선택하시기 바랍니다.

상호 참조

Client App — 업로드, 제출, 다운로드를 위한 데스크톱 래퍼
빠른 시작 가이드 — 플러그인 없이 브라우저 제출 흐름
웹 제출 — 브라우저 기반 제출 세부 사항
업로드 및 다운로드 — 업로드 방법 비교
Maya 설정 — Maya 특유의 제출 참고 사항
3ds Max 설정 — 3ds Max 특유의 제출 참고 사항
Cinema 4D 설정 — Cinema 4D 특유의 제출 참고 사항
Blender 설정 — Client App/웹을 통한 Blender 제출
일반 오류 — 크로스 DCC 문제 해결

FAQ

Q: 제출 플러그인을 반드시 설치해야 하나요, 아니면 없이도 작업을 제출할 수 있나요? A: 플러그인은 선택 사항입니다. Client App과 웹 대시보드 모두 DCC 플러그인 없이도 작업을 제출합니다. 플러그인은 3D 소프트웨어 내에서 원클릭으로 제출하는 것을 선호하는 사용자를 위한 편의 기능입니다.

Q: 어떤 3D 애플리케이션에 SuperRenders 제출 플러그인이 있나요? A: SuperRenders App의 PLUGIN 탭에서 설치하는 플러그인은 3ds Max(2023 이상), Maya, Cinema 4D, Houdini, Blender(4.2 LTS 이상)를 지원합니다. After Effects에는 제출 플러그인이 없으며, After Effects 작업은 Client App 또는 웹 대시보드를 통해 제출합니다.

Q: 설치 후 SuperRenders 메뉴가 나타나지 않는 이유는 무엇인가요? A: 가장 흔한 원인: 플러그인이 잘못된 스크립트 폴더에 설치되었거나(종종 DCC를 실행하는 것과 다른 사용자로 설치했기 때문), DCC의 저장된 쉘프 설정이 손상된 경우입니다. 전체 진단 흐름은 누락된 플러그인 메뉴 또는 쉘프를 참조하시기 바랍니다.

Q: 플러그인을 어떻게 업데이트하나요? A: Client App의 Plugins 패널을 열고 "Scan to update"를 클릭하고 DCC를 재시작합니다. 새 버전이 기존 버전을 제자리에 덮어씁니다.

Q: 플러그인이 Maya 2024+, 3ds Max 2025+, 또는 최신 Cinema 4D에서 작동하나요? A: SuperRenders App에서 설치하는 플러그인은 3ds Max 2023 이상, Maya 2022–2027, Cinema 4D 2023–2026을 지원합니다. 렌더팜 자체는 3ds Max 2013–2027, Maya 2014–2027, Cinema 4D R14–2027을 지원합니다. Cinema 4D 2027 씬은 업로드 전에 문의하여 확인해 주십시오. 최신 DCC에서 문제가 발생하면 티켓을 제출하시기 바랍니다. P1로 처리합니다.

Q: Client App을 설치하지 않고 플러그인을 설치할 수 있나요? A: 아니요. 제출 플러그인은 SuperRenders App의 PLUGIN 탭에서 설치합니다. App을 설치하고 싶지 않다면 팜이 렌더링하는 모든 DCC에서 작동하는 웹 대시보드를 통해 제출하시기 바랍니다.

Q: 플러그인이 열리지만 제출이 실패합니다. 어디를 확인해야 하나요? A: 제출 시간 오류는 일반적으로 장면이 올바르게 패키징되었지만 팜에서 무언가를 거부했음을 의미합니다. 누락된 에셋, 팜이 지원하지 않는 렌더러/엔진 버전, 또는 계정 청구 문제가 있을 수 있습니다. 오류 텍스트를 일반 오류와 비교하여 확인하시기 바랍니다. 메시지가 목록에 없으면 오류 텍스트와 작업 ID를 포함하여 티켓을 제출하시기 바랍니다.

---