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

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 SuperRenders Client App, 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 Guia de início rápido e o documento de configuração do DCC relevante para notas específicas por motor de renderização. Para a instalação do Client App, consulte Client App.

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 Client App § Caminho de migração: Spaces); 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 Client App, 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.

1. Descarregar o pacote. Pedir ao suporte a ligação estática de descarregamento de superrenders.mzp (o Client App também armazena uma cópia local na sua pasta de cache de plugins).
2. 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.
3. 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: a render farm suporta o 3ds Max 2013 a 2027. O plugin que se instala a partir do separador PLUGIN da Client App SuperRenders abrange o 3ds Max 2023 e posteriores. O pacote manual .mzp acima foi utilizado em produção com o 3ds Max 2018 a 2024.

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:

1. Descarregar o pacote. Pedir ao suporte a ligação estática de descarregamento de superrenders_maya_v240.zip (ou da versão mais recente).
2. 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.
3. 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
4. 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.
5. Reiniciar o Maya. A barra e o menu SuperRenders deverão aparecer no próximo arranque.

Compatibilidade com versões do Maya: a render farm suporta o Maya 2014 a 2027; o intervalo indicado a seguir é a cobertura de versões do anfitrião verificada de forma independente para o próprio plugin v1, que é mais restrita. 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.

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:

1. Instalar o SuperRenders Client App.
2. Abrir o painel Plugins dentro do Client App.
3. 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.
4. 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. 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 4.2 LTS e posteriores tem um add-on de submissão SuperRenders. É instalado a partir do separador PLUGIN da Client App SuperRenders. Depois de reiniciar o Blender, aparece um menu SuperRenders, que permite submeter a cena aberta.

Para versões do Blender anteriores à 4.2, ou quando não se pretende instalar o add-on, a submissão é feita através do fluxo de upload por arrastar e largar do Client App ou do painel web. Os metadados do ficheiro .blend são analisados no upload; o Client App pré-preenche automaticamente a maioria dos campos de submissão.

Se o menu SuperRenders não aparecer depois de reiniciar, confirmar que o Blender é da versão 4.2 ou posterior e depois contactar o suporte indicando a versão do Blender e o sistema operativo.

Outros DCCs

O Houdini também tem um plugin de submissão, instalado a partir do separador PLUGIN da Client App SuperRenders. Para o After Effects e outros DCCs suportados pela render farm, o fluxo de submissão é feito através de:

• o painel web (Guia de início rápido) — funciona para todos os DCCs que a render farm renderiza,
• o upload por arrastar e largar do Client App (Client App) — funciona para todos os DCCs, com os benefícios de upload retomável e download automático.

Para dicas de submissão específicas do Houdini, consulte Configurar Houdini; para After Effects, consulte Configurar After Effects. O After Effects não tem um plugin de submissão SuperRenders; o respetivo documento de configuração explica como empacotar e submeter um projeto 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:

1. Fechar o software 3D. Os DCCs bloqueiam os ficheiros do plugin enquanto estão em execução e podem bloquear silenciosamente a atualização.
2. 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.
3. Aguardar até que cada linha mostre "Up to date".
4. 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.

Menu ou barra do plugin em falta (resolução de problemas)

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:

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:

1. Fechar o Maya.
2. Localizar userPrefs.mel: - Windows: C:\Users\<WindowsUser>\Documents\maya\<VersãoMaya>\prefs\userPrefs.mel - macOS: ~/Library/Preferences/Autodesk/maya/<VersãoMaya>/prefs/userPrefs.mel
3. Renomear userPrefs.mel para userPrefs.mel.backup (não apagar — preservar as personalizações de barra por precaução).
4. 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:

1. Fechar o Maya.
2. 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
3. Abrir userSetup.mel e remover o bloco entre /***superrenders_begin***/ e /***superrenders_end***/. Guardar.
4. Reiniciar o Maya. Repetir para cada versão do Maya na estação de trabalho.

3ds Max:

1. Fechar o 3ds Max.
2. 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_).
3. 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 Client App e o painel web continuam a submeter trabalhos sem o plugin.

Matrix de funcionalidades suportadas pelo plugin de submissão

A matrix abaixo resume as capacidades do plugin de submissão por DCC. As colunas 3ds Max, Maya e Cinema 4D provêm das listas de funcionalidades do plugin v1 documentadas no Crisp; para versões mais recentes de DCC, consulte a nota de atualidade que se segue. O add-on para Blender (Blender 4.2 LTS e posteriores) é instalado a partir do separador PLUGIN da Client App SuperRenders e submete a cena aberta; as suas outras capacidades ainda não estão documentadas aqui. O plugin do Houdini também é instalado a partir da Client App SuperRenders e ainda não está abrangido por esta matrix.

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 documento de configuração do DCC 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. Para o 3ds Max, o plugin que se instala a partir da Client App SuperRenders abrange as versões 2023 e posteriores. As versões mais recentes do Maya e do Cinema 4D (Maya 2024/2025/2026, nomenclatura do Cinema 4D pós-R26, atualizações contínuas de Redshift/Octane) têm grande probabilidade de funcionar, dado que o plugin v1 tem sido mantido de forma incremental, mas o SRF não publicou uma confirmação atualizada para cada nova 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.

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 painel web.
• 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 painel web.
• Máquinas de preparação de renderização sem interface gráfica para clicar no diálogo de submissão do plugin. Usar o arrastar e largar do Client App.
• DCCs sem plugin de submissão (por exemplo, o After Effects) e versões do Blender anteriores à 4.2. Submeter via Client App ou painel web.

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 web e submetido via plugin. Deve escolher-se o caminho que melhor se adapta à estação de trabalho.

Referências cruzadas

• Client App — aplicação de ambiente de trabalho para upload, submissão e download
• Guia de início rápido — fluxo de submissão pelo browser sem o plugin
• Submissão web — detalhes de submissão baseada em browser
• Upload e download — comparação de métodos de upload
• Configurar Maya — notas de submissão específicas do Maya
• Configurar 3ds Max — notas de submissão específicas do 3ds Max
• Configurar Cinema 4D — notas de submissão específicas do Cinema 4D
• Configurar Blender — submissão do Blender via Client App / web
• Erros comuns — 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 Client App e o painel web 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: Os plugins que se instalam a partir do separador PLUGIN da Client App SuperRenders cobrem o 3ds Max (2023 e posteriores), o Maya, o Cinema 4D, o Houdini e o Blender (4.2 LTS e posteriores). O After Effects não tem um plugin de submissão; os trabalhos do After Effects 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: Para o 3ds Max, sim: o plugin que se instala a partir da Client App SuperRenders abrange o 3ds Max 2023 e posteriores. A própria render farm suporta o 3ds Max 2013–2027 e o Maya 2014–2027. Para o Maya e o Cinema 4D, a matrix documentada do plugin v1 cobre o Maya 2017–2023 e o Cinema 4D R15–R25; as versões mais recentes 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. Abrir um ticket em caso de problema com um DCC mais recente; tratamos isso como 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 Erros comuns. Se a mensagem não estiver listada, abrir um ticket com o texto de erro e o ID do trabalho.