Plugins

Plugins erweitern Studio um neue Werkzeuge. Hier erfahren Sie, wie Sie Plugins finden und installieren und wie Sie entscheiden, welchen Sie vertrauen.

Ein Plugin kann ein Panel hinzufügen, Szenen erzeugen, Ressourcen verarbeiten oder Ihren Objekten eine neue Art von Komponente geben. Es läuft direkt im Editor, und nichts muss neu gebaut werden.

Ein Plugin kann auch Code in das veröffentlichte Projekt bringen: Dinge, die sich von selbst bewegen, neue Trigger und Schritte für Ereignisse und einen eigenen Bereich in den Projekteinstellungen.

Sie möchten ein eigenes Plugin schreiben? Siehe Plugin schreiben.

Das Panel „Plugins“

Das Panel hat zwei Tabs:

• Meine Uploads – alles, was Ihnen gehört, in einer Liste: Plugin-Ordner, an denen Sie arbeiten, Plugins, die Sie veröffentlicht haben, und Plugins, die Sie installiert haben. Hier können Sie ein Plugin erstellen, einen Ordner öffnen, ihn neu von der Festplatte laden, ein Plugin veröffentlichen oder die Veröffentlichung aufheben und es löschen.
• Creator-Hub – Plugins, die andere teilen. Durchsuchen Sie sie, filtern Sie nach Tag und sehen Sie sich Screenshots, Autor, Bewertung sowie die Zahl der Installationen und Favoriten an. Ihre eigenen und installierten Plugins stehen in den Ergebnissen weiter oben.

Sobald Sie etwas ins Suchfeld tippen, werden beide Tabs zu einer Liste zusammengeführt, mit Ihren Plugins zuerst.

Plugin installieren

Eine Installation fügt ein Plugin nur Ihrem Editor hinzu. Sein Symbol erscheint in Ihrer Werkzeugleiste.

Um ein Plugin Ihrem ganzen Team zu geben, fügen Sie es dem Projekt hinzu. Dann erscheint es bei allen, die dieses Projekt öffnen. Das lohnt sich für Werkzeuge, die das ganze Team nutzt, etwa eine Stilprüfung oder einen gemeinsamen Szenengenerator.

Plugins mit Code für das veröffentlichte Projekt

Manche Plugins laufen auch im veröffentlichten Projekt, bei allen, die es öffnen. Dieser Code läuft nur in Projekten, denen das Plugin hinzugefügt wurde.

Wenn Sie ein solches Plugin einem Projekt hinzufügen, behält das Projekt diese Version seines Codes. Vorschau, Playtests und Veröffentlichungen führen sie aus, auch wenn der Autor inzwischen eine neuere veröffentlicht hat. Gibt es neueren Code, zeigt das Plugin Update verfügbar. Drücken Sie Im Projekt aktualisieren, um das Projekt darauf umzustellen.

Sind Sie selbst der Autor des Plugins und haben es hinzugefügt, führt das Projekt jede Version aus, die Sie speichern. Ein veröffentlichtes Projekt führt den Code aus, mit dem es veröffentlicht wurde, bis Sie es erneut veröffentlichen.

Nicht mehr veröffentlichte Plugins

Drückt der Autor Veröffentlichung aufheben, wird das Plugin aus der Bibliothek gelöscht. Es verschwindet aus dem Editor aller Nutzer und aus jedem Projekt, dem es hinzugefügt wurde. Auch seine Bewertungen und Favoriten werden gelöscht.

Vertrauen und Prüfung

Ein Plugin kann Ihr Projekt verändern

Ein Plugin kann Ihre Szene und Ihre Ressourcen lesen und ändern. Deshalb fragt Studio beim ersten Öffnen eines fremden Plugins nach einer Bestätigung. Wählen Sie Für dieses Plugin nicht mehr nachfragen, damit Ihre Antwort für dieses Plugin gespeichert wird.

Installieren Sie Plugins so, wie Sie Browsererweiterungen installieren würden: nur solche, denen Sie aus gutem Grund vertrauen.

Ein Plugin führt die Berechtigungen, die es braucht, in seinem Manifest auf, aber Studio beschränkt es nicht darauf. Jedes Plugin kann auf das ganze Projekt zugreifen, egal was es aufführt.

Geprüfte Plugins

Geprüft bedeutet, dass jemand den Code genau dieser Version des Plugins gelesen hat. Es ist keine Bewertung dafür, wie gut das Plugin ist.

