Plugin SuperRenders: instalar e resolver

O plugin de submissão SuperRenders é uma pequena extensão dentro do software 3D que adiciona um menu "SuperRenders" ou um botão de barra, permitindo submeter um trabalho de renderização para a nossa render farm sem sair do DCC. O plugin empacota a cena, executa uma verificação prévia de recursos e versão e entrega o trabalho à fila da render farm num único passo.

A maioria dos utilizadores não precisa de instalar o plugin manualmente. Ao instalar o , o plugin correspondente é detetado automaticamente e instalado em cada DCC suportado na estação de trabalho. As secções seguintes cobrem os casos em que o caminho de instalação automática não funciona — nova versão do DCC, localização de instalação personalizada, conta de utilizador restrita — ou quando se prefere uma instalação manual para garantir reprodutibilidade.

Esta página abrange o que o plugin de submissão faz, os DCCs e motores suportados, os passos de instalação manual por DCC, o procedimento de atualização, a correção de menu ou barra em falta, como remover o plugin de forma limpa e uma matrix de funcionalidades v1.

Para o fluxo de trabalho de submissão de trabalhos depois de o plugin estar instalado, consulte o e o relevante para notas específicas por motor de renderização. Para a instalação do Client App, consulte .

Visão geral do plugin

O plugin de submissão é o componente DCC do Client App. O Client App trata do upload, acompanhamento de trabalhos e download no ambiente de trabalho; o plugin trata do fluxo "cena → trabalho" dentro do DCC.

O que o plugin faz dentro do DCC:

Adiciona um menu SuperRenders ou botão de barra para abrir o diálogo de submissão sem sair do DCC.
Lê a cena ativa — intervalo de fotogramas, caminho de saída, definições de renderização, recursos referenciados — e pré-preenche o formulário de trabalho.
Executa uma verificação prévia de recursos para assinalar texturas em falta, referências em falta e caminhos de ficheiros quebrados antes de o upload começar.
Cria uma versão do ficheiro de cena juntamente com os seus recursos para que a render farm renderize exatamente o estado da cena submetida, não uma edição posterior.
Entrega o trabalho empacotado ao Client App (ou diretamente à fila da render farm se o serviço de fundo do Client App estiver em execução) para upload.

Esta página documenta o plugin v1, o plugin de produção atual incluído com o Client App e a única geração de plugins disponível para clientes hoje. Uma geração futura poderá ser disponibilizada juntamente com a ferramenta de migração para o Spaces (consulte ); quando isso acontecer, uma página separada cobrirá o novo plugin. Os DCCs e motores suportados pelo plugin v1 hoje estão listados na matrix de funcionalidades abaixo.

Antes de instalar

Alguns aspetos a confirmar antes de executar qualquer um dos procedimentos de instalação manual abaixo:

Usar a mesma conta de utilizador que executa o DCC. O plugin instala-se na pasta de scripts do DCC do utilizador, não no diretório de ficheiros de programa do DCC. Se a instalação for feita com uma conta diferente (por exemplo, uma conta de administrador usada apenas para instalar software), o plugin não aparecerá quando o utilizador normal abrir o DCC. Deve iniciar sessão como o utilizador que efetivamente abre o DCC e executar novamente o instalador.
Executar o DCC pelo menos uma vez antes de instalar. A maioria dos DCCs cria a pasta de scripts específica do utilizador no primeiro arranque. A instalação antes de essa pasta existir falha silenciosamente em algumas versões do Maya e do 3ds Max.
Fechar o DCC durante a instalação. O script de arranque do plugin é lido quando o DCC carrega. Se o DCC estiver em execução durante a instalação, reiniciá-lo após a instalação para que o script seja detetado.
Ter uma conta SuperRenders pronta. O plugin solicita o início de sessão no primeiro arranque.

Se o estúdio utilizar uma imagem de estação de trabalho bloqueada em que os utilizadores não podem escrever na própria pasta Documentos, contacte o suporte — o plugin requer acesso de escrita ao diretório de scripts padrão do DCC.

Instalação por DCC

