Plugin de soumission : installation et dépannage par DCC

Le plugin de soumission SuperRenders est une petite extension dans votre logiciel 3D qui ajoute un menu ou un bouton d'étagère « SuperRenders », vous permettant de soumettre un job de rendu à notre farm sans quitter votre DCC. Le plugin conditionne votre scène, effectue une vérification préalable des assets et des versions, et transmet le job à la file de la farm en une seule étape.

La plupart des utilisateurs n'ont pas besoin d'installer le plugin manuellement. Lorsque vous installez le Client App SuperRenders, le plugin correspondant est détecté automatiquement et installé dans chaque DCC pris en charge sur votre station de travail. Les pages ci-dessous couvrent les cas où l'installation automatique ne fonctionne pas — nouvelle version de DCC, emplacement d'installation personnalisé, compte utilisateur restreint — ou lorsque vous préférez une installation manuelle pour la reproductibilité.

Cette page couvre ce que fait le plugin de soumission, les DCC et engines pris en charge, les étapes d'installation manuelle par DCC, la procédure de mise à jour, le correctif de menu ou d'étagère manquant, comment supprimer le plugin proprement, et une matrice de fonctionnalités v1.

Pour le workflow de soumission de jobs une fois le plugin installé, consultez le Guide de démarrage rapide et le doc de configuration DCC correspondant pour les notes spécifiques au moteur. Pour l'installation du Client App, consultez Client App.

Vue d'ensemble du plugin

Le plugin de soumission est le compagnon côté DCC du Client App. Le Client App gère le téléversement, le suivi des jobs et le téléchargement sur le bureau ; le plugin gère le passage « scène → job » dans le DCC.

Ce que fait le plugin dans votre DCC :

