# Plugins erstellen

> Ein Plugin bauen, es prüfen lassen und am Prompt verdienen, den es beisteuert.

Source: https://reverie.im/de/docs/plugins/creating-plugins
Language: de

Schreiben darf jede angemeldete Person. Öffne einen Chat, geh in den Reiter **Plugins** der Seitenleiste und drücke **Plugin erstellen**. Der Editor führt durch drei Schritte: **Typ**, **Grundlagen** und **Konfiguration**.

## Wähle einen Typ \[#pick-a-type]

Von den vier Plugin-Typen kannst du drei erstellen. Der vierte stellt die Sampling-Einstellungen des Modells ein und gehört Reverie.

| Typ                     | Was du schreibst                                                                                                                              | Grenzen                                                                                                                                                                        |
| ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Prompt-Plugin**       | Eine Prompt-Vorlage in Handlebars, die an den System-Prompt der Figur angehängt wird                                                          | Vorlage bis zu 100.000 Zeichen                                                                                                                                                 |
| **Tool-Plugin**         | Eine Prompt-Vorlage plus eine Tool-Definition: Name, Beschreibung, Eingabeparameter, Ausgabestruktur und optional eine HTML/CSS-Kartenvorlage | Der Tool-Name beginnt mit einem Buchstaben und nutzt Buchstaben, Ziffern und Unterstriche, bis 64 Zeichen; die Beschreibung bis 2.000; Kartenvorlage und Styles je bis 100.000 |
| **Interaktives Plugin** | Eine Kennung und mindestens eines davon: ein Auslöseknopf mit Formular, eine KI-erzeugte Fläche oder ein Tool, das die KI aufrufen kann       | Kennung bis 80 Zeichen, Buchstaben/Ziffern/Bindestrich/Unterstrich, beginnend mit Buchstabe oder Ziffer                                                                        |

Der Typ lässt sich später nicht ändern — **Plugin-Typ kann beim Bearbeiten nicht geändert werden**.

> Ein Tool-Plugin stellt keine Netzwerkanfragen. Wenn das Modell dein Tool
> aufruft, erfindet das Modell die Argumente, und deine Ausgabestruktur und
> deine Kartenvorlage ordnen diese erfundenen Werte zur Anzeige. Schreibe
> Tools, die Informationen darstellen — Statusanzeigen, Messwerte, Inventare,
> Würfelwürfe — und keine, die vorgeben, etwas nachzuschlagen.

## Fülle die Grundlagen aus \[#fill-in-the-basics]

**Plugin-Name** ist Pflicht, bis zu 100 Zeichen. **Beschreibung (Optional)** fasst bis zu 1.000.

Hier sitzen zwei Schalter, und sie sind unabhängig voneinander — du kannst einen, beide oder keinen setzen:

| Schalter                               | Wirkung                                                                                          |
| -------------------------------------- | ------------------------------------------------------------------------------------------------ |
| **Plugin öffentlich machen**           | Schickt diese Version zur Prüfung. Nach der Freigabe steht sie im Reiter **Community** für alle. |
| **Mit aktuellem Charakter verknüpfen** | Begrenzt das Plugin auf Chats mit der Figur, in deren Chat du gerade bist.                       |

Eine KI-generierte Seite besteht aus zwei Teilen. Ihre **Inhaltsanfrage** ist eine Vorlage wie eine Prompt-Vorlage: Sie kann dieselben Platzhalter wie `{{char}}`, `{{user}}` und `{{date}}` sowie alle Einstellungen nutzen, die du Installierenden anbietest, und sie legt fest, was jede Seite enthält und in wessen Stimme. Ihre **App-Hülle** ist die Seite selbst — HTML, CSS und JavaScript plus ein Inhaltsschema —, einmal geschrieben und für jede Seite verwendet: Die KI schreibt nur den Inhalt, und die Hülle stellt ihn dar und übernimmt Tippen, Karten und Zustand auf dem Gerät der lesenden Person. Schreib die Hülle selbst oder drück auf **Mit KI schreiben**; die Vorschau führt sie schon während des Schreibens mit dem Beispielinhalt aus. Sobald es eine Hülle gibt, nimmt **Mit KI überarbeiten** auf, was du ändern möchtest, und arbeitet deine aktuelle Hülle um, statt von vorn anzufangen, und **Rückgängig** stellt die Version von vor dem letzten KI-Durchlauf wieder her. Ein Plugin mit einer KI-generierten Seite lässt sich ohne Hülle nicht speichern; eines, das veröffentlicht wurde, bevor es Hüllen gab, funktioniert unverändert weiter und braucht beim nächsten Bearbeiten eine Hülle.

