Verwendung von Plugins

Plugins aktivieren 

Aus diesem Grund ist die Ausführung von Plugins standardmäßig für jedes Projekt deaktiviert, bis Du die Ausführung von Plugins in Projekteinstellungen > Plugins aktivieren bestätigst.

Aktiviere Plugins nur für Projekte, denen Du vertraust. Wenn Du Dein Projekt verschiebst oder umbenennst, musst Du die Plugins erneut aktivieren.

Plugins installieren 

Es gibt zwei Möglichkeiten, Plugins zu installieren: über Deine Projektabhängigkeiten oder als Dateien im plugins Ordner.

Über NPM 

Du kannst Plugins über den Node Package Manager (NPM) installieren. Installiere ein Plugin mit folgendem Befehl:

1npm i --save-dev @wonderlandengine/not-a-real-plugin

Ersetze @wonderlandengine/not-a-real-plugin durch ein beliebiges Plugin, das Du installieren möchtest. Dieser Befehl erstellt einen neuen Eintrag im devDependencies Abschnitt Deiner package.json Datei.

Das Plugin erscheint dann in Projekteinstellungen > Plugins.

Plugins verwalten 

Manchmal möchtest Du Plugins deaktivieren, um visuelle Unordnung zu reduzieren oder die Leistung des Editors zu verbessern.

Die Liste in Projekteinstellungen > Plugins zeigt, welche Plugins installiert und verfügbar zum Aktivieren sind.

Entwicklung 

Das Erstellen von Plugins ist einfach. Du hast drei Methoden zur Verfügung:

Plugin Script 

Ein einziges Skript, das Abhängigkeiten mit Deinem Hauptprojekt package.json teilen kann. Wir empfehlen, alle plugin-bezogenen Abhängigkeiten als devDependencies zu installieren (mit --save-dev).

Du kannst ein neues Plugin erstellen, indem Du den plugins Ordner im Hauptverzeichnis Deines Projekts erstellst, dann rechtsklick > Neues Plugin.

Stelle sicher, dass das @wonderlandengine/editor-api Paket in Deinem Projektverzeichnis installiert ist:

1npm i --save-dev @wonderlandengine/editor-api

Plugin-Verzeichnis 

Ähnlich wie bei Plugin Scripts, erstelle zuerst einen plugins Unterordner, aber erstelle dann einen weiteren Unterordner, den Du nach Deinem Plugin benennst.

In diesem Ordner kannst Du eine neue package.json Datei erstellen (z.B. via npm init).

Stelle sicher, dass das @wonderlandengine/editor-api Paket in diesem Verzeichnis installiert ist:

1npm i --save @wonderlandengine/editor-api

Beachte, --save anstelle von --save-dev, da Du nicht in Dein Wonderland Engine Projekt installierst, sondern in ein separates Plugin-Projekt.

Plugin-Paket 

Wenn Du Dein Plugin teilen und verteilen möchtest, kannst Du npm init in einem separaten Ordner ausführen und den "wonderlandengine" Schlüssel zu Deiner package.json hinzufügen.

Stelle sicher, dass das @wonderlandengine/editor-api Paket in diesem Verzeichnis installiert ist:

1npm i --save @wonderlandengine/editor-api

Um dieses lokale Plugin in Deinem Projekt zu verwenden, npm i --save-dev <path-to-the-directory>, oder veröffentliche es, wenn es bereit ist, und installiere es über das Package, siehe Installieren.