Comandos de barra
Los comandos de aplicación se registran exactamente igual que en Discord: los mismos endpoints, las mismas cargas útiles, las mismas bibliotecas. Solo cambia una regla: GameVox trae comandos propios y sus nombres están reservados.
Registro
Sin cambios respecto a Discord. Las cuatro rutas funcionan, globales y por guild, para crear y para sobrescribir en bloque:
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 Nombres reservados
GameVox responde por sí mismo los comandos de abajo. Registrar uno de estos nombres se rechaza con 400 y el código de error de Discord 50035; el mensaje nombra el comando, así que el fallo es evidente en tu registro de despliegue.
El motivo es la persona miembro, no la plataforma. GameVox muestra los comandos integrados y los de apps en un único selector sin espacio de nombres, así que dos comandos llamados ban aparecen como dos filas idénticas sin nada que las distinga. Para un comando de moderación eso es peor que un error: nadie debería tener que adivinar qué /ban acaba de ejecutar.
| Grupo | Nombres reservados | Qué hace GameVox con ellos |
|---|---|---|
| Moderación | ban unban kick clear slowmode | Actúa sobre el servidor directamente, con los permisos de GameVox de quien lo invoca. |
| Diversión | 8ball flip choice ascii qrcode love | Responde en el canal. |
| Información | serverinfo userinfo avatar | Muestra lo que quien lo invoca ya puede ver en la interfaz. |
| Miembro | afk remindme welcome goodbye | Notas de ausencia, recordatorios y el mensaje de entrada/salida del servidor. |
| Cliente | me poll shrug tableflip unflip lenny | Lo gestiona el cliente de GameVox sin llegar a un servidor. |
La coincidencia ignora mayúsculas y espacios alrededor: Ban choca con ban, porque el selector compara los nombres de la misma manera.
Si ya registraste uno
Un comando registrado antes de que su nombre quedara reservado permanece en la base de datos, pero se retira del selector de la persona miembro y se rechaza si se invoca. Renómbralo y vuelve a registrarlo; nada más de tu app se ve afectado.
Nombres que no están reservados
Solo se toman las coincidencias exactas. banish, clearall y server-info son todos tuyos. También lo es warn: GameVox no tiene comando de advertencia, porque denunciar a una persona miembro se gestiona a través del flujo de denuncias.
Prefijar tus comandos con algo corto y propio de tu app merece la pena de todos modos, esté reservado o no: es lo que evita que dos apps instaladas choquen entre sí, algo que GameVox no arbitra.
Los permisos siguen aplicándose
Reservar un nombre no tiene nada que ver con quién puede ejecutar tus comandos. Eso no cambia y deniega por defecto: un comando registrado solo puede ejecutarlo quien sea propietario del servidor hasta que alguien lo conceda a un grupo en Ajustes del servidor → Integraciones. Consulta Permisos.