# Discord-Bot

> Chatte in deinen DMs unter vier Augen, oder hol Figuren in einen Server und leg fest, wer mit ihnen reden darf und wer zahlt.

Source: https://reverie.im/de/docs/integrations/discord-bot
Language: de

Der Reverie-Bot bringt Figuren an zwei Orte in Discord: in deine **Direktnachrichten** mit dem Bot, für Gespräche unter vier Augen, und in **Server-Kanäle**, wo jede Figur unter ihrem eigenen Namen und Avatar spricht. Wer mit einer Figur redet, braucht ein Reverie-Konto, das mit seinem Discord-Konto verknüpft ist — ein kostenloses reicht —, und jede Antwort wird einem Reverie-Konto in Guthaben berechnet.

## Dein Konto verknüpfen \[#link-your-account]

Ein Discord-Konto gehört zu genau einem Reverie-Konto. Jeder dieser Wege verbindet die beiden:

* **Über das Integrations-Dashboard.** Geh in der App zu **Labs → Discord- & Telegram-Bots** und drücke auf der Discord-Karte **Mit Discord verknüpfen**. Du bestätigst auf Discord und landest direkt wieder hier.
* **Mit Discord anmelden.** Wer sich mit Discord bei Reverie anmeldet, verknüpft den Bot gleich mit — außer du hast die Verknüpfung im Dashboard gelöst; dann bleibt sie gelöst, bis du selbst wieder verknüpfst.
* **Aus Discord heraus.** Führe `/link-account` in einem Server oder in deinen DMs mit dem Bot aus. Nur du siehst die Antwort: einen Button **Mein Konto verknüpfen**, der einmal funktioniert und nach **10 Minuten** abläuft. Öffne ihn, melde dich an, und die Konten sind verbunden.

## Unter vier Augen in deinen DMs \[#chat-one-on-one-in-your-dms]

Schreib dem Bot eine Direktnachricht, oder führe `/chat` in einem Server aus, in dem der Bot ist — das Gespräch wandert in deine DMs, wo nur du es siehst. `/chat` allein bietet Figuren zur Auswahl an; mit einem Namen dahinter suchst du nach einer.

* **Eine Figur auf einmal.** `/chat` wechselt zu jemand anderem, und `/chats` listet die Figuren, mit denen du in deinen DMs gesprochen hast. Jede behält ihr eigenes Gespräch, du machst also beim Zurückwechseln genau dort weiter, wo du aufgehört hast.
* **Jede Nachricht bekommt eine Antwort**, gepostet vom Bot, mit dem Namen der Figur in kleiner Schrift darüber. Bilder, Sprachnachrichten und Erinnerungen funktionieren wie in einem Kanal.
* **Du zahlst** deine eigenen Nachrichten. Zahlungsmodi und Limits eines Servers gelten hier nicht.
* **18+-Figuren** folgen der 18+-Einstellung deines Kontos: Ist sie aus, sind sie verborgen und können nicht in deinen DMs chatten.
* `/remove-character` beendet das aktuelle Gespräch — es bleibt für `/chats` gespeichert —, und `/reset-chat` löscht es, nachdem du bestätigt hast.
* Von den Unterbefehlen von `/settings` gelten in DMs nur `model`, `language` und `chat-style`.

Sagt der Bot, dass er dir nicht schreiben konnte, erlaube in deinen Discord-Privatsphäre-Einstellungen Direktnachrichten von Servermitgliedern und versuch es noch einmal. Deine letzten DM-Gespräche erscheinen auch im Integrations-Dashboard unter **Privater Chat**, wo du mit **Im Web weiterchatten** im Browser weitermachst.

## Den Bot zu einem Server hinzufügen \[#add-the-bot-to-a-server]

### Den Bot einladen \[#invite-the-bot]

Drücke auf der Discord-Karte im Integrations-Dashboard **Bot zum Server hinzufügen** und wähle einen Server. Lass jede angefragte Berechtigung angehakt — die Tabelle unten sagt, wofür jede da ist. Wenn er beitritt, postet der Bot eine kurze Anleitung dort, wo der Server seine Beitrittsnachrichten zeigt.

### Eine Figur in einen Kanal holen \[#add-a-character-to-a-channel]

