← Doku
Funktionsmatrix
Eine „Funktioniert das?“-Übersicht zu jeder Discord-Bot-Funktion auf GameVox. Nutze sie, um eine Migration abzuschätzen, bevor du die Gateway-URL umstellst. Die Spalte Selbst gehostet zeigt, ob eine Funktion arbeitet, wenn dein Bot auf einer selbst gehosteten GameVox-Instanz installiert ist. Die Weiterleitungsarchitektur beschreibt die Doku zu selbst gehosteten Servern.
| Bereich | Funktion | Cloud | Selbst gehostet | Hinweise |
|---|---|---|---|---|
| Gateway | JSON-Kodierung | Ja | Ja | Standard; was jede Bibliothek nutzt |
| zlib-stream-Kompression | Ja | Ja | Von jeder großen Bibliothek abgedeckt | |
| ETF-Kodierung | Nein | Nein | Bibliotheken fallen auf JSON zurück, wenn encoding=etf fehlt | |
| Zstandard-Kompression | Nein | Nein | zlib-stream ist die universelle Alternative | |
| Resume / op:6 | Ja | Ja | Der Resume-Puffer wird nach Redis gespiegelt, sodass op:6 Neustarts von api-Tasks übersteht | |
| Sharding | Ja | Ja | Üblicher Hash (guild_id >> 22) % num_shards | |
| REST | Nachrichten-CRUD | Ja | Ja | Senden, bearbeiten, löschen, Massenlöschung, abrufen, anpinnen, Tippen, Reaktionen |
| Kanal-CRUD | Ja | Ja | Cloud: inkl. Berechtigungs-Overwrites und Neuordnung. Selbst gehostet: Neuordnung ja, Overwrites pro Kanal laufen über Gruppen | |
| Berechtigungs-Overwrites pro Kanal | Ja | Nein | Selbst gehostet nutzt Berechtigungen auf Gruppenebene; das Overwrite-PUT gibt 501 zurück | |
| Mitglieder / Rollen / Banns | Ja | Ja | Vollständiges CRUD; communication_disabled_until (Timeout) wird nicht unterstützt | |
| Webhooks (Kanal & App) | Ja | Ja | Vollständiges CRUD + Execute (Embeds, Anhänge, Multipart). Die Datensätze bleiben im Cloud-Speicher; Execute schreibt über den Bot-Weiterleitungspfad in selbst gehostete Kanäle | |
| App-eigene Emojis | Nur Portal | Nur Portal | Verwaltung im Entwicklerportal; GET über die Bot-API funktioniert. Siehe Emojis | |
| Audit-Log | Teilweise | Teilweise | Für Bots relevante Einträge; der Verlauf von Overwrites pro Kanal wird nicht indiziert | |
| Rate-Limit-Header | Ja | Ja | X-RateLimit-* bei jeder Antwort, Bucket-bewusst | |
| Interaktionen | Anwendungsbefehle (Slash, Nutzer, Nachricht) | Ja | Nein | Cloud: Massen-PUT + einzelnes CRUD. Selbst gehostet: Registrierung & Aufruf noch nicht weitergeleitet |
| Komponenten v1 (Buttons, Auswahlfelder, Dialoge) | Ja | Nein | Werden im GameVox-Client gerendert; selbst gehostet braucht eine Ereignis-Bridge | |
| Komponenten v2 | Nein | Nein | Für nach v1 geplant | |
| Interaktionen im HTTP-Modus (ausgehender Endpunkt) | Ja | Nein | Die Cloud sendet an deine konfigurierte interactions_endpoint_url mit Ed25519-Signatur; fällt auf das Gateway zurück, wenn der Endpunkt ausfällt. Aufrufe auf selbst gehosteten Servern werden noch nicht weitergeleitet | |
| Sprache | UDP-Sprach-Gateway | Ja | Ja | Pro Region. Siehe Sprach-Doku |
| AEAD AES-256-GCM | Ja | Ja | Bevorzugt | |
| AEAD XChaCha20-Poly1305 | Ja | Ja | Rückfall | |
| Bot-gesteuerte Änderung des Sprachzustands | Ja | Teilweise | Beide: PATCH .../voice-states/{user_id} für Stummschalten / Verschieben / Trennen. Selbst gehostet: deaf gibt 501 zurück (kein SFU-Primitiv); Verschieben löst zwei statt einem Ereignis aus | |
| Sonstiges | Server-Emojis (lesend) | Ja | Ja | Auflisten + abrufen; Erstellen/Ändern/Löschen nur über das Portal |
| Soundboard (lesend) | Ja | Ja | Auflisten + abrufen; bot-gesteuerte Wiedergabe wird nicht unterstützt | |
| Vanity-URL | Teilweise | Nein | Cloud: lesen + ändern (Server ab Gold). Selbst gehostet: PATCH gibt 501 zurück | |
| Threads / Forenbeiträge | Platzhalter | Platzhalter | Forenkanäle existieren; Thread-CRUD gibt leer / 400 zurück | |
| Stage-Kanäle, AutoMod, geplante Termine | Nein | Nein | Intents werden akzeptiert, keine Ereignisse | |
| Premium-Apps / Entitlements | Nein | Nein | In v1 keine Monetarisierungsschicht | |
| Portal | Teams (Eigentum mehrerer Entwickler) | Ja | Discord-Parität. Siehe Teams | |
| App-Übertragung an ein Team | Ja | Einseitig (wie bei Discord) | ||
| App-Tester (Installationsliste für private Apps) | Ja | 100 pro App. Siehe Teams → Tester | ||
| OAuth2-Installationslinks (Nutzer- + Serverkontext) | Ja | Keiner / von GameVox bereitgestellt / eigene URL. Siehe OAuth2 | ||
| Rotation des Client-Secrets | Ja | Bcrypt-gehasht; wird beim Erstellen / Rotieren einmalig angezeigt | ||
| Bot-Verzeichniseintrag | Ja | Von der Administration freigegebene Einträge auf gamevox.com/bots | ||
Legende
- Ja: funktioniert wie bei Discord, keine Codeänderungen.
- Teilweise: wire-kompatibel, aber es fehlt ein Teil der Semantik. Aufrufbar, löst aber ggf. keine Ereignisse aus.
- Nein: wird auf dem Wire akzeptiert (kein 4014), bewirkt aber nichts. Plane damit, dass es nicht da ist.