O primeiro passo a tentar em todos os DCCs é o caminho de instalação automática: instalar o , abrir o painel Plugins e clicar em Scan to update. O Client App deteta os DCCs instalados e instala o plugin correto em cada um. Os passos manuais abaixo são a alternativa para quando a opção de atualização por scan não deteta o DCC, quando se pretende uma instalação reproduzível numa máquina nova, ou quando se pretende instalar o plugin sem o serviço do Client App em execução em segundo plano.

3ds Max (instalação automática + alternativa manual)

O plugin v1 para 3ds Max é fornecido como um único pacote MAXScript .mzp. O fluxo de atualização por scan do Client App trata a instalação nos casos normais. A instalação manual é um processo de dois passos.

Descarregar o pacote. Obter superrenders.mzp a partir da ligação estática SuperRenders que o painel de conta fornece (o Client App também armazena uma cópia local na sua pasta de cache de plugins). [RICHARD: cần confirm current public download URL — Crisp source references a legacy S3 path that may be retired]
Executar o script dentro do 3ds Max. Abrir o 3ds Max, depois Scripting → Run Script…, localizar superrenders.mzp e confirmar. O script regista o plugin e adiciona um menu SuperRenders à barra de menus de nível superior.
Reiniciar o 3ds Max se o menu não aparecer. Algumas versões do 3ds Max apenas releem as definições de menus de nível superior no arranque.

Compatibilidade com versões do 3ds Max: o wrapper 3ds Max do plugin v1 foi utilizado em produção com o 3ds Max 2018 a 2024. O 3ds Max 2025 e 2026 não foram verificados de forma independente pelo SRF numa nova instalação. [RICHARD: cần confirm plugin v1 install path on 3ds Max 2025 / 2026 — Crisp source dated 2024-01-24, predates these versions.]

Uma nota sobre as versões de PySide/Qt no 3ds Max 2026: a Autodesk alterou as versões do Qt em versões recentes do 3ds Max, o que historicamente afetou as interfaces gráficas dos plugins. Se o menu SuperRenders aparecer mas o diálogo de submissão abrir em branco ou apresentar um erro de Python, por favor abra um ticket — confirmar-se-á se é necessária uma correção no plugin.

Maya (instalação automática + alternativa manual)

O plugin v1 para Maya é fornecido como um pacote de scripts em formato zip (superrenders_maya_v2xx.zip). O Client App instala-o automaticamente na pasta de scripts do Maya para cada versão detetada. A instalação manual é necessária quando o Client App não consegue detetar uma versão do Maya (tipicamente numa versão recentemente instalada antes de a tabela de compatibilidade do Client App ser atualizada).

Instalação manual, cinco passos:

Descarregar o pacote. Obter superrenders_maya_v240.zip (ou a versão mais recente indicada no painel da conta) a partir do caminho de recursos estáticos SuperRenders. [RICHARD: cần confirm current download URL — Crisp source references s3.us-east-1.amazonaws.com/statics.superrendersfarm.com/app/plugins/superrenders_maya_v240.zip, dated 2024-12.]
Extrair para a pasta de scripts do Maya. Descompactar para o diretório de scripts por versão do Maya: C:\Users\<WindowsUser>\Documents\maya\<VersãoMaya>\scripts\superrenders Por exemplo, no Maya 2023 com o utilizador Windows admin, o caminho é C:\Users\admin\Documents\maya\2023\scripts\superrenders. No macOS, o caminho equivalente é ~/Library/Preferences/Autodesk/maya/<VersãoMaya>/scripts/superrenders.
Editar userSetup.mel. Localizar ou criar userSetup.mel na pasta scripts superior (um nível acima de superrenders): C:\Users\<WindowsUser>\Documents\maya\<VersãoMaya>\scripts\userSetup.mel
Adicionar o bloco de inicialização SuperRenders ao userSetup.mel: /***superrenders_begin***/ python("import sys"); python("sys.path.append(u'__srfscriptPath__')"); python("import superrenders_runner"); python("superrenders_runner.init()"); /***superrenders_end***/ Substituir __srfscriptPath__ pelo caminho completo com barras normais para a pasta superrenders, por exemplo: C:/Users/admin/Documents/maya/2023/scripts/superrenders As barras normais são obrigatórias. As barras invertidas quebram a chamada sys.path.append do Python.
Reiniciar o Maya. A barra e o menu SuperRenders deverão aparecer no próximo arranque.