Führe in einem Textkanal `/add-character` aus und wähle eine Figur aus der Autovervollständigung — sie umfasst öffentliche Figuren und deine eigenen privaten. Du brauchst die Berechtigung **Manage Channels** und ein verknüpftes Konto. Der Bot legt einen Webhook an, damit die Figur unter ihrem eigenen Namen posten kann, und schickt eine Begrüßung.

### Die Regeln festlegen \[#set-the-rules]

Optional. `/settings` bestimmt, wie die Figuren eines Kanals antworten und wer für sie zahlt; `/server` bestimmt, wer überhaupt mit ihnen reden darf. Beides steht weiter unten.

## Berechtigungen, die die Einladung anfragt \[#permissions-the-invite-requests]

| Berechtigung        | Warum sie angefragt wird                                                       |
| ------------------- | ------------------------------------------------------------------------------ |
| **View Channels**   | Den Kanal lesen, in dem der Bot benutzt wird                                   |
| **Send Messages**   | Antworten und Befehlsausgaben posten                                           |
| **Manage Messages** | Antworten der Figur entfernen, wenn die auslösende Nachricht gelöscht wird     |
| **Embed Links**     | Befehlsausgaben und Ankündigungen der Community-Ziehung sind Einbettungen      |
| **Manage Roles**    | Die Rolle vergeben, die die Community-Ziehung in Reveries eigenem Server nutzt |
| **Manage Webhooks** | **Pflicht.** Figuren sprechen über einen Webhook pro Figur                     |

Ohne **Manage Webhooks** schlägt `/add-character` fehl und die Figur wird nicht hinzugefügt.

## Befehle \[#commands]

In einem Server werden Befehle mit **Manage Channels** oder **Manage Server** nur Mitgliedern mit dieser Discord-Berechtigung angeboten. Antworten auf Konto- und Verwaltungsbefehle siehst nur du.

| Befehl               | Optionen                  | Wo                                        | Was er tut                                                                                                                                                                                                                                                                  |
| -------------------- | ------------------------- | ----------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `/help`              | —                         | Server, DM                                | Listet die Befehle auf, nur für dich sichtbar                                                                                                                                                                                                                               |
| `/link-account`      | —                         | Server, DM                                | Postet einen Einmal-Link, der dein Discord- und dein Reverie-Konto verbindet                                                                                                                                                                                                |
| `/chat`              | `name` (optional)         | Server, DM                                | Wählt oder wechselt die Figur in deinen DMs. Im Server schickt er die Auswahl in deine DMs                                                                                                                                                                                  |
| `/chats`             | —                         | Server, DM                                | Die Figuren, mit denen du in deinen DMs gesprochen hast, zum Wechseln                                                                                                                                                                                                       |
| `/add-character`     | `name` (Pflicht)          | Server · Manage Channels                  | Holt eine Figur in diesen Kanal und lässt sie grüßen                                                                                                                                                                                                                        |
| `/remove-character`  | `name` (Pflicht)          | Server · Manage Channels, DM              | Entfernt die Figur und löscht ihren Webhook. In deinen DMs beendet er das aktuelle Gespräch                                                                                                                                                                                 |
| `/list-characters`   | —                         | Server                                    | Listet die Figuren dieses Kanals, jede mit einem Entfernen-Button                                                                                                                                                                                                           |
| `/character-info`    | `name` (Pflicht)          | Server, DM                                | Bio, Bilder, Alter, Geschlecht, Bewertung, Kategorien, Tags und NSFW-Kennzeichen, mit Link zur Seite der Figur. Mit verknüpftem Konto bietet er außerdem 1–5★-Buttons zum Bewerten an, sobald du ein paar Antworten der Figur bekommen hast und ihre Bewertungen offen sind |
| `/reset-chat`        | —                         | Server · Manage Channels, DM              | Löscht die Nachrichten und Zusammenfassungen des Kanals und meldet die Zahlen. In deinen DMs löscht er das aktuelle Gespräch, sobald du bestätigst                                                                                                                          |
| `/regenerate-reply`  | `model` (optional)        | Server, DM                                | Würfelt die letzte Antwort der Figur neu, auf Wunsch für diesen Versuch mit einem anderen Modell                                                                                                                                                                            |
| `/reply-suggestions` | —                         | Server, DM                                | Drei Antwortvorschläge als Buttons; ein Tipp schickt ihn als deine Nachricht                                                                                                                                                                                                |
| `/settings`          | ein Unterbefehl (Pflicht) | Server, DM                                | Kanal- und persönliche Einstellungen                                                                                                                                                                                                                                        |
| `/plugins`           | ein Unterbefehl (Pflicht) | Server, DM                                | Zeigt die hier laufenden Plugins; installiert, entfernt oder schaltet offizielle und eigene Plugins                                                                                                                                                                         |
| `/server`            | —                         | Server · Manage Server oder der Gastgeber | Wer mit Figuren reden darf, ein Tageslimit pro Mitglied, blockierte Mitglieder und Verbrauch                                                                                                                                                                                |
| `/my-account`        | —                         | Server, DM                                | Guthaben, Tarifverbrauch, Verlängerungsdatum, Chat-Anzahl                                                                                                                                                                                                                   |
| `/daily`             | —                         | Server, DM                                | Holt deine tägliche Belohnung ab                                                                                                                                                                                                                                            |
| `/notify`            | —                         | Server, DM                                | Ob Figuren dir zuerst schreiben dürfen, und welche Benachrichtigungen in deinen DMs ankommen                                                                                                                                                                                |

