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 installent le plugin de soumission depuis l'onglet PLUGIN du Client App : le Client App détecte chaque DCC pris en charge sur votre station de travail et installe le plugin correspondant. Les sections ci-dessous couvrent l'installation par DCC, les mises à jour, la correction du menu manquant et la suppression propre du plugin.

Cette page couvre ce que fait le plugin de soumission, les DCC et engines pris en charge, l'installation par DCC depuis le Client App, 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.

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 (le Client App doit être en cours d'exécution ; il peut rester dans la zone de notification ou la barre des menus) pour le téléversement.

Cette page documente les plugins de soumission qui s'installent depuis l'onglet PLUGIN du Client App : 3ds Max (2023 et versions ultérieures), Maya (2022–2027), Cinema 4D (2023–2026), Houdini et Blender (4.2 LTS et versions ultérieures). Chaque section DCC ci-dessous couvre son chemin d'installation et sa couverture de versions.

Avant l'installation

Quelques points à confirmer avant d'installer le plugin depuis le Client App :

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

Pour installer le plugin dans n'importe quel DCC : 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. Si scan-to-update ne détecte pas votre DCC, ouvrez un ticket en indiquant la version de votre DCC et votre OS.

3ds Max

Le plugin pour 3ds Max s'installe depuis l'onglet PLUGIN du Client App.

Installez le Client App et ouvrez l'onglet PLUGIN.
Installez le plugin pour 3ds Max. Le Client App l'installe dans chaque version de 3ds Max qu'il détecte.
Redémarrez 3ds Max si le menu SuperRenders 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. 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 et nous confirmerons si un correctif côté plugin est nécessaire.

Maya

Le plugin pour Maya s'installe depuis l'onglet PLUGIN du Client App dans chaque version Maya détectée, de 2022 à 2027.

Pour installer :

Installez le Client App et ouvrez l'onglet PLUGIN.
Installez le plugin pour Maya. Le Client App l'installe dans chaque version de Maya qu'il détecte.
Redémarrez Maya. L'étagère SuperRenders apparaît.

Couverture des versions Maya. La render farm prend en charge Maya 2014–2027. Le plugin qui s'installe depuis l'onglet PLUGIN du Client App couvre Maya 2022 à 2027.

Cinema 4D

Le plugin Cinema 4D s'installe depuis l'onglet PLUGIN du Client App.

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. Le plugin qui s'installe depuis l'onglet PLUGIN du Client App couvre Cinema 4D 2023 à 2026. La render farm elle-même prend en charge Cinema 4D R14–2027. Pour une scène Cinema 4D 2027, contactez-nous pour confirmation avant l'envoi.

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 à 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. Supprimez le plugin (voir Supprimer le plugin) et réinstallez-le depuis le Client App, puis vérifiez :

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 : C:\Users\<VotreUtilisateurWindows>\Documents\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éinstaller le plugin depuis l'onglet PLUGIN du Client App.

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 (réinstallation propre ou nettoyage d'une station de travail partagée), la procédure dépend du DCC.

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. La ligne des versions reflète le plugin qui s'installe aujourd'hui depuis le Client App. Les autres lignes 3ds Max, Maya et Cinema 4D proviennent des listes de fonctionnalités documentées pour la génération de plugin précédente (2023–2024) et n'ont pas été reconfirmées une par une pour le plugin actuel. 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 (Client App)	2022–2027 (Client App)	2023–2026 (Client App)	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	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 plugin gère à l'intérieur du DCC. La prise en charge côté farm, c'est-à-dire quels engines rendent réellement votre job, est plus large et est suivie dans le doc de configuration DCC correspondant. Le plugin 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. 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 : Le plugin qui s'installe depuis le Client App couvre 3ds Max 2023 et versions ultérieures, Maya 2022–2027 et Cinema 4D 2023–2026. La render farm elle-même prend en charge 3ds Max 2013–2027, Maya 2014–2027 et Cinema 4D R14–2027. Pour une scène Cinema 4D 2027, contactez-nous pour confirmation avant l'envoi. 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 : Non. Les plugins de soumission s'installent depuis l'onglet PLUGIN du Client App. Si vous préférez ne pas installer le Client App, soumettez via le tableau de bord web, qui fonctionne pour chaque DCC que la farm rend.

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.

---