Ajoute un menu ou un bouton d'étagère SuperRenders afin que vous puissiez lancer la boîte de dialogue de soumission sans quitter le DCC.
Lit la scène active — plage d'images, chemin de sortie, paramètres de rendu, assets référencés — et pré-remplit le formulaire de job.
Effectue une vérification des assets avant soumission pour signaler les textures manquantes, les références manquantes et les chemins de fichiers brisés avant le démarrage du téléversement.
Versionne le fichier de scène avec ses assets afin que la farm rende exactement l'état de la scène que vous avez soumis, et non une modification ultérieure.
Transmet le job conditionné au Client App (ou directement à la file de la farm si le service en arrière-plan du Client App est en cours d'exécution) pour le téléversement.

Cette page documente le plugin v1, le plugin de production actuel fourni avec le Client App et la seule génération de plugin orientée client aujourd'hui. Les DCC et engines pris en charge par le plugin v1 sont répertoriés dans la matrice de fonctionnalités ci-dessous.

Avant l'installation

Quelques points à confirmer avant d'exécuter l'une des procédures d'installation manuelle ci-dessous :

Utilisez le même compte utilisateur que celui qui exécute le DCC. Le plugin s'installe dans le dossier de scripts DCC de l'utilisateur, pas dans le répertoire du programme DCC. Si vous installez en étant connecté sous un compte différent (par exemple un compte administrateur utilisé uniquement pour les installations de logiciels), le plugin n'apparaîtra pas lorsque votre utilisateur normal ouvrira le DCC. Connectez-vous en tant qu'utilisateur qui ouvre réellement le DCC et relancez l'installateur.
Exécutez le DCC au moins une fois avant l'installation. La plupart des DCC créent leur dossier de scripts spécifique à l'utilisateur au premier lancement. Installer avant que ce dossier n'existe échoue silencieusement sur certaines versions de Maya et 3ds Max.
Fermez le DCC pendant l'installation. Le script de démarrage du plugin est lu lors du chargement du DCC. Si le DCC est en cours d'exécution pendant l'installation, redémarrez-le après l'installation pour que le script soit pris en compte.
Ayez un compte SuperRenders prêt. Le plugin demande une connexion lors du premier lancement.

Si votre studio utilise une image de station de travail verrouillée où les utilisateurs ne peuvent pas écrire dans leur propre dossier Documents, contactez le support — le plugin nécessite un accès en écriture au répertoire de scripts DCC standard.

Installation par DCC

La première chose à essayer dans chaque DCC est le chemin d'installation automatique : installez le Client App, ouvrez le panneau Plugins et cliquez sur Scan to update. Le Client App détecte vos DCC installés et pousse le bon plugin dans chacun. Les étapes manuelles ci-dessous servent de repli lorsque scan-to-update ne détecte pas votre DCC, lorsque vous souhaitez une installation reproductible sur une nouvelle machine, ou lorsque vous souhaitez installer le plugin sans que le service Client App ne soit en cours d'exécution.

3ds Max (installation automatique + repli manuel)

Le plugin v1 pour 3ds Max est fourni sous la forme d'un seul package MAXScript .mzp. L'installation manuelle est un processus en deux étapes.

Télécharger le package. Demandez au support le lien de téléchargement statique de superrenders.mzp.
Exécuter le script dans 3ds Max. Ouvrez 3ds Max, puis Scripting → Exécuter le script…, localisez superrenders.mzp et confirmez. Le script enregistre le plugin et ajoute un menu SuperRenders à la barre de menus de niveau supérieur.
Redémarrer 3ds Max si le menu n'apparaît pas. Certaines versions de 3ds Max ne relisent les définitions de menus de niveau supérieur qu'au lancement.

Couverture des versions 3ds Max. La render farm prend en charge 3ds Max 2013–2027. Le plugin qui s'installe depuis l'onglet PLUGIN du Client App couvre 3ds Max 2023 et versions ultérieures. Le package manuel .mzp ci-dessus a été utilisé en production avec 3ds Max 2018 à 2024. Si le menu SuperRenders apparaît mais que la boîte de dialogue de soumission s'ouvre vide ou génère une erreur Python, ouvrez un ticket — nous confirmerons si un correctif côté plugin est nécessaire.

Maya (installation automatique + repli manuel)

Le plugin v1 pour Maya est fourni sous la forme d'un bundle de scripts compressé (superrenders_maya_v2xx.zip). Le Client App installe automatiquement ce bundle dans le dossier de scripts Maya pour chaque version Maya détectée. L'installation manuelle est nécessaire lorsque le Client App ne peut pas détecter une version Maya.

Installation manuelle, cinq étapes :

Télécharger le bundle. Demandez au support le lien de téléchargement statique de superrenders_maya_v240.zip (ou de la version la plus récente).
Extraire dans le dossier de scripts Maya. Décompressez dans le répertoire de scripts par version de Maya : C:\Users\<VotreUtilisateurWindows>\Documents\maya\<VersionMaya>\scripts\superrenders Par exemple, sur Maya 2023 avec l'utilisateur Windows admin, le chemin est C:\Users\admin\Documents\maya\2023\scripts\superrenders. Sur macOS, le chemin équivalent est ~/Library/Preferences/Autodesk/maya/<VersionMaya>/scripts/superrenders.
Modifier userSetup.mel. Localisez ou créez userSetup.mel dans le dossier scripts parent (un niveau au-dessus de superrenders).
Ajoutez le bloc d'initialisation SuperRenders à userSetup.mel : /***superrenders_begin***/ python("import sys"); python("sys.path.append(u'__srfscriptPath__')"); python("import superrenders_runner"); python("superrenders_runner.init()"); /***superrenders_end***/ Remplacez __srfscriptPath__ par le chemin complet avec barres obliques vers votre dossier superrenders, par exemple : C:/Users/admin/Documents/maya/2023/scripts/superrenders Les barres obliques sont requises. Les barres obliques inverses cassent l'appel sys.path.append Python.
Redémarrer Maya. L'étagère et le menu SuperRenders devraient apparaître au prochain lancement.

Couverture des versions Maya. La render farm prend en charge Maya 2014–2027 ; la plage ci-dessous correspond à la couverture hôte propre au plugin v1, vérifiée indépendamment, qui est plus restreinte. Le plugin v1 a été utilisé en production sur Maya 2017 à 2023. Maya 2024, 2025 et 2026 sont couramment utilisés aujourd'hui mais n'ont pas été vérifiés indépendamment par SRF pour l'installation du plugin v1.

Cinema 4D (installation automatique du Client App uniquement)

Le plugin Cinema 4D est installé par le flux scan-to-update du Client App. Il n'y a pas d'installateur manuel séparé de type .mzp publié pour le plugin v1 Cinema 4D aujourd'hui.

Pour installer :

Installez le Client App SuperRenders.
Ouvrez le panneau Plugins dans le Client App.
Cliquez sur Scan to update. Le Client App détecte chaque version Cinema 4D installée sur la station de travail et installe le plugin correspondant dans le répertoire de plugins C4D.
Redémarrez Cinema 4D. L'entrée de soumission SuperRenders apparaît dans le menu Extensions C4D.

Si scan-to-update signale que votre version Cinema 4D est « non prise en charge », ouvrez un ticket avec votre version C4D et votre OS.

Couverture des versions Cinema 4D. La matrice de fonctionnalités documentée par Crisp liste Cinema 4D R15 à R25 avec les engines Advanced Render, Physical, V-Ray et Corona. Pour Cinema 4D 2023 et versions ultérieures (le renommage post-R26), vérifiez la prise en charge via le panneau Plugins du Client App ou contactez le support.

Blender

Blender 4.2 LTS et versions ultérieures dispose d'un add-on de soumission SuperRenders. Il s'installe depuis l'onglet PLUGIN du Client App. Après avoir redémarré Blender, un menu SuperRenders apparaît ; utilisez-le pour soumettre la scène ouverte.

Pour les versions de Blender antérieures à 4.2, ou si vous préférez ne pas installer l'add-on, soumettez via le flux de téléversement par glisser-déposer du Client App ou le tableau de bord web. Les métadonnées du fichier .blend sont analysées au téléversement ; le Client App pré-remplit automatiquement la plupart des champs de soumission.

Autres DCC

Houdini dispose également d'un plugin de soumission, qui s'installe depuis l'onglet PLUGIN du Client App. Pour After Effects et les autres DCC pris en charge par la farm, le flux de soumission passe par :

le tableau de bord web (Guide de démarrage rapide) — fonctionne pour chaque DCC que la farm rend,
le téléversement par glisser-déposer du Client App (Client App) — fonctionne pour chaque DCC, avec les avantages du téléversement reprise et du téléchargement automatique.

Procédure de mise à jour

Le Client App maintient le plugin v1 à jour automatiquement. Lorsque SuperRenders livre une mise à jour — une nouvelle version de DCC, un correctif du relieur d'assets — le Client App récupère le nouveau plugin et propose de l'installer au prochain lancement.

Pour exécuter une mise à jour manuellement :

Fermez votre logiciel 3D. Les DCC verrouillent les fichiers de plugins pendant leur exécution et peuvent silencieusement bloquer la mise à jour.
Ouvrez le panneau Plugins du Client App et cliquez sur Scan to update. Le Client App compare les versions de plugins installées à la dernière version et installe les plus récentes là où elles sont disponibles.
Attendez que chaque ligne affiche « À jour ».
Redémarrez le DCC. La nouvelle version du plugin est lue au prochain lancement.

Si « Scan to update » échoue pour un DCC spécifique, les causes habituelles sont : le DCC est toujours en cours d'exécution et verrouille un fichier ; le compte utilisateur exécutant le Client App manque d'autorisation d'écriture dans le dossier de scripts du DCC ; ou une installation précédente échouée a laissé un dossier de plugin partiel.

Si le plugin s'installe sans erreurs mais que le menu ou l'icône d'étagère SuperRenders n'apparaît jamais, la cause sous-jacente est presque toujours l'une de ces deux choses : le plugin s'est installé dans le mauvais répertoire, ou un outil tiers a corrompu les préférences de démarrage du DCC.

Cause 1 — Plugin installé dans le mauvais répertoire de scripts.

Le plugin doit se trouver dans le dossier de scripts spécifique à l'utilisateur pour la version DCC en cours d'exécution.

Confirmez dans Maya en ouvrant l'Éditeur de scripts et en exécutant :

text

import superrenders_runner
superrenders_runner.init()

Si la fenêtre de soumission SuperRenders s'ouvre, le plugin est correctement installé et le problème d'étagère est un problème d'interface (Cause 2). Si vous obtenez ImportError: No module named superrenders_runner, le plugin n'est pas dans le chemin Python de Maya. Réexécutez les étapes d'installation manuelle dans Installation Maya, en faisant attention à :

La version Maya dans le chemin correspond à la Maya que vous lancez.
L'utilisateur Windows dans le chemin correspond à l'utilisateur qui lance Maya.
Le chemin dans userSetup.mel utilise des barres obliques, pas des barres obliques inverses.

Cause 2 — Un outil tiers a corrompu les préférences d'étagère du DCC.

Si l'Éditeur de scripts confirme que superrenders_runner s'importe mais que l'icône d'étagère est toujours manquante, les préférences d'étagère sauvegardées du DCC sont généralement corrompues — typiquement parce qu'un autre plugin les a réécrites.

Dans Maya :

Quittez Maya.
Localisez userPrefs.mel : - Windows : C:\Users\<VotreUtilisateurWindows>\Documents\maya\<VersionMaya>\prefs\userPrefs.mel - macOS : ~/Library/Preferences/Autodesk/maya/<VersionMaya>/prefs/userPrefs.mel
Renommez userPrefs.mel en userPrefs.mel.backup (ne pas supprimer — préservez les dispositions d'étagère personnalisées au cas où vous souhaiteriez les fusionner en retour).
Redémarrez Maya. Maya régénère un userPrefs.mel frais et l'étagère SuperRenders devrait apparaître.

Dans 3ds Max, le correctif équivalent est Personnaliser → Revenir à la disposition d'interface de démarrage, puis réexécuter l'installation superrenders.mzp.

Si aucune cause ne correspond, ouvrez un ticket de support avec : nom et version du DCC, OS et compte utilisateur, le texte d'erreur complet de l'Éditeur de scripts / MAXScript Listener, et le contenu de userSetup.mel (Maya) ou du journal d'installation MAXScript (3ds Max).

Supprimer le plugin

Pour désinstaller le plugin v1 — réinstallation propre, nettoyage de station de travail partagée, ou préparation à la migration :

Maya :

Quittez Maya.
Supprimez le dossier superrenders sous le répertoire de scripts de Maya.
Ouvrez userSetup.mel et supprimez le bloc entre /***superrenders_begin***/ et /***superrenders_end***/. Sauvegardez.
Redémarrez Maya. Répétez pour chaque version Maya sur la station de travail.

3ds Max :

Fermez 3ds Max.
Réinitialisez l'interface aux paramètres par défaut depuis Personnaliser → Revenir à la disposition d'interface de démarrage au prochain lancement, ou supprimez les fichiers de macro SuperRenders depuis C:\Users\<VotreUtilisateurWindows>\AppData\Local\Autodesk\3dsMax\<Version>\ENU\usermacros\ (fichiers commençant par SuperRenders_).
Redémarrez 3ds Max.

Cinema 4D : fermez Cinema 4D, supprimez le dossier de plugin SuperRenders sous le répertoire de plugins C4D pour cette version C4D, et redémarrez Cinema 4D.

Après la suppression, le Client App et le tableau de bord web soumettent toujours des jobs sans le plugin.

Matrice de fonctionnalités prises en charge du plugin de soumission

La matrice ci-dessous résume les capacités du plugin de soumission par DCC. Les colonnes 3ds Max, Maya et Cinema 4D proviennent des listes de fonctionnalités du plugin v1 documentées par Crisp. L'add-on Blender (Blender 4.2 LTS et versions ultérieures) s'installe depuis l'onglet PLUGIN du Client App et soumet la scène ouverte ; ses autres capacités ne sont pas encore documentées ici. Le plugin Houdini s'installe lui aussi depuis le Client App et n'est pas encore couvert par cette matrice.

Capacité	3ds Max	Maya	Cinema 4D	Blender
Versions DCC couvertes par le plugin de soumission (plage plus restreinte que celle prise en charge par la render farm)	2023 et versions ultérieures (plugin du Client App) ; package manuel utilisé en production sur 2018–2024	2017–2023 (baseline Crisp)	R15–R25 (baseline Crisp)	4.2 LTS et versions ultérieures (Client App)
Conditionnement de scène à la soumission	Oui	Oui	Oui	Pas encore documenté
Vérification des assets avant soumission	Oui	Oui	Oui	Pas encore documenté
Relieur d'assets (suivi de textures)	Oui	Oui	Oui (tracker de textures C4D)	Pas encore documenté
Soumission plage d'images / image unique / plage / images sélectionnées	Oui	Oui	Oui	Pas encore documenté
Scènes référencées / XRefs	Oui	Oui (binaire .mb + ASCII .ma)	Oui (XRefs, séquences de fichiers, textures, cartes GI)	Pas encore documenté
Sortie multi-passes / render elements / AOVs	Oui	Oui	Oui (principal + multi-passes + render elements + AOVs + buffers Corona)	Pas encore documenté
Versioning de scène côté farm	Oui	Oui (intégration automatisée complète)	Oui (versioning de scène côté serveur + vérification)	Pas encore documenté
Rendu fixe tuilé / haute résolution	—	—	Oui (caméra tuilée C4D)	Pas encore documenté
Engines pris en charge (baseline Crisp)	V-Ray, Corona (le support des moteurs est côté farm ; le plugin conditionne la scène quoi qu'il en soit)	Arnold, V-Ray, Redshift (le support des moteurs est côté farm ; le plugin conditionne la scène quoi qu'il en soit)	Advanced Render, Physical, V-Ray, Corona (le support des moteurs est côté farm ; le plugin conditionne la scène quoi qu'il en soit)	Le support des moteurs est côté farm ; voir Configurer Blender

La matrice suit ce que le wrapper plugin v1 gère à l'intérieur du DCC. La prise en charge côté farm — quels engines rendent réellement votre job — est plus large et est suivie dans le doc de configuration DCC correspondant. Le plugin v1 conditionne la scène ; le moteur de rendu (Arnold, V-Ray, Redshift, etc.) s'exécute côté farm.

Quand le plugin n'est pas le bon chemin

Certains workflows sont mieux servis sans le plugin même lorsqu'il est installé et fonctionnel :

Soumissions ponctuelles où vous ne souhaitez rien installer dans le DCC. Utilisez le tableau de bord web.
Stations de travail de studio verrouillées où les utilisateurs n'ont pas accès en écriture à leur propre dossier de scripts. Utilisez le tableau de bord web.
Machines de préparation de rendu headless sans interface graphique pour cliquer dans la boîte de dialogue de soumission du plugin. Utilisez le glisser-déposer du Client App.
DCC sans plugin de soumission (par exemple After Effects), et versions de Blender antérieures à 4.2. Soumettez via Client App ou tableau de bord web.

Le Client App, le tableau de bord web et le plugin de soumission ne sont pas mutuellement exclusifs — un seul projet peut être téléversé via Client App et soumis via plugin, ou téléversé via le web et soumis via le plugin. Choisissez le chemin qui convient à la station de travail.

Références croisées

Client App — wrapper bureau pour le téléversement, la soumission et le téléchargement
Guide de démarrage rapide — flux de soumission navigateur sans le plugin
Téléversement et téléchargement — comparaison des méthodes de téléversement
Configurer Maya — notes de soumission spécifiques à Maya
Configurer 3ds Max — notes de soumission spécifiques à 3ds Max
Configurer Cinema 4D — notes de soumission spécifiques à Cinema 4D
Configurer Blender — soumission Blender via Client App / web
Erreurs courantes — dépannage inter-DCC

FAQ

Q : Dois-je installer le plugin de soumission, ou puis-je soumettre des jobs sans lui ? A : Le plugin est optionnel. Le Client App et le tableau de bord web soumettent tous deux des jobs sans plugin DCC. Le plugin est une commodité pour les utilisateurs qui préfèrent soumettre depuis l'intérieur de leur logiciel 3D en un clic.

Q : Quelles applications 3D disposent d'un plugin de soumission SuperRenders ? A : Les plugins qui s'installent depuis l'onglet PLUGIN du Client App couvrent 3ds Max (2023 et versions ultérieures), Maya, Cinema 4D, Houdini et Blender (4.2 LTS et versions ultérieures). After Effects n'a pas de plugin de soumission ; les jobs After Effects sont soumis via le Client App ou le tableau de bord web.

Q : Pourquoi le menu SuperRenders n'apparaît-il pas après l'installation ? A : Causes les plus fréquentes : le plugin s'est installé dans le mauvais dossier de scripts (souvent parce que vous avez installé sous un utilisateur différent de celui qui exécute le DCC), ou les préférences d'étagère sauvegardées du DCC sont corrompues. Consultez la section Menu ou étagère de plugin manquant pour le flux de diagnostic complet.

Q : Comment mettre à jour le plugin ? A : Ouvrez le panneau Plugins du Client App, cliquez sur « Scan to update » et redémarrez votre DCC. Les mises à jour manuelles fonctionnent également — réexécutez les étapes d'installation par DCC avec le package plugin plus récent ; la nouvelle version écrase l'ancienne en place.

Q : Le plugin fonctionne-t-il sur Maya 2024+, 3ds Max 2025+ ou le dernier Cinema 4D ? A : Pour 3ds Max, oui : le plugin qui s'installe depuis le Client App couvre 3ds Max 2023 et versions ultérieures. La render farm elle-même prend en charge 3ds Max 2013–2027 et Maya 2014–2027. Pour Maya et Cinema 4D, la matrice documentée du plugin v1 couvre Maya 2017–2023 et Cinema 4D R15–R25 ; les versions plus récentes fonctionneront très probablement car le plugin v1 a été maintenu de manière incrémentielle, mais SRF n'a pas publié de confirmation par version pour les releases les plus récentes. Ouvrez un ticket si vous rencontrez un problème sur un DCC plus récent ; nous le traitons en P1.

Q : Puis-je installer le plugin sans installer le Client App ? A : Oui pour 3ds Max et Maya — les étapes d'installation manuelle sur cette page utilisent le package plugin autonome. Le chemin d'installation manuelle de Cinema 4D sans Client App n'est pas publié actuellement ; nous recommandons d'installer le Client App pour l'installation du plugin C4D.

Q : Le plugin s'ouvre mais la soumission échoue. Où chercher ? A : Les erreurs au moment de la soumission signifient généralement que la scène s'est conditionnée correctement mais que la farm a rejeté quelque chose — un asset manquant, une version de moteur/engine que la farm ne prend pas en charge, ou un problème de facturation de compte. Vérifiez le texte de l'erreur dans Erreurs courantes. Si le message n'est pas répertorié, ouvrez un ticket avec le texte de l'erreur et l'ID du job.

---