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 instala o plugin de submissão a partir do separador PLUGIN da Client App SuperRenders: a App deteta cada DCC suportado na estação de trabalho e instala o plugin correspondente. As secções seguintes cobrem a instalação por DCC, as atualizações, a correção do menu em falta e como remover o plugin de forma limpa.

Esta página abrange o que o plugin de submissão faz, os DCCs e motores suportados, a instalação por DCC a partir da Client App SuperRenders, o procedimento de atualização, a correção de menu ou barra em falta, como remover o plugin de forma limpa e uma matriz de funcionalidades.

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 (o Client App tem de estar em execução; pode ficar na área de notificação ou na barra de menus) para upload.

Esta página documenta os plugins de submissão que se instalam a partir do separador PLUGIN da Client App SuperRenders: 3ds Max (2023 e posteriores), Maya (2022–2027), Cinema 4D (2023–2026), Houdini e Blender (4.2 LTS e posteriores). Cada secção de DCC abaixo descreve o caminho de instalação e a cobertura de versões.

Antes de instalar

Alguns aspetos a confirmar antes de instalar o plugin a partir da App:

• 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

Para instalar o plugin em qualquer DCC: 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. Se a atualização por scan não detetar o DCC, abrir um ticket indicando a versão do DCC e o sistema operativo.

3ds Max

O plugin para 3ds Max instala-se a partir do separador PLUGIN da Client App SuperRenders.

1. Instalar a Client App SuperRenders e abrir o separador PLUGIN.
2. Instalar o plugin para 3ds Max. A App instala-o em cada versão do 3ds Max que detetar.
3. Reiniciar o 3ds Max se o menu SuperRenders 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–2027. O plugin que se instala a partir do separador PLUGIN da Client App SuperRenders abrange o 3ds Max 2023 e posteriores.

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

O plugin para Maya instala-se a partir do separador PLUGIN da Client App SuperRenders em cada versão do Maya detetada, de 2022 a 2027.

Para instalar:

1. Instalar a Client App SuperRenders e abrir o separador PLUGIN.
2. Instalar o plugin para Maya. A App instala-o em cada versão do Maya que detetar.
3. Reiniciar o Maya. A barra SuperRenders aparece.

Compatibilidade com versões do Maya: a render farm suporta o Maya 2014–2027. O plugin que se instala a partir do separador PLUGIN da Client App SuperRenders abrange o Maya 2022 a 2027.

Cinema 4D

O plugin para Cinema 4D instala-se a partir do separador PLUGIN da Client App SuperRenders.

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. Alargamos o plugin a novas versões do Cinema 4D de forma contínua à medida que a Maxon as lança.

Cobertura de versões do Cinema 4D: o plugin que se instala a partir do separador PLUGIN da Client App SuperRenders abrange o Cinema 4D 2023 a 2026. A própria render farm suporta o Cinema 4D R14–2027; para uma cena do Cinema 4D 2027, contacte-nos para confirmar antes de fazer upload.

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

A Client App SuperRenders mantém o plugin atualizado automaticamente. Quando a SuperRenders lança uma atualização (uma nova versão de DCC, uma correção ao revinculador de recursos), a 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).

Se a App não conseguir atualizar o plugin de um DCC, remover o plugin (ver Remover o plugin) e executar novamente Scan to update.

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. Remover o plugin (ver Remover o plugin), instalá-lo novamente a partir da App e depois verificar:

• 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, seguida de nova instalação do plugin a partir do separador PLUGIN da Client App SuperRenders.

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 (reinstalação limpa ou limpeza de estação de trabalho partilhada), 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. A linha de versões reflete o plugin que se instala hoje a partir da Client App SuperRenders. As restantes linhas de 3ds Max, Maya e Cinema 4D provêm das listas de funcionalidades documentadas para a geração anterior do plugin (2023–2024) e não foram reconfirmadas uma a uma para o plugin atual. 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 plugin 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 empacota a cena; o motor de renderização (Arnold, V-Ray, Redshift, etc.) é executado do lado da render farm.

Nota de atualidade

A Client App SuperRenders instala o plugin para o 3ds Max 2023 e posteriores, o Maya 2022–2027, o Cinema 4D 2023–2026 e o Blender 4.2 LTS e posteriores. O intervalo de suporte da própria render farm é mais amplo. 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. 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: O plugin que se instala a partir da Client App SuperRenders abrange o 3ds Max 2023 e posteriores, o Maya 2022–2027 e o Cinema 4D 2023–2026. A própria render farm suporta o 3ds Max 2013–2027, o Maya 2014–2027 e o Cinema 4D R14–2027; para uma cena do Cinema 4D 2027, contacte-nos para confirmar antes de fazer upload. Abra um ticket se tiver um problema num DCC mais recente; tratamos isso como P1.

Q: É possível instalar o plugin sem instalar o Client App? A: Não. Os plugins de submissão instalam-se a partir do separador PLUGIN da Client App SuperRenders. Se se preferir não instalar a App, pode submeter-se através do painel web, que funciona para todos os DCCs que a render farm renderiza.

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.