Compatibilidade com versões do Maya: o plugin v1 foi utilizado em produção no Maya 2017 a 2023 (de acordo com a matrix de funcionalidades documentada no Crisp). O Maya 2024, 2025 e 2026 são amplamente utilizados atualmente, mas não foram verificados de forma independente pelo SRF para a instalação do plugin v1. [RICHARD: cần confirm plugin v1 install path on Maya 2024 / 2025 / 2026 — Crisp install doc dated 2024-12, feature matrix dated 2023.]

Cinema 4D (apenas instalação automática pelo Client App)

O plugin para Cinema 4D é instalado pelo fluxo de atualização por scan do Client App. Não existe um instalador manual separado do tipo .mzp publicado para o plugin v1 do Cinema 4D atualmente.

Para instalar:

Instalar o .
Abrir o painel Plugins dentro do Client App.
Clicar em Scan to update. O Client App deteta cada versão do Cinema 4D instalada na estação de trabalho e instala o plugin correspondente no diretório de plugins do C4D.
Reiniciar o Cinema 4D. A entrada de submissão SuperRenders aparece no menu Extensões do C4D.

Se a atualização por scan reportar a versão do Cinema 4D como "não suportada", abra um ticket com a versão do C4D e o sistema operativo. Adicionam-se versões do Cinema 4D ao plugin v1 de forma contínua à medida que a Maxon lança versões principais.

Compatibilidade com versões do Cinema 4D: a matrix de funcionalidades documentada no Crisp lista o Cinema 4D R15 a R25 com os motores Advanced Render, Physical, V-Ray e Corona. [RICHARD: cần confirm plugin v1 support on Cinema 4D 2023, 2024, 2025 (the post-R26 rebrand) — Crisp source matrix has not been refreshed since the C4D version naming change.] Os motores GPU do Cinema 4D Redshift e Octane são tipicamente suportados pelo mesmo plugin, mas a confirmação da lista fica atrás do ritmo de lançamento da Maxon.

Blender

O Blender não tem atualmente um plugin de submissão SuperRenders no plugin v1. A submissão a partir do Blender é feita através do ou através do .

Os utilizadores do Blender podem ainda assim pré-visualizar e configurar trabalhos dentro do Blender (intervalo de fotogramas, formato de saída, escolha do motor — Cycles ou Eevee) e depois submeter através do Client App sem perder o contexto da cena. Os metadados do ficheiro .blend são analisados no upload; o Client App pré-preenche automaticamente a maioria dos campos de submissão.

Um add-on nativo para Blender não consta do roteiro publicado atualmente. Se o suporte a plugins no Blender for importante para o fluxo de trabalho, por favor envie um pedido de funcionalidade — acompanha-se a procura e publicar-se-á uma atualização do roteiro quando o momento for adequado.

Outros DCCs

O plugin v1 cobre o 3ds Max, o Maya e o Cinema 4D nativamente. Para o Houdini, o After Effects e outros DCCs suportados pela render farm, o fluxo de submissão é feito através de:

o painel web () — funciona para todos os DCCs que a render farm renderiza,
o upload por arrastar e largar do Client App () — funciona para todos os DCCs, com os benefícios de upload retomável e download automático,
SFTP () — recomendado para projetos muito grandes.

Para dicas de submissão específicas do Houdini, consulte ; para After Effects, consulte . Nenhum desses DCCs tem atualmente um plugin de submissão com a marca SuperRenders; os documentos de configuração por DCC explicam como empacotar e submeter uma cena sem um.

Procedimento de atualização

O Client App mantém o plugin v1 atualizado automaticamente. Quando a SuperRenders lança uma atualização — uma nova versão de DCC, uma correção ao revinculador de recursos — o Client App obtém o novo plugin e oferece-se para o instalar no próximo arranque.

Para executar uma atualização manualmente:

Fechar o software 3D. Os DCCs bloqueiam os ficheiros do plugin enquanto estão em execução e podem bloquear silenciosamente a atualização.
Abrir o painel Plugins do Client App e clicar em Scan to update. O Client App compara as versões do plugin instaladas com as mais recentes e instala as mais novas onde disponíveis.
Aguardar até que cada linha mostre "Up to date".
Reiniciar o DCC. A nova versão do plugin é lida no próximo arranque.