Die Hülle läuft in einer Sandbox: Sie kann weder aufs Netzwerk zugreifen noch externe Dateien oder Skripte laden oder den Rest der App berühren. Bilder stammen aus dem Chat selbst — das Porträt oder Banner des Charakters, der Avatar der lesenden Person, das Bild des Szenarios oder Moments — auf etwas anderes kann eine Seite nicht zeigen. Über den Chat kann eine Seite eine Zeile als lesende Person senden, eine Szenenanweisung setzen, die der Charakter ausspielt, den Chat ein zufälliges Ergebnis ziehen lassen, eine andere Seite öffnen, sich an Ort und Stelle neu schreiben oder sich schließen, und sie kann festhalten, was die lesende Person auf ihr getan hat — eine gezogene Karte, eine hinterlassene Notiz —, sodass es beim erneuten Öffnen der Seite noch da ist. Die aktuelle Zeit sowie der Weltkanon des Charakters werden automatisch mitgegeben.

## Fang bei einem Beispiel an \[#start-from-an-example]

**Beispiel laden** öffnet einen Katalog von Startpunkten — Beziehungsdynamik, Szenenaufbau, Lorebook / Gedächtnisspeicher, Charakter-Statusanzeige, Zuneigungsanzeige, Würfel / Fertigkeitsprobe, Zeitraffer, Charakter-Tagebuch, Innere Gedanken, Wahrheit oder Pflicht und mehr, nach Kategorien geordnet.

Das sind Vorlagen für den Editor, keine Plugins, die jemand installiert hat. Eines auszuwählen füllt die Konfigurationsfelder, damit du von etwas aus weiterarbeitest, das schon funktioniert; geteilt oder veröffentlicht wird davon nichts, bis du dein eigenes Plugin speicherst und veröffentlichst.

## Lass die KI einen Entwurf machen \[#let-ai-draft-it]

Jeder Typ hat eine KI-Hilfe — **KI-Generierung** für eine Prompt-Vorlage mit Variablen, und Entsprechungen für die Tool- und die interaktive Konfiguration. Du beschreibst in ein, zwei Sätzen, was du willst, und der Editor füllt die Felder. Bei einem interaktiven Plugin mit KI-generierter Seite schreibt die Hilfe danach auch die **App-Hülle**. Auch die Einstellungen, die du den Installierenden zeigst, lassen sich so füllen, über **KI-Konfiguration ausfüllen**. Jede Generierung kostet Credits.

## Vorschau und Debuggen sind zweierlei \[#preview-and-debug-are-different]

|                   | **Vorschau**                                                                                                                        | **Debuggen**                                                                                                   |
| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| Was es tut        | Rendert deine Vorlage mit Testwerten, die du eintippst — der Figurenname steht standardmäßig auf *Alice*, der Nutzername auf *User* | Lässt den ungespeicherten Entwurf wirklich laufen, gegen die Figur, aus deren Chat du den Editor geöffnet hast |
| Was es zeigt      | Erzeugten Prompt, System-Prompt und die gerenderte Ausgabe                                                                          | Antwort der Figur, gerenderte Tool-Ausgabe, Ausführungsspur, Modell, Dauer, Tokens                             |
| Genutzter Kontext | Nur Platzhalter                                                                                                                     | Eine Momentaufnahme von Figur, Szenario, Persona, Erinnerungen, letzten Nachrichten und angeschalteten Plugins |
| Kosten            | Gratis                                                                                                                              | Gratis — es werden keine Credits abgebucht                                                                     |
| Kontingent        | Unbegrenzt                                                                                                                          | 30 Läufe pro 3 Stunden; der Dialog zeigt die verbleibenden                                                     |

Debuggen deckelt außerdem die Testnachricht bei 1.000 Zeichen und die Testkonfiguration bei 50.000. Ein Tool-Plugin lässt sich nur auf einem tool-fähigen Modell debuggen.