Veröffentlicht der Autor neuen Code, geht das Plugin zurück in den Status pending, bis es erneut geprüft wurde. Änderungen an Beschreibung, Tags oder Screenshots behalten das Abzeichen, weil diese nicht ausgeführt werden.

Eine Prüfung kann auch einige Abfragen abschalten. Jede wird einzeln festgelegt:

Einstellung	Was sie abschaltet
open	die Bestätigung beim Öffnen des Plugin-Panels
autorun	die Abfrage, bevor seine selbststartenden Teile laufen – siehe unten
warnings	die Hinweise, dass wir den Code von Plugins nicht prüfen

Ein Plugin kann auch ohne eine dieser Einstellungen geprüft sein. Es bekommt dann das Abzeichen, und alle Abfragen bleiben. Den Code zu lesen und die Abfragen abzuschalten sind zwei getrennte Entscheidungen.

Manche Teile starten von selbst

Ein Panel läuft erst, wenn Sie es öffnen. Eine eigene Komponente oder ein Overlay im Viewport läuft dagegen jedes Mal, wenn jemand das Projekt öffnet. Deshalb ist autorun eine eigene Einstellung.

Diese selbststartenden Teile laufen nur bei einem Plugin, dem in Ihrem Browser vertraut wird:

• ein Plugin, das Sie aus einem Ordner auf Ihrem eigenen Computer geöffnet haben;
• ein Plugin, das Sie schon einmal erlaubt haben: Sie haben beim Öffnen Erlauben gedrückt oder Für dieses Plugin nicht mehr nachfragen gewählt;
• ein Plugin, dessen Prüfung autorun einschließt.

Bei allen anderen Plugins warten sie. Eine eigene Komponente zeigt statt zu laufen einen Hinweis mit der Schaltfläche Erlauben. Ein Overlay bleibt ausgeblendet. Hat das Plugin etwas anzuzeigen, fragt eine kleine Leiste, ob Sie es erlauben. Die Antwort wird nur in diesem Browser gespeichert, ein anderer Browser fragt also erneut.

Code für das veröffentlichte Projekt läuft ohne Abfrage

Er läuft bei allen, die das Projekt öffnen, wie die eigenen Skripte des Projekts. Wer das Plugin hinzufügt, entscheidet das also für das ganze Team. Deshalb wird die Version beim Hinzufügen festgelegt: Neuer Code kommt erst ins Projekt, wenn jemand Im Projekt aktualisieren drückt.

Der Prüfstatus eines Plugins ist einer von none, pending, verified, rejected oder revoked. Wird eine Prüfung widerrufen, wird auch Ihre Wahl Für dieses Plugin nicht mehr nachfragen für dieses Plugin zurückgesetzt, denn Sie hatten anderem Code zugestimmt.

Bewertungen und kostenpflichtige Plugins

Sie können ein Plugin einmal bewerten, mit einem bis fünf Sternen.

Der Autor legt fest, wer ein Plugin installieren kann:

Zugriff	Wer es installieren kann
Kostenlos	alle
Premium	Personen mit einem kostenpflichtigen Tarif
Nur für Abonnenten	Personen mit einem bezahlten Abonnement für das öffentliche Profil des Autors

In einem Projekt zählt das Abonnement der Organisation, der das Projekt gehört. Ihre eigenen Plugins stehen Ihnen immer zur Verfügung.

Ein Abonnement verbirgt keinen Code

Der Laufzeitcode eines Plugins mit dem Zugriff Nur für Abonnenten geht an alle, die das veröffentlichte Projekt öffnen, und jeder kann ihn in seinem Browser lesen. Das Abonnement entscheidet, wer das Plugin einem Projekt hinzufügen, es aktualisieren und damit veröffentlichen kann.

Endet das Abonnement, kann ein Projekt mit einem solchen Plugin nicht erneut veröffentlicht werden: Verlängern Sie das Abonnement oder entfernen Sie das Plugin. Ein bereits veröffentlichtes Projekt funktioniert weiter.

Was Sie brauchen

• Um Plugins aus der Bibliothek zu nutzen: einen beliebigen Browser.
• Um Plugins aus einem Ordner auf Ihrem Computer zu bauen: einen Browser auf Chromium-Basis, etwa Chrome oder Edge.

---

Weiter: Plugin schreiben – bauen und veröffentlichen Sie Ihr eigenes.