Se "Scan to update" falhar para um DCC específico, as causas habituais são: o DCC ainda está em execução e mantém um bloqueio de ficheiro; a conta de utilizador que executa o Client App não tem permissão de escrita na pasta de scripts do DCC (executar o Client App com o mesmo utilizador Windows que executa o DCC); ou uma instalação anterior falhada deixou uma pasta de plugin incompleta (removê-la conforme descrito em Remover o plugin e executar novamente o scan).

Quando o Client App não está disponível, executar novamente os passos de instalação manual nas secções por DCC acima com o pacote de plugin mais recente. O plugin foi concebido para ser substituído no local.

Se o plugin se instalar sem erros mas o menu ou ícone de barra SuperRenders nunca aparecer, a causa subjacente é quase sempre uma de duas situações: o plugin foi instalado no diretório errado, ou uma ferramenta de terceiros corrompeu as preferências de arranque do DCC.

Causa 1 — Plugin instalado no diretório de scripts errado.

O plugin deve estar na pasta de scripts específica do utilizador para a versão do DCC em execução. Se ficar noutro local — a pasta de outra versão do Maya, ou o perfil de outro utilizador Windows — o DCC não o encontrará no arranque.

Para confirmar no Maya, abrir o Script Editor e executar:

text

import superrenders_runner
superrenders_runner.init()

Se a janela de submissão SuperRenders abrir, o plugin está corretamente instalado e o problema da barra é um problema de interface (Causa 2). Se aparecer ImportError: No module named superrenders_runner, o plugin não está no caminho Python do Maya. Executar novamente os passos de instalação manual em Instalação no Maya, prestando atenção a:

A versão do Maya no caminho corresponde ao Maya que se abre (por exemplo, maya/2023/scripts/superrenders para o Maya 2023).
O utilizador Windows no caminho corresponde ao utilizador que abre o Maya.
O caminho dentro de userSetup.mel usa barras normais, não barras invertidas.

A mesma lógica aplica-se ao 3ds Max e ao Cinema 4D — o caminho de instalação deve corresponder à conta de utilizador em execução e à versão do DCC.

Causa 2 — Uma ferramenta de terceiros corrompeu as preferências de barra do DCC.

Se o Script Editor confirmar que superrenders_runner é importado mas o ícone da barra ainda está em falta, as preferências de barra guardadas do DCC estão normalmente corrompidas — tipicamente porque outro plugin as reescreveu.

No Maya:

Fechar o Maya.
Localizar userPrefs.mel: - Windows: C:\Users\<WindowsUser>\Documents\maya\<VersãoMaya>\prefs\userPrefs.mel - macOS: ~/Library/Preferences/Autodesk/maya/<VersãoMaya>/prefs/userPrefs.mel
Renomear userPrefs.mel para userPrefs.mel.backup (não apagar — preservar as personalizações de barra por precaução).
Reiniciar o Maya. O Maya gera um novo userPrefs.mel e a barra SuperRenders deverá aparecer.

As personalizações de barra e as listas de ficheiros recentes serão perdidas; podem ser restauradas a partir da cópia de segurança se necessário.

No 3ds Max, a correção equivalente é Customize → Revert to Startup UI Layout, seguido de nova execução da instalação do superrenders.mzp.

Se nenhuma das causas corresponder, abra um ticket de suporte com: nome e versão do DCC, sistema operativo e conta de utilizador, o texto completo do erro do editor de scripts/MAXScript Listener e o conteúdo de userSetup.mel (Maya) ou do registo de instalação MAXScript (3ds Max).

Remover o plugin

Para desinstalar o plugin v1 — reinstalação limpa, limpeza de estação de trabalho partilhada ou preparação pré-migração — o procedimento é por DCC.

Maya:

Fechar o Maya.
Apagar a pasta superrenders no diretório de scripts do Maya: - Windows: C:\Users\<WindowsUser>\Documents\maya\<VersãoMaya>\scripts\superrenders - macOS: ~/Library/Preferences/Autodesk/maya/<VersãoMaya>/scripts/superrenders
Abrir userSetup.mel e remover o bloco entre /***superrenders_begin***/ e /***superrenders_end***/. Guardar.
Reiniciar o Maya. Repetir para cada versão do Maya na estação de trabalho.

