Plugins

Les plugins ajoutent de nouveaux outils à Studio. Voici comment les trouver, les installer et décider desquels vous fier.

Un plugin peut ajouter un panneau, générer des scènes, traiter des ressources ou ajouter un nouveau type de composant à vos objets. Il s'exécute directement dans l'éditeur, sans rien avoir à recompiler.

Un plugin peut aussi apporter du code au projet publié : des objets qui bougent tout seuls, de nouveaux déclencheurs et de nouvelles étapes pour les événements, et sa propre section dans Project settings.

Vous voulez créer le vôtre ? Consultez Écrire un plugin.

Le panneau Plugins

Le panneau comporte deux onglets :

• My uploads — tout ce qui vous appartient, dans une seule liste : les dossiers de plugins sur lesquels vous travaillez, les plugins que vous avez publiés et ceux que vous avez installés. Ici, vous pouvez créer un plugin, ouvrir un dossier, le recharger depuis le disque, le publier ou le dépublier, et le supprimer.
• Creator Hub — les plugins partagés par tout le monde. Faites une recherche, filtrez par tag, et consultez les captures d'écran, l'auteur, la note, le nombre d'installations et de favoris. Vos propres plugins et ceux que vous avez installés apparaissent plus haut dans les résultats.

Quand vous tapez dans le champ de recherche, les deux onglets se fondent en une seule liste, avec vos plugins en premier.

Installer un plugin

L'installation ajoute un plugin à votre éditeur uniquement. Son icône apparaît dans votre barre d'outils.

Pour donner un plugin à toute votre équipe, ajoutez-le au projet. Il apparaît alors pour toutes les personnes qui ouvrent ce projet. Faites-le pour les outils que toute l'équipe utilise, comme un vérificateur de style ou un générateur de scènes partagé.

Plugins avec du code pour le projet publié

Certains plugins s'exécutent aussi dans le projet publié, pour toutes les personnes qui l'ouvrent. Ce code ne s'exécute que dans les projets auxquels le plugin a été ajouté.

Quand vous ajoutez un tel plugin à un projet, le projet garde cette version de son code. Les aperçus, les playtests et les publications l'exécutent, même après que l'auteur en a publié une plus récente. Quand il existe un code plus récent, le plugin affiche update available. Cliquez sur Update in project pour faire passer le projet à ce nouveau code.

Si vous êtes l'auteur du plugin et que vous l'avez ajouté vous-même, le projet exécute chaque version que vous enregistrez. Un projet publié exécute le code avec lequel il a été publié, jusqu'à ce que vous le publiiez à nouveau.

Plugins dépubliés

Quand son auteur clique sur Unpublish, le plugin est supprimé de la bibliothèque. Il disparaît de l'éditeur de chacun et de tous les projets auxquels il avait été ajouté. Ses notes et ses mises en favori sont supprimées aussi.

Confiance et vérification

Un plugin peut modifier votre projet

Un plugin peut lire et modifier votre scène et vos ressources. C'est pourquoi, la première fois que vous ouvrez le plugin de quelqu'un d'autre, Studio vous demande de confirmer. Choisissez Don't ask again for this plugin pour que votre réponse soit retenue pour ce plugin.

Installez les plugins comme n'importe quelle extension de navigateur : uniquement ceux auxquels vous avez des raisons de faire confiance.

Un plugin liste dans son manifeste les permissions dont il a besoin, mais Studio ne le limite pas à celles-ci. Chaque plugin peut accéder à tout le projet, quoi qu'il liste.

Plugins vérifiés

Reviewed signifie que quelqu'un a lu le code de cette version précise du plugin. Ce n'est pas une note sur sa qualité.

Quand l'auteur publie du nouveau code, le plugin repasse en pending jusqu'à une nouvelle relecture. Modifier la description, les tags ou les captures d'écran ne retire pas le badge, car ils ne s'exécutent pas.

La vérification peut aussi supprimer certaines demandes de confirmation. Chacune se règle séparément :

Réglage	Ce qu'il supprime
open	la confirmation à l'ouverture du panneau du plugin
autorun	la demande avant l'exécution de ses parties qui démarrent seules — voir plus bas
warnings	les avertissements indiquant que nous ne relisons pas le code des plugins

Un plugin peut être vérifié sans aucun de ces réglages. Il reçoit alors le badge, et toutes les demandes restent en place. Lire le code et supprimer les demandes sont deux décisions distinctes.

Certaines parties démarrent seules

Un panneau ne s'exécute que lorsque vous l'ouvrez. Un composant personnalisé ou une surcouche de la zone d'affichage s'exécute chaque fois que quelqu'un ouvre le projet. C'est pour cela que autorun est un réglage à part.

Ces parties qui démarrent seules ne s'exécutent que pour un plugin approuvé dans votre navigateur :

• un plugin que vous avez ouvert depuis un dossier de votre propre ordinateur ;
• un plugin que vous avez déjà autorisé : vous avez cliqué sur Allow, ou choisi Don't ask again for this plugin en l'ouvrant ;
• un plugin dont la vérification inclut autorun.

Pour tout autre plugin, elles attendent. Un composant personnalisé affiche une note avec un bouton Allow au lieu de s'exécuter. Une surcouche reste masquée. Quand le plugin a quelque chose à afficher, une petite barre vous demande de l'autoriser. La réponse n'est gardée que dans ce navigateur : un autre navigateur vous posera à nouveau la question.

Le code pour le projet publié s'exécute sans confirmation

Il s'exécute pour toutes les personnes qui ouvrent le projet, comme les scripts du projet lui-même : c'est donc la personne qui ajoute le plugin qui décide pour toute l'équipe. C'est pour cela que la version est figée au moment où le plugin est ajouté : un nouveau code n'arrive dans le projet que lorsque quelqu'un clique sur Update in project.

Le statut de vérification d'un plugin est l'un des suivants : none, pending, verified, rejected ou revoked. Si une vérification est révoquée, votre choix Don't ask again for this plugin pour ce plugin est aussi effacé, car vous aviez accepté un autre code.

Notes et plugins payants

Vous pouvez noter un plugin une seule fois, de une à cinq étoiles.

L'auteur choisit qui peut installer un plugin :

Accès	Qui peut l'installer
Free	tout le monde
Premium	les personnes qui ont une offre payante
Subscribers only	les personnes qui ont un abonnement payant au profil public de l'auteur

Dans un projet, c'est l'abonnement de l'organisation du projet qui compte. Vos propres plugins vous restent toujours accessibles.

Un abonnement ne cache pas le code

Le code d'exécution d'un plugin Subscribers only est envoyé à toutes les personnes qui ouvrent le projet publié, et n'importe qui peut le lire dans son navigateur. L'abonnement décide qui peut ajouter le plugin à un projet, le mettre à jour et publier avec.

Quand l'abonnement prend fin, un projet qui utilise un tel plugin ne peut plus être republié : renouvelez l'abonnement ou retirez le plugin. Un projet déjà publié continue de fonctionner.

Ce qu'il vous faut

• Pour utiliser les plugins de la bibliothèque : n'importe quel navigateur.
• Pour développer des plugins à partir d'un dossier de votre ordinateur : un navigateur basé sur Chromium, comme Chrome ou Edge.

---

Suite : Écrire un plugin — créez et publiez le vôtre.