`/plugins` nimmt `list`, `install`, `remove`, `enable` oder `disable`. Angeboten werden nur offizielle Plugins und deine eigenen, und nur Prompt- und Tool-Plugins; ein Plugin, dessen Einstellungen ausgefüllt werden müssen, lässt sich nicht über den Bot installieren. Das Ergebnis eines Tool-Plugins erscheint als kurze Karte unter dem Namen der Figur. In einem Kanal braucht das Ändern von Plugins **Manage Channels** oder dass du eine Figur in den Kanal geholt hast, und auflisten kann sie jeder; in deinen DMs entscheidest du selbst über sie.

`/settings` allein ist kein gültiger Befehl — er nimmt immer einen von sechs Unterbefehlen:

| Unterbefehl              | Option                        | Braucht         | Wirkung                                                                                                                                           |
| ------------------------ | ----------------------------- | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `/settings model`        | `model` (optional)            | —               | **Dein** Modell für die Hauptfigur dieses Kanals. Leer zeigt das aktuelle oder setzt es zurück. Fortgeschrittene Modelle können ein Abo verlangen |
| `/settings language`     | `language` (optional)         | Manage Channels | Antwortsprache des Kanals. Leer setzt auf Englisch zurück                                                                                         |
| `/settings channel-mode` | `mode`: `auto` oder `mention` | Manage Channels | Ob Figuren auf jede Nachricht antworten oder nur, wenn man sie anspricht                                                                          |
| `/settings chat-style`   | `style`: `RP` oder `NORMAL`   | Manage Channels | Rollenspielprosa mit Handlungen, oder nur Dialog                                                                                                  |
| `/settings payment-mode` | `mode`: `owner` oder `user`   | Manage Channels | Wer belastet wird                                                                                                                                 |
| `/settings daily-limit`  | `credits` (Pflicht, ≥ 0)      | Manage Channels | Guthaben-Obergrenze pro UTC-Tag. `0` heißt unbegrenzt                                                                                             |

Dieselben Einstellungen stehen im Web-Dashboard pro Kanal als **Payment mode**, **Daily credit limit**, **Chat style**, **Reply mode**, **Response language** und **Your model**. Sprache und Modell bleiben dort deaktiviert, bis jemand eine Nachricht im Kanal geschickt hat.

## Wann eine Figur antwortet \[#when-a-character-replies]

Eine Figur antwortet, wenn sie **@erwähnt** wird, wenn jemand auf eine ihrer Nachrichten **antwortet**, oder wenn der Kanal auf automatische Antwort steht. Die automatische Antwort ist **standardmäßig aus**, eine frisch hinzugefügte Figur bleibt also still, bis man sie anspricht.

