Plugin de soumission : installation, mise à jour 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 , 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 et le correspondant pour les notes spécifiques au moteur. Pour l'installation du Client App, consultez .

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 , 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.

1. Télécharger le package. Obtenez superrenders.mzp depuis le lien statique SuperRenders que votre tableau de bord de compte fournit.
2. 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.
3. 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. Le wrapper 3ds Max du plugin v1 a été utilisé en production avec 3ds Max 2018 à 2024. 3ds Max 2025 et 2026 n'ont pas été vérifiés indépendamment par SRF sur un chemin d'installation nouvelle. 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 :

1. Télécharger le bundle. Obtenez superrenders_maya_v240.zip (ou la version la plus récente que votre tableau de bord de compte indique) depuis le chemin d'asset statique SuperRenders.
2. 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.
3. Modifier userSetup.mel. Localisez ou créez userSetup.mel dans le dossier scripts parent (un niveau au-dessus de superrenders).
4. 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.
5. Redémarrer Maya. L'étagère et le menu SuperRenders devraient apparaître au prochain lancement.

Couverture des versions Maya. 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 :

1. Installez le .
2. Ouvrez le panneau Plugins dans le Client App.
3. 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.
4. 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 ne dispose pas actuellement d'un plugin de soumission SuperRenders dans le plugin v1. La soumission depuis Blender passe par le ou par le .

Les utilisateurs Blender peuvent toujours prévisualiser et configurer les jobs dans Blender (plage d'images, format de sortie, choix d'engine — Cycles ou Eevee) puis soumettre via le Client App sans perdre le contexte de la scène.

Autres DCC

Le plugin v1 couvre 3ds Max, Maya et Cinema 4D nativement. Pour Houdini, After Effects et les autres DCC pris en charge par la farm, le flux de soumission passe par :

• le tableau de bord web () — fonctionne pour chaque DCC que la farm rend,
• le téléversement par glisser-déposer du Client App () — fonctionne pour chaque DCC, avec les avantages du téléversement reprise et du téléchargement automatique,
• SFTP — recommandé pour les très grands projets.

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 :

1. Fermez votre logiciel 3D. Les DCC verrouillent les fichiers de plugins pendant leur exécution et peuvent silencieusement bloquer la mise à jour.
2. 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.
3. Attendez que chaque ligne affiche « À jour ».
4. 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.

Menu ou étagère de plugin manquant (dépannage)

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 :

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 :

1. Quittez Maya.
2. Localisez userPrefs.mel : - Windows : C:\Users\<VotreUtilisateurWindows>\Documents\maya\<VersionMaya>\prefs\userPrefs.mel - macOS : ~/Library/Preferences/Autodesk/maya/<VersionMaya>/prefs/userPrefs.mel
3. 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).
4. 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 :

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

3ds Max :

1. Fermez 3ds Max.
2. 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_).
3. 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 et le soumettent toujours des jobs sans le plugin.

Matrice de fonctionnalités prises en charge — plugin v1

La matrice ci-dessous résume les capacités du plugin v1 par DCC, tirées des listes de fonctionnalités documentées par Crisp. Les éléments marqués [à vérifier] sont en attente de confirmation de validité contre les versions DCC les plus récentes.

| Capacité | 3ds Max | Maya | Cinema 4D | Blender | |----------|---------|------|-----------|---------| | Versions DCC couvertes (baseline Crisp) | 2018–2024 [à vérifier 2025/2026] | 2017–2023 [à vérifier 2024/2025/2026] | R15–R25 [à vérifier nomenclature post-R26] | (pas de plugin natif) | | Conditionnement de scène à la soumission | Oui | Oui | Oui | (utiliser le téléversement Client App) | | Vérification des assets avant soumission | Oui | Oui | Oui | — | | Relieur d'assets (suivi de textures) | Oui | Oui | Oui (tracker de textures C4D) | — | | Soumission plage d'images / image unique / plage / images sélectionnées | Oui | Oui | Oui | — | | Scènes référencées / XRefs | Oui | Oui (binaire .mb + ASCII .ma) | Oui (XRefs, séquences de fichiers, textures, cartes GI) | — | | Sortie multi-passes / render elements / AOVs | Oui | Oui | Oui (principal + multi-passes + render elements + AOVs + buffers Corona) | — | | 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) | — | | Rendu fixe tuilé / haute résolution | — | — | Oui (caméra tuilée C4D) | — | | Engines pris en charge (baseline Crisp) | V-Ray, Corona [à vérifier Redshift via plugin] | Arnold, V-Ray, Redshift | Advanced Render, Physical, V-Ray, Corona [à vérifier Redshift, Octane] | (choix d'engine au téléversement Client App) |

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 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 .
• Stations de travail de studio verrouillées où les utilisateurs n'ont pas accès en écriture à leur propre dossier de scripts. Utilisez le ou .
• Machines de préparation de rendu headless sans interface graphique pour cliquer dans la boîte de dialogue de soumission du plugin. Utilisez le ou SFTP.
• DCC non couverts par le plugin (Blender, Houdini, After Effects). Soumettez via ou .

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 SFTP et soumis via tableau de bord web.

Références croisées

• — wrapper bureau pour le téléversement, la soumission et le téléchargement
• — flux de soumission navigateur sans le plugin
• — comparaison des méthodes de téléversement
• — notes de soumission spécifiques à Maya
• — notes de soumission spécifiques à 3ds Max
• — notes de soumission spécifiques à Cinema 4D
• — soumission Blender via Client App / web
• — 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 et le 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 : Le plugin v1 couvre 3ds Max, Maya et Cinema 4D. Blender, Houdini et After Effects n'ont pas de plugin natif aujourd'hui ; les jobs de ces DCC 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 : La matrice documentée du plugin v1 couvre Maya 2017–2023, 3ds Max 2018–2024 et Cinema 4D R15–R25. Les versions DCC 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. La matrice signale ces lignes comme [à vérifier]. Ouvrez un ticket si vous rencontrez un problème sur un DCC plus récent — 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 . Si le message n'est pas répertorié, ouvrez un ticket avec le texte de l'erreur et l'ID du job.

---