3ds Max:

Fechar o 3ds Max.
Repor a interface para as predefinições a partir de Customize → Revert to Startup UI Layout no próximo arranque, ou apagar os ficheiros de macroscript SuperRenders de C:\Users\<WindowsUser>\AppData\Local\Autodesk\3dsMax\<Versão>\ENU\usermacros\ (ficheiros que começam por SuperRenders_).
Reiniciar o 3ds Max.

Cinema 4D: fechar o Cinema 4D, apagar a pasta do plugin SuperRenders no diretório de plugins do C4D para essa versão, e reiniciar o Cinema 4D. O Client App não expõe atualmente um botão de desinstalação por DCC.

Após a remoção, o e o continuam a submeter trabalhos sem o plugin.

Matrix de funcionalidades suportadas pelo plugin v1

A matrix abaixo resume as capacidades do plugin v1 por DCC, baseadas nas listas de funcionalidades documentadas no Crisp. Os itens marcados com [verificar] aguardam confirmação de atualidade face à versão mais recente do DCC; consulte a nota de atualidade que se segue.

| Capacidade | 3ds Max | Maya | Cinema 4D | Blender | |---|---|---|---|---| | Versões de DCC cobertas (base Crisp) | 2018–2024 [verificar 2025/2026] | 2017–2023 [verificar 2024/2025/2026] | R15–R25 [verificar nomenclatura pós-R26] | (sem plugin nativo) | | Empacotamento de cena na submissão | Sim | Sim | Sim | (usar upload do Client App) | | Verificação prévia de recursos | Sim | Sim | Sim | — | | Revinculador de recursos (rastreador de texturas) | Sim | Sim | Sim (rastreador de texturas C4D) | — | | Submissão de intervalo de fotogramas / fotograma único / intervalo / fotogramas selecionados | Sim | Sim | Sim | — | | Cenas referenciadas / XRefs | Sim | Sim (.mb binário + .ma ASCII) | Sim (XRefs, sequências de ficheiros, texturas, mapas GI) | — | | Saída de passe de renderização / multi-passe | Sim | Sim | Sim (principal + multi-passe + elementos de renderização + AOVs + buffers Corona) | — | | Versionamento de cena no lado da render farm | Sim | Sim (integração automatizada completa) | Sim (versionamento e verificação de cena do lado do servidor) | — | | Renderização em mosaico / alta resolução estática | — | — | Sim (câmara em mosaico C4D) | — | | Múltiplos modos de cache GI | — | — | Sim (cache de irradiância, QMC, Light Mapping, Radiosity, UHD Cache, HD Cache, Path Tracing, Light Cache, Brute Force) | — | | Motores suportados (base Crisp) | V-Ray, Corona [verificar Redshift via plugin] | Arnold, V-Ray, Redshift (o suporte ao motor é do lado da render farm; o plugin empacota a cena independentemente) | Advanced Render, Physical, V-Ray, Corona [verificar Redshift, Octane] | (escolha do motor no upload do Client App) |

A matrix acompanha o que o wrapper do plugin v1 trata dentro do DCC. O suporte ao motor do lado da render farm — quais os motores que renderizam efetivamente o trabalho — é mais abrangente e está documentado no relevante. O plugin v1 empacota a cena; o motor de renderização (Arnold, V-Ray, Redshift, etc.) é executado do lado da render farm.

Nota de atualidade

A matrix tem como fonte as entradas do Crisp KB publicadas em 2023–2024. As versões mais recentes de DCC (3ds Max 2025/2026, Maya 2024/2025/2026, nomenclatura do Cinema 4D pós-R26, atualizações contínuas de Redshift/Octane) têm grande probabilidade de funcionar — o plugin v1 tem sido mantido de forma incremental — mas o SRF não publicou uma confirmação atualizada para cada nova versão. As linhas com [verificar] serão atualizadas como parte da manutenção da Fase 2c assim que o Dev confirmar a matrix de testes por versão. Se surgir um problema com o plugin numa versão mais recente de DCC, por favor abra um ticket — tratamos isso como P1.