Sind mehrere Figuren in einem Kanal, verhält sich der Kanal wie ein einziger Gruppenchat: eine Anfrage listet alle anwesenden Figuren auf, und das Modell entscheidet, wer spricht. Einen Namen zu nennen ist ein Hinweis, der mit deiner Nachricht weitergereicht wird, kein Schalter, der diese Figur zum Antworten zwingt. [Gruppenchats →](https://reverie.im/de/docs/chatting/group-chats)

## Threads \[#threads]

Ein Thread in einem Textkanal spricht mit den Figuren dieses Kanals und folgt dessen Zahlungsmodus, Antwortmodus und Chat-Stil, führt aber einen eigenen Verlauf — Platz für eine Nebenszene, die den Kanal nicht zumüllt. Er startet in der Antwortsprache des Kanals; `/settings language` und `/settings model` gelten, im Thread benutzt, nur für den Thread. Was ein Thread verbraucht, zählt zum Tageslimit des Kanals. Befehle, die die Besetzung oder die übrigen Einstellungen des Kanals ändern, etwa `/add-character`, `/list-characters`, `/plugins` oder `/settings chat-style`, verweisen dich an den übergeordneten Kanal. Forenbeiträge und andere Arten von Threads haben keine Figuren.

## Wer zahlt \[#who-pays]

| Zahlungsmodus             | Belastet wird                                                                                                                  | Welche Limits gelten                                                                          |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------- |
| **Owner pays** (Standard) | Der Gastgeber des Servers: das Reverie-Konto, das als erstes eine Figur in den Server geholt hat, bis jemand anderes übernimmt | Das tägliche Guthaben-Limit des Kanals und das mit `/server` gesetzte Tageslimit pro Mitglied |
| **User pays**             | Das Guthaben der jeweils sendenden Person                                                                                      | Keine — jedes Mitglied ist durch sein eigenes Guthaben begrenzt                               |

Nachrichten kosten dasselbe wie in der Web-App: pro Token, multipliziert mit dem Guthaben-Multiplikator des Modells. Die Tageszähler werden um **00:00 UTC** zurückgesetzt, und der Einstellungsdialog des Kanals im Dashboard zeigt den heutigen Verbrauch gegen das Limit.

Um die Rechnung auf dein eigenes Konto zu nehmen — etwa weil die Person, die den Bot eingerichtet hat, nicht mehr da ist —, öffne `/server` und drücke **Mit meinem Konto zahlen**. Das gilt für jeden Kanal des Servers, in dem der Gastgeber zahlt.

## Server-Regeln \[#server-rules]

`/server` öffnet ein Panel, das nur du siehst. Öffnen können es Mitglieder mit **Manage Server** und wer für die Figuren des Servers zahlt. Es zeigt den Verbrauch von heute und der letzten sieben Tage, die Mitglieder mit dem höchsten Verbrauch heute und drei Regeln:

| Regel                       | Auswahl                                                                                                                                       |
| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| **Wer chatten darf**        | **Alle** (Standard), **Nur Admins** oder **Mitglieder mit bestimmten Rollen** — die Rollen wählst du in einem zweiten Menü                    |
| **Tageslimit pro Mitglied** | Wie viel vom Guthaben des Gastgebers ein Mitglied pro UTC-Tag ausgeben darf, oder **Kein Limit** (Standard). Gilt nur, wo der Gastgeber zahlt |
| **Blockierte Mitglieder**   | Hier ausgewählte Mitglieder können im ganzen Server nicht mit Figuren reden                                                                   |

Admin heißt hier: ein Mitglied mit **Manage Server**. Admins und das zahlende Konto werden nie ausgesperrt, weder durch eine Blockierung noch durch den Zugriffsmodus, und solange keine Rolle gewählt ist, lässt **Mitglieder mit bestimmten Rollen** nur sie reden. Wer vom Zugriffsmodus ausgeschlossen ist, erfährt einmal, dass nur manche Mitglieder mit Figuren reden können; ein blockiertes Mitglied bekommt gar keine Antwort.

## Altersbeschränkte Figuren \[#age-restricted-characters]

Eine 18+-Figur antwortet nur in einem altersbeschränkten Kanal, in einem Kanal unter einer altersbeschränkten Kategorie oder überall in einem Server, der auf 18+ gestellt ist — ein Thread folgt seinem Kanal. Überall sonst erklärt der Bot, warum, statt zu antworten. In deinen DMs folgen 18+-Figuren stattdessen der 18+-Einstellung deines Kontos.

## Was in einem Kanal funktioniert \[#what-works-in-a-channel]

* **Bilder.** Figuren können in Discord Bilder erzeugen.
* **Sprache raus.** Figuren können Sprachnachrichten senden.
* **Sprache rein.** Sprachnachrichten, die du schickst, werden transkribiert, bis **25 MB**.
* **Erinnerung.** Figuren speichern, aktualisieren und löschen Erinnerungen, wenn das Modell Werkzeuge unterstützt, und der Kanon aus Weltbüchern kommt in ihren Kontext.
* **Verlauf.** Lange Kanäle werden automatisch zusammengefasst, während sie wachsen.
* Eine zweite Figur im Kanal übernimmt dessen Chat-Stil, Zahlungsmodus und Tageslimit.

## Benachrichtigungen und tägliche Belohnung \[#notifications-and-check-ins]

`/notify` stellt zwei Dinge ein. **Charaktere, die dir zuerst schreiben** ist die Proaktivitätsstufe deines Kontos, dieselbe Einstellung wie auf der Website: Mit einem Abo kann die Figur, mit der du in deinen DMs gerade sprichst, dir von sich aus schreiben — siehe [Nachrichten von sich aus](https://reverie.im/de/docs/chatting/proactive-messages). **Auch hier empfangen** wählt aus, welche deiner Reverie-Benachrichtigungen zusätzlich in deinen DMs ankommen; anfangs ist nur **Konto & Abrechnung** an — siehe [Benachrichtigungen](https://reverie.im/de/docs/account/notifications). Das Integrations-Dashboard bietet dieselbe Auswahl.

`/daily` holt deine [tägliche Belohnung](https://reverie.im/de/docs/rewards/daily-check-in) ab, dieselbe wie auf der Website, und verlinkt die Glücksziehung.

## Nachrichten bearbeiten und löschen \[#editing-and-deleting-messages]

Wenn du deine neueste Nachricht bearbeitest, wird die Antwort darauf neu erzeugt.

> Eine Nachricht in Discord zu löschen entfernt diese Nachricht **und jede Nachricht danach** aus dem Verlauf der Figur, zusammen mit Erinnerungen und Anhängen, die danach entstanden sind. Auch die Antworten der Figur verschwinden aus dem Kanal. Das lässt sich nicht rückgängig machen.

## Was der Bot liest \[#what-the-bot-reads]

Der Bot bekommt jede Nachricht in den Kanälen, die er sehen kann — so erreichen ihn Erwähnungen und Antworten. Vor jeder Antwort liest er außerdem die **jüngsten Nachrichten der letzten Stunde** im Kanal, auch solche, die nicht an ihn gerichtet sind, und gibt sie dem Modell als Kontext mit, damit die Figur dem Raum folgen kann.

Behandle einen Kanal mit dem Bot darin als Kanal, in dem der Bot zuhört. Wenn du das nicht willst, setz die Figuren in einen eigenen Kanal.

## Grenzen \[#limits]

| Grenze                         | Wert                            |
| ------------------------------ | ------------------------------- |
| Figuren pro Kanal              | 5                               |
| Länge einer Discord-Nachricht  | 2.000 Zeichen                   |
| Größe einer Sprachnachricht    | 25 MB                           |
| Webhooks pro Discord-Kanal     | 15 (Discords eigene Obergrenze) |
| Wartende Nachrichten pro Kanal | 3                               |

Schnell aufeinanderfolgende Nachrichten derselben Person werden zu einem Zug zusammengefasst.

## Verknüpfung lösen \[#unlinking]

Löse die Verknüpfung im Integrations-Dashboard mit **Verknüpfung lösen**. Den Bot von einem Server zu entfernen oder ihn zu verlassen löst die Kontoverknüpfung nicht. Ist sie gelöst, verknüpft eine Anmeldung mit Discord den Bot nicht mehr von selbst — nimm **Mit Discord verknüpfen** oder `/link-account`, wenn du ihn zurückwillst.

## Verwandt \[#related]

* [Telegram-Bot](https://reverie.im/de/docs/integrations/telegram-bot) — dieselben Figuren, in Telegram
* [Reverie Labs](https://reverie.im/de/docs/integrations/labs) — wo das Integrations-Dashboard wohnt
* [Gruppenchats](https://reverie.im/de/docs/chatting/group-chats) — wie Gespräche mit mehreren Figuren laufen
* [Credits](https://reverie.im/de/docs/billing/credits) — was eine Nachricht kostet
