Plugin nộp job: cài đặt, cập nhật và khắc phục sự cố theo DCC

Plugin nộp job SuperRenders (submission plugin) là một tiện ích mở rộng nhỏ bên trong phần mềm 3D của bạn, thêm menu "SuperRenders" hoặc nút shelf để bạn có thể nộp render job lên render farm mà không cần rời khỏi DCC. Plugin đóng gói scene, chạy kiểm tra asset và phiên bản trước khi nộp, rồi chuyển job vào hàng đợi render trong một bước duy nhất.
Hầu hết người dùng cài plugin nộp job từ tab PLUGIN của SuperRenders Client App: App phát hiện từng DCC được hỗ trợ trên máy trạm của bạn và cài plugin tương ứng. Các phần bên dưới hướng dẫn cài đặt theo từng DCC, cập nhật, cách khắc phục khi thiếu menu và cách gỡ plugin sạch sẽ.
Trang này bao gồm: plugin làm gì, DCC và renderer được hỗ trợ, cài đặt theo từng DCC từ SuperRenders App, quy trình cập nhật, cách khắc phục menu/shelf bị thiếu, cách gỡ cài đặt sạch sẽ, và ma trận tính năng.
Để biết quy trình nộp job sau khi plugin đã được cài đặt, xem Hướng dẫn bắt đầu nhanh và tài liệu thiết lập DCC tương ứng để biết ghi chú riêng theo renderer. Để cài đặt Client App, xem Client App.
Tổng quan về plugin
Plugin nộp job là phần bổ trợ phía DCC đi kèm với Client App. Client App xử lý upload, theo dõi job và tải về trên máy tính để bàn; plugin xử lý luồng "scene → job" bên trong DCC.
Những gì plugin làm bên trong DCC của bạn:
- Thêm menu SuperRenders hoặc nút shelf để bạn có thể mở hộp thoại nộp job mà không cần rời khỏi DCC.
- Đọc scene đang hoạt động — frame range, đường dẫn output, cài đặt render, asset được tham chiếu — và tự điền sẵn vào form job.
- Chạy kiểm tra asset trước khi nộp để đánh dấu texture thiếu, tham chiếu thiếu và đường dẫn file bị lỗi trước khi upload bắt đầu.
- Tạo phiên bản scene file cùng với asset để render farm render đúng trạng thái scene bạn đã nộp, không phải một bản chỉnh sửa sau đó.
- Chuyển job đã đóng gói đến Client App (Client App cần đang chạy — có thể để ở khay hệ thống hoặc thanh menu) để upload.
Trang này ghi lại các plugin nộp job được cài từ tab PLUGIN của SuperRenders App: 3ds Max (2023 trở lên), Maya (2022–2027), Cinema 4D (2023–2026), Houdini và Blender (4.2 LTS trở lên). Mỗi phần DCC bên dưới nêu cách cài đặt và phạm vi phiên bản.
Trước khi cài đặt
Một số điều cần xác nhận trước khi bạn cài plugin từ App:
- Sử dụng cùng tài khoản người dùng chạy DCC. Plugin cài vào thư mục script riêng của người dùng trong DCC, không phải vào thư mục program-files của DCC. Nếu bạn cài khi đăng nhập bằng tài khoản khác (ví dụ, tài khoản quản trị chỉ dùng để cài phần mềm), plugin sẽ không xuất hiện khi người dùng thường mở DCC. Hãy đăng nhập bằng tài khoản thực sự mở DCC và chạy lại trình cài đặt.
- Chạy DCC ít nhất một lần trước khi cài. Hầu hết DCC tạo thư mục script riêng của người dùng khi khởi chạy lần đầu. Cài trước khi thư mục đó tồn tại sẽ thất bại âm thầm trên một số phiên bản Maya và 3ds Max.
- Đóng DCC trong quá trình cài đặt. Script khởi động của plugin được đọc khi DCC tải. Nếu DCC đang chạy trong quá trình cài, hãy khởi động lại sau khi cài để script được nạp.
- Có sẵn tài khoản SuperRenders. Plugin yêu cầu đăng nhập lần đầu.
Nếu studio của bạn chạy máy trạm bị khóa mà người dùng không thể ghi vào thư mục Documents của họ, hãy liên hệ hỗ trợ — plugin cần quyền ghi vào thư mục script DCC tiêu chuẩn.
Cài đặt theo DCC
Để cài plugin trong mọi DCC: cài đặt Client App, mở bảng Plugins, và nhấn Scan to update. Client App phát hiện các DCC đã cài và đẩy plugin phù hợp vào từng DCC. Nếu scan-to-update không nhận ra DCC của bạn, hãy gửi ticket kèm phiên bản DCC và hệ điều hành của bạn.
3ds Max
Plugin cho 3ds Max được cài từ tab PLUGIN của Client App.
- Cài đặt Client App và mở tab PLUGIN.
- Cài plugin cho 3ds Max. App cài plugin vào từng phiên bản 3ds Max mà nó phát hiện được.
- Khởi động lại 3ds Max nếu menu SuperRenders không xuất hiện. Một số phiên bản 3ds Max chỉ đọc lại định nghĩa menu cấp cao nhất khi khởi động.
Phạm vi phiên bản 3ds Max: Farm hỗ trợ 3ds Max 2013–2027. Plugin được cài từ tab PLUGIN của Client App bao gồm 3ds Max 2023 trở lên.
Lưu ý về PySide / Qt trong 3ds Max 2026: Autodesk đã thay đổi phiên bản Qt qua các phiên bản 3ds Max gần đây, điều này từng ảnh hưởng đến giao diện plugin. Nếu menu SuperRenders xuất hiện nhưng hộp thoại nộp job mở ra trống hoặc báo lỗi Python, hãy tạo ticket hỗ trợ — chúng tôi sẽ xác nhận xem có cần vá plugin không.
Maya
Plugin cho Maya được cài từ tab PLUGIN của Client App vào từng phiên bản Maya được phát hiện, từ 2022 đến 2027.
Để cài đặt:
- Cài đặt Client App và mở tab PLUGIN.
- Cài plugin cho Maya. App cài plugin vào từng phiên bản Maya mà nó phát hiện được.
- Khởi động lại Maya. Shelf SuperRenders sẽ xuất hiện.
Phạm vi phiên bản Maya: Farm hỗ trợ Maya 2014–2027. Plugin được cài từ tab PLUGIN của Client App bao gồm Maya 2022 đến 2027.
Cinema 4D
Plugin Cinema 4D được cài từ tab PLUGIN của SuperRenders App.
Để cài đặt:
- Cài đặt SuperRenders Client App.
- Mở bảng Plugins bên trong Client App.
- Nhấn Scan to update. Client App phát hiện từng phiên bản Cinema 4D được cài trên máy trạm và cài plugin phù hợp vào thư mục plugins C4D.
- Khởi động lại Cinema 4D. Mục nộp job SuperRenders xuất hiện trong menu Extensions của C4D.
Nếu scan-to-update báo phiên bản Cinema 4D của bạn là "not supported," hãy tạo ticket với phiên bản C4D và hệ điều hành. Chúng tôi bổ sung các phiên bản Cinema 4D mới vào plugin theo lịch trình liên tục khi Maxon phát hành.
Phạm vi phiên bản Cinema 4D: Plugin được cài từ tab PLUGIN của Client App bao gồm Cinema 4D 2023 đến 2026. Bản thân farm hỗ trợ Cinema 4D R14–2027. Với scene Cinema 4D 2027, hãy liên hệ với chúng tôi để xác nhận trước khi bạn upload.
Blender
Blender 4.2 LTS trở lên có add-on nộp job SuperRenders. Add-on được cài từ tab PLUGIN của Client App. Sau khi bạn khởi động lại Blender, menu SuperRenders xuất hiện; hãy dùng menu đó để nộp scene đang mở.
Với phiên bản Blender cũ hơn 4.2, hoặc nếu bạn không muốn cài add-on, hãy nộp job qua luồng upload kéo-và-thả của Client App hoặc qua web dashboard. Metadata của file .blend được phân tích khi upload; Client App tự điền sẵn hầu hết các trường nộp job.
Nếu menu SuperRenders không xuất hiện sau khi khởi động lại, hãy xác nhận Blender là phiên bản 4.2 trở lên, rồi liên hệ hỗ trợ kèm phiên bản Blender và hệ điều hành của bạn.
Các DCC khác
Houdini cũng có plugin nộp job, được cài từ tab PLUGIN của Client App. Đối với After Effects và các DCC khác được render farm hỗ trợ, luồng nộp job chạy qua:
- web dashboard (Hướng dẫn bắt đầu nhanh) — hoạt động với mọi DCC mà render farm có thể xử lý,
- upload kéo-và-thả của Client App (Client App) — hoạt động với mọi DCC, với lợi ích là upload có thể tiếp tục và tự động tải về.
Để biết mẹo nộp job riêng cho Houdini, xem Thiết lập Houdini; để biết About After Effects xem Thiết lập After Effects. After Effects không có plugin nộp job SuperRenders; tài liệu thiết lập của nó hướng dẫn cách đóng gói và nộp dự án mà không cần plugin.
Quy trình cập nhật
SuperRenders App giữ plugin luôn cập nhật tự động. Khi SuperRenders phát hành bản cập nhật (phiên bản DCC mới, bản vá cho trình liên kết lại asset), App tải plugin mới và đề nghị cài vào lần khởi động tiếp theo.
Để chạy cập nhật thủ công:
- Đóng phần mềm 3D của bạn. DCC khóa file plugin khi đang chạy và có thể chặn âm thầm việc cập nhật.
- Mở bảng Plugins của Client App và nhấn Scan to update. Client App so sánh các phiên bản plugin đã cài với phiên bản mới nhất và cài phiên bản mới hơn khi có.
- Chờ cho đến khi mỗi hàng hiển thị "Up to date."
- Khởi động lại DCC. Phiên bản plugin mới được đọc ở lần khởi động tiếp theo.
Nếu "Scan to update" thất bại với một DCC cụ thể, nguyên nhân thường là: DCC vẫn đang chạy và giữ khóa file; tài khoản người dùng chạy Client App thiếu quyền ghi vào thư mục script của DCC (chạy Client App bằng cùng người dùng Windows chạy DCC); hoặc một lần cài thất bại trước đó để lại thư mục plugin không hoàn chỉnh (xóa theo hướng dẫn Gỡ cài đặt plugin rồi scan lại).
Nếu App không thể cập nhật plugin cho một DCC, hãy gỡ plugin (xem Gỡ cài đặt plugin) rồi chạy lại Scan to update.
Menu hoặc shelf plugin bị thiếu (khắc phục sự cố)
Nếu plugin cài đặt không có lỗi nhưng menu hoặc icon shelf SuperRenders không bao giờ xuất hiện, nguyên nhân cơ bản gần như luôn là một trong hai: plugin nằm sai thư mục, hoặc một công cụ bên thứ ba đã làm hỏng tùy chọn khởi động DCC.
Nguyên nhân 1 — Plugin cài vào thư mục script sai.
Plugin phải nằm trong thư mục script riêng của người dùng cho phiên bản DCC đang chạy. Nếu nó nằm ở nơi khác — thư mục của phiên bản Maya khác, hoặc hồ sơ người dùng Windows khác — DCC sẽ không tìm thấy khi khởi động.
Xác nhận trong Maya bằng cách mở Script Editor và chạy:
import superrenders_runner
superrenders_runner.init()Nếu cửa sổ nộp job SuperRenders mở ra, plugin đã được cài đúng và vấn đề shelf là sự cố UI (Nguyên nhân 2). Nếu bạn nhận được ImportError: No module named superrenders_runner, plugin không nằm trong Python path của Maya. Hãy gỡ plugin (xem Gỡ cài đặt plugin) và cài lại từ App, sau đó kiểm tra:
- Phiên bản Maya trong đường dẫn khớp với Maya bạn khởi động (ví dụ,
maya/2023/scripts/superrenderscho Maya 2023). - Người dùng Windows trong đường dẫn khớp với người dùng khởi động Maya.
- Đường dẫn bên trong
userSetup.meldùng dấu gạch chéo xuôi, không phải gạch chéo ngược.
Logic tương tự áp dụng cho 3ds Max và Cinema 4D — đường dẫn cài phải khớp với tài khoản người dùng đang chạy và phiên bản DCC.
Nguyên nhân 2 — Công cụ bên thứ ba làm hỏng tùy chọn shelf của DCC.
Nếu Script Editor xác nhận superrenders_runner import được nhưng icon shelf vẫn thiếu, tùy chọn shelf đã lưu của DCC thường bị hỏng — thường là do một plugin khác đã ghi đè.
Trong Maya:
- Thoát Maya.
- Tìm
userPrefs.mel: - Windows:C:\Users\<TênWindowsUser>\Documents\maya\<PhiênBảnMaya>\prefs\userPrefs.mel- macOS:~/Library/Preferences/Autodesk/maya/<PhiênBảnMaya>/prefs/userPrefs.mel - Đổi tên
userPrefs.melthànhuserPrefs.mel.backup(không xóa — giữ các bố cục shelf tùy chỉnh phòng khi muốn hợp nhất lại sau). - Khởi động lại Maya. Maya tạo lại
userPrefs.melmới và shelf SuperRenders sẽ xuất hiện.
Bạn sẽ mất các tùy chỉnh shelf và danh sách file gần đây; hợp nhất lại từ bản backup nếu cần.
Trong 3ds Max, cách khắc phục tương đương là Customize → Revert to Startup UI Layout, rồi cài lại plugin từ tab PLUGIN của Client App.
Nếu không nguyên nhân nào khớp, hãy tạo ticket hỗ trợ với: tên và phiên bản DCC, hệ điều hành và tài khoản người dùng, toàn bộ văn bản lỗi từ script editor / MAXScript Listener, và nội dung của userSetup.mel (Maya) hoặc log cài đặt MAXScript (3ds Max).
Gỡ cài đặt plugin
Để gỡ cài đặt plugin (để cài lại sạch sẽ hoặc dọn dẹp máy trạm dùng chung), quy trình theo từng DCC.
Maya:
- Thoát Maya.
- Xóa thư mục
superrenderstrong thư mục script của Maya: - Windows:C:\Users\<TênWindowsUser>\Documents\maya\<PhiênBảnMaya>\scripts\superrenders- macOS:~/Library/Preferences/Autodesk/maya/<PhiênBảnMaya>/scripts/superrenders - Mở
userSetup.melvà xóa khối giữa/***superrenders_begin***/và/***superrenders_end***/. Lưu lại. - Khởi động lại Maya. Lặp lại cho từng phiên bản Maya trên máy trạm.
3ds Max:
- Đóng 3ds Max.
- Đặt lại UI về mặc định qua Customize → Revert to Startup UI Layout khi khởi động lại, hoặc xóa các file macroscript SuperRenders từ
C:\Users\<TênWindowsUser>\AppData\Local\Autodesk\3dsMax\<Phiên bản>\ENU\usermacros\(các file bắt đầu bằngSuperRenders_). - Khởi động lại 3ds Max.
Cinema 4D: đóng Cinema 4D, xóa thư mục plugin SuperRenders trong thư mục plugins C4D cho phiên bản C4D đó, và khởi động lại Cinema 4D. Client App hiện chưa có nút gỡ cài đặt riêng theo DCC.
Sau khi gỡ cài đặt, Client App và web dashboard vẫn nộp được job mà không cần plugin.
Ma trận tính năng được hỗ trợ của plugin nộp job
Ma trận bên dưới tóm tắt khả năng của plugin nộp job theo DCC. Hàng phiên bản phản ánh plugin được cài từ SuperRenders App hiện nay. Các hàng còn lại của 3ds Max, Maya và Cinema 4D được rút từ các danh sách tính năng đã được ghi lại cho thế hệ plugin trước (2023–2024) và chưa được xác nhận lại từng mục cho plugin hiện tại. Add-on Blender (Blender 4.2 LTS trở lên) được cài từ tab PLUGIN của SuperRenders App và nộp scene đang mở; các khả năng khác của nó chưa được ghi lại ở đây. Plugin Houdini cũng được cài từ SuperRenders App và chưa nằm trong ma trận này.
| Khả năng | 3ds Max | Maya | Cinema 4D | Blender |
|---|---|---|---|---|
| Phiên bản DCC được plugin nộp job hỗ trợ (hẹp hơn dải hỗ trợ của chính farm) | 2023 trở lên (Client App) | 2022–2027 (Client App) | 2023–2026 (Client App) | 4.2 LTS trở lên (Client App) |
| Đóng gói scene khi nộp | Có | Có | Có | Chưa có tài liệu |
| Kiểm tra asset trước khi nộp | Có | Có | Có | Chưa có tài liệu |
| Trình liên kết lại asset (texture tracker) | Có | Có | Có (C4D texture tracker) | Chưa có tài liệu |
| Nộp theo frame range / frame đơn / range / frame được chọn | Có | Có | Có | Chưa có tài liệu |
| Scene / XRef được tham chiếu | Có | Có (binary .mb + ASCII .ma) | Có (XRefs, file sequence, texture, GI map) | Chưa có tài liệu |
| Output render-pass / multi-pass | Có | Có | Có (main + multi-pass + render element + AOV + Corona buffer) | Chưa có tài liệu |
| Tạo phiên bản scene phía render farm | Có | Có (tích hợp tự động đầy đủ) | Có (tạo phiên bản + kiểm tra scene phía server) | Chưa có tài liệu |
| Render hình tĩnh tiled / độ phân giải cao | — | — | Có (C4D tiled camera) | Chưa có tài liệu |
| Nhiều chế độ GI cache | — | — | Có (Irradiance cache, QMC, Light Mapping, Radiosity, UHD Cache, HD Cache, Path Tracing, Light Cache, Brute Force) | Chưa có tài liệu |
| Engine được hỗ trợ | V-Ray, Corona (hỗ trợ renderer là phía farm; plugin đóng gói scene bất kể) | Arnold, V-Ray, Redshift (hỗ trợ renderer là phía farm; plugin đóng gói scene bất kể) | Advanced Render, Physical, V-Ray, Corona (hỗ trợ renderer là phía farm; plugin đóng gói scene bất kể) | Hỗ trợ renderer là phía farm; xem Thiết lập Blender |
Ma trận theo dõi những gì plugin xử lý bên trong DCC. Hỗ trợ engine phía render farm, tức engine nào thực sự render job của bạn, rộng hơn và được theo dõi theo tài liệu thiết lập DCC tương ứng. Plugin đóng gói scene; renderer (Arnold, V-Ray, Redshift, v.v.) chạy phía farm.
Ghi chú về tính hiện tại
Client App cài plugin cho 3ds Max 2023 trở lên, Maya 2022–2027, Cinema 4D 2023–2026 và Blender 4.2 LTS trở lên. Dải hỗ trợ của chính farm rộng hơn. Nếu bạn gặp sự cố plugin trên DCC mới hơn, hãy tạo ticket; chúng tôi xử lý đó là P1.
Khi nào plugin không phải là lựa chọn phù hợp
Một số quy trình làm việc phù hợp hơn khi không dùng plugin ngay cả khi nó đã được cài đặt và hoạt động:
- Nộp job một lần khi bạn không muốn cài gì vào DCC. Dùng web dashboard.
- Máy trạm studio bị khóa nơi người dùng không có quyền ghi vào thư mục script. Dùng web dashboard.
- Máy chuẩn bị render không có giao diện (headless) không có GUI để nhấp qua hộp thoại nộp job của plugin. Dùng kéo-và-thả Client App.
- DCC không có plugin nộp job (ví dụ After Effects), và Blender cũ hơn 4.2. Nộp qua Client App hoặc web dashboard.
Client App, web dashboard và plugin nộp job không loại trừ nhau — một dự án có thể upload qua Client App và nộp qua plugin, hoặc upload qua web và nộp qua plugin. Hãy chọn đường dẫn phù hợp với máy trạm của bạn.
Tham chiếu chéo
- Client App — ứng dụng desktop cho upload, nộp job và tải về
- Hướng dẫn bắt đầu nhanh — luồng nộp job qua trình duyệt không cần plugin
- Nộp job qua web — chi tiết nộp job qua trình duyệt
- Upload và download — so sánh các phương thức upload
- Thiết lập Maya — ghi chú nộp job riêng cho Maya
- Thiết lập 3ds Max — ghi chú nộp job riêng cho 3ds Max
- Thiết lập Cinema 4D — ghi chú nộp job riêng cho Cinema 4D
- Thiết lập Blender — nộp job Blender qua Client App / web
- Lỗi thường gặp — khắc phục sự cố đa DCC
FAQ
Q: Tôi có phải cài plugin nộp job không, hay có thể nộp job mà không cần nó? A: Plugin là tùy chọn. Cả Client App và web dashboard đều nộp được job mà không cần plugin DCC. Plugin là tiện ích cho người dùng muốn nộp từ bên trong phần mềm 3D của họ chỉ một cú nhấp.
Q: Ứng dụng 3D nào có plugin nộp job SuperRenders? A: Các plugin được cài từ tab PLUGIN của Client App bao gồm 3ds Max (2023 trở lên), Maya, Cinema 4D, Houdini và Blender (4.2 LTS trở lên). After Effects không có plugin nộp job; job từ After Effects được nộp qua Client App hoặc web dashboard.
Q: Tại sao menu SuperRenders không xuất hiện sau khi cài đặt? A: Nguyên nhân phổ biến nhất: plugin nằm sai thư mục script (thường do cài bằng tài khoản khác với người dùng chạy DCC), hoặc tùy chọn shelf đã lưu của DCC bị hỏng. Xem Menu hoặc shelf plugin bị thiếu để biết luồng chẩn đoán đầy đủ.
Q: Làm thế nào để cập nhật plugin? A: Mở bảng Plugins của Client App, nhấn "Scan to update" và khởi động lại DCC. Phiên bản mới ghi đè phiên bản cũ tại chỗ.
Q: Plugin có hoạt động trên Maya 2024+, 3ds Max 2025+, hoặc Cinema 4D mới nhất không? A: Plugin được cài từ Client App bao gồm 3ds Max 2023 trở lên, Maya 2022–2027 và Cinema 4D 2023–2026. Bản thân farm hỗ trợ 3ds Max 2013–2027, Maya 2014–2027 và Cinema 4D R14–2027. Với scene Cinema 4D 2027, hãy liên hệ với chúng tôi để xác nhận trước khi bạn upload. Tạo ticket nếu bạn gặp sự cố trên DCC mới hơn; chúng tôi xử lý đó là P1.
Q: Tôi có thể cài plugin mà không cài Client App không? A: Không. Các plugin nộp job được cài từ tab PLUGIN của Client App. Nếu bạn không muốn cài App, hãy nộp job qua web dashboard, hoạt động với mọi DCC mà farm có thể render.
Q: Plugin mở được nhưng nộp job thất bại. Tôi cần kiểm tra ở đâu? A: Lỗi khi nộp thường có nghĩa là scene đã được đóng gói đúng nhưng render farm từ chối vì nguyên nhân nào đó — asset thiếu, phiên bản renderer / engine mà farm không hỗ trợ, hoặc vấn đề thanh toán tài khoản. Kiểm tra văn bản lỗi theo Lỗi thường gặp. Nếu thông báo không có trong danh sách, tạo ticket với văn bản lỗi và job ID.