[RICHARD: cần confirm — full plugin v1 DCC + engine compatibility table refresh from Dev: 3ds Max 2025 / 2026, Maya 2024 / 2025 / 2026, Cinema 4D 2023+ post-rebrand, Redshift / Octane per C4D and Maya. Dev refresh replaces the [verify] rows.]

Quando o plugin não é o caminho certo

Alguns fluxos de trabalho são melhor servidos sem o plugin, mesmo quando está instalado e a funcionar:

Submissões pontuais em que não se quer instalar nada no DCC. Usar o .
Estações de trabalho de estúdio bloqueadas em que os utilizadores não têm acesso de escrita à própria pasta de scripts. Usar o ou .
Máquinas de preparação de renderização sem interface gráfica para clicar no diálogo de submissão do plugin. Usar o ou SFTP.
DCCs que o plugin não cobre (Blender, Houdini, After Effects). Submeter via ou .

O Client App, o painel web e o plugin de submissão não são mutuamente exclusivos — um único projeto pode ser enviado via Client App e submetido via plugin, ou enviado via SFTP e submetido via painel web. Deve escolher-se o caminho que melhor se adapta à estação de trabalho.

Referências cruzadas

— aplicação de ambiente de trabalho para upload, submissão e download
— fluxo de submissão pelo browser sem o plugin
— detalhes de submissão baseada em browser
— caminho de upload alternativo para projetos muito grandes
— comparação de métodos de upload
— notas de submissão específicas do Maya
— notas de submissão específicas do 3ds Max
— notas de submissão específicas do Cinema 4D
— submissão do Blender via Client App / web
— resolução de problemas transversal a DCCs

FAQ

Q: É obrigatório instalar o plugin de submissão, ou é possível submeter trabalhos sem ele? A: O plugin é opcional. O e o submetem trabalhos sem um plugin DCC. O plugin é uma conveniência para os utilizadores que preferem submeter a partir do software 3D num único clique.

Q: Quais as aplicações 3D que têm um plugin de submissão SuperRenders? A: O plugin v1 cobre o 3ds Max, o Maya e o Cinema 4D. O Blender, o Houdini e o After Effects não têm um plugin nativo atualmente; os trabalhos desses DCCs são submetidos através do Client App ou do painel web.

Q: Porque é que o menu SuperRenders não aparece depois de instalar? A: As causas mais comuns: o plugin ficou na pasta de scripts errada (frequentemente porque foi instalado com um utilizador diferente do que executa o DCC), ou as preferências de barra guardadas do DCC estão corrompidas. Consulte Menu ou barra do plugin em falta para o fluxo de diagnóstico completo.

Q: Como se atualiza o plugin? A: Abrir o painel Plugins do Client App, clicar em "Scan to update" e reiniciar o DCC. As atualizações manuais também funcionam — executar novamente os passos de instalação por DCC com o pacote de plugin mais recente; a nova versão substitui a antiga no local.

Q: O plugin funciona no Maya 2024+, 3ds Max 2025+, ou na versão mais recente do Cinema 4D? A: A matrix documentada do plugin v1 cobre o Maya 2017–2023, o 3ds Max 2018–2024 e o Cinema 4D R15–R25. As versões mais recentes de DCC têm grande probabilidade de funcionar porque o plugin v1 tem sido mantido de forma incremental, mas o SRF não publicou uma confirmação atualizada por versão. A matrix assinala essas linhas como [verificar] aguardando atualização pelo Dev. Abrir um ticket em caso de problema com um DCC mais recente — P1.

Q: É possível instalar o plugin sem instalar o Client App? A: Sim, para o 3ds Max e o Maya — os passos de instalação manual nesta página usam o pacote de plugin autónomo. O caminho de instalação manual sem o Client App para o Cinema 4D não está publicado atualmente; recomenda-se instalar o Client App para a instalação do plugin C4D.

Q: O plugin abre mas a submissão falha. O que verificar? A: Os erros em tempo de submissão significam normalmente que a cena foi empacotada corretamente mas a render farm rejeitou algo — um recurso em falta, uma versão de motor não suportada pela render farm, ou um problema de faturação da conta. Verificar o texto de erro em . Se a mensagem não estiver listada, abrir um ticket com o texto de erro e o ID do trabalho.

Plugin de submissão: instalação, atualização e resolução de problemas por DCC