Aller au contenu principal

Plugins

Les plugins étendent Studio lui-même. Un plugin est un dossier de fichiers qui s'exécute dans l'éditeur sans rien recompiler — il peut ajouter un panneau, générer des scènes, traiter des ressources ou doter les objets d'un nouveau type de composant.

Envie d'en écrire un ? → Écrire un plugin.

Le panneau des plugins

Deux onglets.

My uploads — vos dossiers de développement locaux, vos plugins publiés et ceux que vous avez installés, dans une même liste. De là vous pouvez créer un plugin, ouvrir un dossier existant, le recharger depuis le disque, publier ou dépublier, et supprimer.

Library — le registre partagé : recherche, tags, captures, auteur, note, nombre d'installations et favoris. Vos plugins et ceux que vous avez installés remontent dans les résultats.

La recherche couvre les deux : tapez une requête et les onglets se replient en une seule liste, les vôtres en premier.

Installer

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

L'ajouter à un projet est autre chose : le plugin apparaît alors pour toute personne qui ouvre ce projet, pas seulement pour vous. C'est le bon choix pour un plugin dont toute l'équipe a besoin — un vérificateur de charte, un générateur de scènes que vous utilisez tous.

Retirer un plugin du registre le retire de tous les projets qui l'utilisaient.

Confiance

Un plugin s'exécute avec accès à votre projet

Ouvrir le plugin de quelqu'un d'autre demande une confirmation, une fois, parce qu'il peut lire et modifier votre scène et vos ressources. « Ne plus demander » mémorise votre réponse pour ce plugin.

Traitez la bibliothèque comme n'importe quelle extension tierce : installez ce que vous avez des raisons de croire fiable.

Ce que signifie la vérification

Un plugin vérifié n'est pas « un bon plugin ». Cela veut dire que quelqu'un a lu exactement ce code.

La vérification est liée à une empreinte du contenu du plugin. Publier du nouveau code change l'empreinte, donc un plugin vérifié repasse en attente jusqu'à un nouvel examen. Modifier la description, les tags ou les captures, non — cela ne s'exécute pas.

Une vérification peut lever jusqu'à trois choses distinctes :

LèveSignifie
openaucune boîte de confirmation à l'ouverture de son panneau
autorunses parties auto-démarrantes peuvent s'exécuter sans demander — voir plus bas
warningsles avis « nous ne relisons pas le code des plugins » sont masqués

Un ensemble vide est possible : le badge seul, avec toutes les demandes maintenues. « Nous avons lu le code » et « nous cesserons de vous demander » sont délibérément deux promesses différentes.

Le code qui démarre tout seul est une promesse plus lourde

Un panneau s'exécute quand vous l'ouvrez. Une extension de composant ou une surcouche de viewport s'exécute chaque fois que quelqu'un ouvre le projet. C'est pourquoi autorun se lève séparément, et pourquoi les parties auto-démarrantes d'un plugin non fiable ne se montent pas du tout.

Les statuts sont none, pending, verified, rejected et revoked. Une vérification révoquée efface aussi votre « ne plus demander » local — ce consentement portait sur un autre code.

Notes et premium

Une note par personne, d'une à cinq étoiles. Certains plugins sont marqués comme nécessitant un abonnement ; les vôtres ne sont jamais bloqués.

Ce qu'il vous faut

Le développement demande un navigateur basé sur Chromium, car lire un dossier local passe par la File System Access API. La bibliothèque fonctionne partout — seul le développement d'un plugin depuis un dossier local demande Chromium.


Suite : Écrire un plugin