Slash-Befehle

Anwendungsbefehle werden genau wie bei Discord registriert — dieselben Endpunkte, dieselben Payloads, dieselben Bibliotheken. Eine Regel ist anders: GameVox liefert eigene Befehle mit, und deren Namen sind reserviert.

Registrieren

Unverändert gegenüber Discord. Alle vier Routen funktionieren, global und pro Guild, zum Erstellen und Massenüberschreiben:

POST /api/v10/applications/{application_id}/commands
PUT  /api/v10/applications/{application_id}/commands
POST /api/v10/applications/{application_id}/guilds/{guild_id}/commands
PUT  /api/v10/applications/{application_id}/guilds/{guild_id}/commands

Reservierte Namen

GameVox beantwortet die untenstehenden Befehle selbst. Die Registrierung eines dieser Namen wird mit 400 und dem Discord-Fehlercode 50035 abgelehnt; die Meldung nennt den Befehl, sodass der Fehlschlag in deinem Deploy-Log offensichtlich ist.

Der Grund liegt beim Mitglied, nicht bei der Plattform. GameVox zeigt eingebaute und App-Befehle in einem einzigen Picker ohne Namensraum, sodass zwei Befehle namens ban als zwei identische Zeilen erscheinen, zwischen denen nichts unterscheidet. Für einen Moderationsbefehl ist das schlimmer als ein Fehler — niemand sollte rätseln müssen, welches /ban gerade ausgeführt wurde.

Gruppe	Reservierte Namen	Was GameVox damit macht
Moderation	`ban` `unban` `kick` `clear` `slowmode`	Wirkt direkt auf den Server, mit den GameVox-Berechtigungen der aufrufenden Person.
Spaß	`8ball` `flip` `choice` `ascii` `qrcode` `love`	Antwortet im Kanal.
Info	`serverinfo` `userinfo` `avatar`	Zeigt, was die aufrufende Person in der Oberfläche ohnehin sehen kann.
Mitglied	`afk` `remindme` `welcome` `goodbye`	Abwesenheitsnotizen, Erinnerungen und die Beitritts-/Austrittsnachricht des Servers.
Client	`me` `poll` `shrug` `tableflip` `unflip` `lenny`	Wird vom GameVox-Client verarbeitet, ohne einen Server zu erreichen.

Der Abgleich ignoriert Groß-/Kleinschreibung und umgebende Leerzeichen: Ban kollidiert mit ban, weil der Picker Namen ebenso abgleicht.

Falls du bereits einen registriert hast

Ein Befehl, der registriert wurde, bevor sein Name reserviert war, bleibt in der Datenbank, wird aber aus dem Picker des Mitglieds entfernt und beim Aufruf abgelehnt. Benenne ihn um und registriere ihn neu; sonst ändert sich nichts an deiner App.

Namen, die nicht reserviert sind

Nur exakte Übereinstimmungen sind belegt. banish, clearall und server-info gehören dir. Ebenso warn: GameVox hat keinen Verwarnungsbefehl, weil das Melden eines Mitglieds stattdessen über den Meldeablauf läuft.

Deine Befehle mit etwas Kurzem und App-Spezifischem zu präfixen lohnt sich ohnehin, reserviert oder nicht — genau das verhindert Kollisionen zwischen zwei installierten Apps, die GameVox nicht schlichtet.

Berechtigungen gelten weiterhin

Einen Namen zu reservieren hat nichts damit zu tun, wer deine Befehle ausführen darf. Das bleibt unverändert und standardmäßig verweigert: Ein registrierter Befehl ist nur für den Server-Eigentümer ausführbar, bis eine betreibende Person ihn unter Servereinstellungen → Integrationen einer Gruppe gewährt. Siehe Berechtigungen.