## Veröffentlichen und Prüfung \[#publishing-and-review]

Ein privates Plugin zu speichern macht es sofort nutzbar — für dich — und es wird in den Chat installiert, aus dem du es erstellt hast. **Plugin öffentlich machen** anzuschalten schickt diese Version stattdessen in die Prüfung:

1. Die Karte zeigt in deinem Reiter **Meine** **Genehmigung ausstehend**, und niemand sonst kann es installieren.
2. Eine automatische Vorprüfung läuft planmäßig und hält ihr Urteil fest.
3. Ein Mensch gibt frei oder lehnt ab. Freigegebene Plugins zeigen **Genehmigt** und erscheinen im Reiter **Community**.

Die Vorprüfung liest den Code der **App-Hülle** zusammen mit dem Rest des Plugins und kann es allein freigeben oder ablehnen. Ein Plugin, das zu lang ist, als dass sie es vollständig im Detail lesen könnte — meist eines mit großer Hülle —, kann sie weiterhin ablehnen, freigeben kann es aber nur ein Mensch.

Ein freigegebenes Plugin zu bearbeiten erzeugt eine neue Version, die erneut durch die Prüfung geht — die Karte fällt zurück auf **Genehmigung ausstehend**, während die zuvor freigegebene Version bei allen weiterläuft, die sie installiert haben.

> Jedes Speichern friert eine unveränderliche Kopie des Plugins ein, samt
> seiner Übersetzungen. Installationen fahren die Kopie, die sie festgeheftet
> haben, also bleibt, wer Version 2 installiert hat, auf Version 2, bis er auf
> Aktualisieren drückt. Was eine Figur mitbringt, darf nur eine geprüfte
> Version festheften.

## Was du verdienst \[#what-you-earn]

Nutzt jemand anderes dein Plugin in einer bezahlten Nachricht, verdienst du **5 % der Credit-Kosten des Textes, den dein Plugin selbst dem Prompt hinzufügt** — nicht 5 % der Nachricht. Der Betrag sind die Prompt-Tokens des Plugins selbst, mal dem Credit-Multiplikator des Modells, mal 5 %, skaliert mit dem Anteil jener Nachricht, der mit bezahlten Credits beglichen wurde.

Nichts entsteht, wenn:

| Fall                                                       | Warum                                                                    |
| ---------------------------------------------------------- | ------------------------------------------------------------------------ |
| Das Plugin ist offiziell                                   | Reveries eigene Plugins zahlen keine Provision                           |
| Du nutzt dein eigenes Plugin                               | Keine Selbstauszahlung                                                   |
| Das Plugin hat keine Prompt-Vorlage                        | Interaktive Plugins verdienen nichts — sie fügen dem Prompt nichts hinzu |
| Die Nachricht wurde vollständig mit Gratis-Credits bezahlt | Der bezahlte Anteil ist null                                             |

> **Interaktive Plugins verdienen nie Provision.** Wenn dir das Verdienen
> wichtig ist, bau ein Prompt- oder ein Tool-Plugin — das sind die beiden
> Typen, die Prompt-Text beisteuern.

## Wie du bezahlt wirst \[#getting-paid]

Provisionen sammeln sich als ausstehende Credits an und werden **monatlich, am 1.** abgerechnet. Liegt dein ausstehendes Guthaben zur Abrechnung unter **100 Credits**, wird in dem Monat nichts ausgezahlt und der Betrag wandert in den nächsten.

**Einnahmen anzeigen** im Reiter **Meine** zeigt **Insgesamt verdient**, **Ausstehend**, **Diesen Monat** und **Nächste Abrechnung**, dazu eine Aufschlüsselung pro Plugin mit Umsatz, Nutzungszahl und letzter Nutzung sowie deine Abrechnungshistorie.

## Verwandt \[#related]

* [Plugins nutzen](https://reverie.im/de/docs/plugins/using-plugins) — wie Installierende deine Arbeit sehen
* [Plugins](https://reverie.im/de/docs/plugins) — die drei Arten nebeneinander
* [Einnahmequellen](https://reverie.im/de/docs/creators/revenue-streams) — die anderen Wege, als Creator zu verdienen
* [Credits](https://reverie.im/de/docs/billing/credits) — was ein Credit ist und wie Nachrichten bepreist werden