← Docs

Commandes slash

Les commandes d’application s’enregistrent exactement comme sur Discord — mêmes endpoints, mêmes charges utiles, mêmes bibliothèques. Une seule règle diffère : GameVox fournit ses propres commandes, et leurs noms sont réservés.

Enregistrement

Inchangé par rapport à Discord. Les quatre routes fonctionnent, globales et par guild, en création comme en écrasement groupé :

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

Noms réservés

GameVox répond lui-même aux commandes ci-dessous. Enregistrer l’un de ces noms est refusé avec un 400 et le code d’erreur Discord 50035 ; le message nomme la commande, donc l’échec saute aux yeux dans votre journal de déploiement.

La raison tient au membre, pas à la plateforme. GameVox affiche les commandes intégrées et celles des apps dans un unique sélecteur sans espace de noms, si bien que deux commandes nommées ban apparaissent comme deux lignes identiques, sans rien pour les distinguer. Pour une commande de modération, c’est pire qu’une erreur : personne ne devrait avoir à deviner quel /ban vient d’être exécuté.

Groupe	Noms réservés	Ce que GameVox en fait
Modération	ban unban kick clear slowmode	Agit directement sur le serveur, avec les permissions GameVox de la personne appelante.
Divertissement	8ball flip choice ascii qrcode love	Répond dans le salon.
Informations	serverinfo userinfo avatar	Montre ce que la personne appelante peut déjà voir dans l’interface.
Membre	afk remindme welcome goodbye	Notes d’absence, rappels, et le message d’arrivée/départ du serveur.
Client	me poll shrug tableflip unflip lenny	Traité par le client GameVox sans atteindre un serveur.

La correspondance ignore la casse et les espaces autour : Ban entre en conflit avec ban, parce que le sélecteur compare les noms de la même façon.

Si vous en avez déjà enregistré une

Une commande enregistrée avant que son nom ne soit réservé reste en base, mais elle est retirée du sélecteur du membre et refusée si elle est invoquée. Renommez-la et réenregistrez-la ; rien d’autre dans votre app n’est affecté.

Noms qui ne sont pas réservés

Seules les correspondances exactes sont prises. banish, clearall et server-info sont à vous. warn aussi : GameVox n’a pas de commande d’avertissement, car le signalement d’un membre passe par le parcours de signalement.

Préfixer vos commandes avec quelque chose de court et propre à votre app vaut le coup de toute façon, réservé ou non : c’est ce qui évite que deux apps installées entrent en conflit, ce que GameVox n’arbitre pas.

Les permissions s’appliquent toujours

Réserver un nom n’a rien à voir avec qui peut exécuter vos commandes. Cela reste inchangé et refusé par défaut : une commande enregistrée n’est exécutable que par la personne propriétaire du serveur jusqu’à ce qu’une personne l’accorde à un groupe dans Réglages du serveur → Intégrations. Voir Permissions.