Documentación
Guía de uso de USMAN Bot
Empezar en 4 pasos
- Añade el bot a tu servidor con el botón «Añadir a Discord». Recibe automáticamente los permisos que necesita (un rol «USMAN Bot» creado por Discord). Debes tener «Gestionar servidor» en ese servidor.
- Inicia sesión en el panel con Discord y elige tu servidor en la lista (solo aparecen los servidores donde está el bot y donde gestionas el servidor).
- Indica los datos de VRChat: la cuenta dedicada del bot y el ID del grupo (módulo «VRChat»).
- Elige tus canales y roles en los menús y haz clic en «Guardar». Los nuevos ajustes se aplican en unos segundos.
El panel
La barra lateral muestra los módulos. Tus cambios quedan como borrador hasta que hagas clic en «Guardar» (barra en la parte inferior de la página). Las contraseñas y secretos que introduces nunca se vuelven a mostrar: una insignia solo indica que están guardados. Para cambiar de servidor, usa el selector en la parte superior de la barra lateral.
Los módulos
| Módulo | Qué hace |
|---|---|
| Lista de baneados | Canal donde el bot mantiene un único mensaje con los baneados del grupo, actualizado automáticamente, con paginación mediante reacciones ⏮️ ⬅️ ➡️ ⏭️. Los baneos temporales muestran el tiempo restante. Los títulos y textos siguen el idioma del servidor. Ajusta el número por página y la frecuencia. |
| Registros del grupo | Cada acción del grupo de VRChat (baneos, roles, invitaciones…) se publica en un canal. Las acciones hechas con los comandos del bot también se anotan allí, con el miembro de Discord que las realizó. |
| Instancias | Avisa en un canal cuando se abre una instancia del grupo; también puede publicar un post en el grupo de VRChat (título y texto personalizables, retardo antispam). |
| Moderadores y miembros | Dos canales con la lista de moderadores del grupo y la lista de miembros, siempre actualizadas. |
| Permisos | Elige qué roles de Discord pueden usar /ban, /tempban, /unban y /mod. Los administradores del servidor no están autorizados automáticamente: añade su rol si hace falta. |
| VRChat | Cuenta dedicada, ID del grupo (grp_…), rol de moderador que asignar, secreto 2FA opcional, introducción del código 2FA si VRChat lo pide. |
| Datos y privacidad | Exportar todos tus datos, eliminarlo todo o hacer que el bot abandone el servidor. |
Comandos de Discord
| Comando | Efecto |
|---|---|
/ban <usuario> [motivo] | Banea permanentemente al jugador del grupo de VRChat. |
/tempban <usuario> <duracion> [motivo] | Banea al jugador temporalmente: se desbanea automáticamente al terminar la duración. |
/unban <usuario> | Desbanea al jugador (y cancela su baneo temporal, si lo había). |
/mod agregar <usuario> | Da el rol de moderador del grupo al jugador de VRChat. |
/mod quitar <usuario> | Quita ese rol. |
/vrchat estado | Muestra el estado de la conexión con la cuenta de VRChat. |
/vrchat roles | Lista los roles del grupo y sus identificadores. |
/vrchat codigo <codigo> | Introduce el código 2FA que pide VRChat. |
Duración de /tempban
La duración es un número seguido de una unidad: s = segundos, m = minutos, h = horas, d = días. Ejemplos: 30m (30 minutos), 12h (12 horas), 7d (7 días), 1h30m (1 h 30). Mínimo 10 segundos, máximo 365 días. El desbaneo es automático, incluso si el bot se reinició mientras tanto. Usar /ban sobre un jugador con baneo temporal lo vuelve permanente.
Idioma de los comandos
Los nombres de los comandos, las opciones y las respuestas se muestran en el idioma de tu aplicación de Discord (inglés, francés, español o chino; inglés por defecto). Los registros y mensajes del bot en el servidor siguen el idioma del servidor.
Estos comandos están reservados a los roles que elegiste en «Permisos». Cada acción queda registrada en el canal de registros.
Cuenta de VRChat
- Crea una cuenta de VRChat dedicada al bot y añádela a tu grupo con un rol que tenga los permisos necesarios (ver baneados, gestionar baneados, gestionar roles, ver registros…). Sin ellos, VRChat responde «You don’t have permission».
- El ID del grupo tiene este aspecto:
grp_xxxxxxxx-xxxx-…(en la dirección de la página del grupo en vrchat.com). - Si la cuenta usa autenticación en dos pasos con una aplicación, pega su secreto TOTP en el panel: el bot generará los códigos por sí solo. Si no, introduce el código recibido cuando el panel lo pida.
- El servicio usa la API no oficial de VRChat: un uso excesivo puede ser limitado por VRChat. Por eso los intervalos mínimos están acotados.
Tus datos
Consulta la política de privacidad. En resumen: solo se almacena lo necesario, los secretos se cifran, todo se elimina cuando quitas el bot y el módulo «Datos y privacidad» permite exportar o borrar en cualquier momento.
Problemas frecuentes
Mi servidor no aparece en la lista
El bot debe estar en el servidor y debes tener «Gestionar servidor». Cierra sesión y vuelve a iniciarla para actualizar la lista.
«You don’t have permission» en la lista de baneados
La cuenta de VRChat del bot no tiene el rol o los permisos necesarios en el grupo.
Los comandos no aparecen
Vuelve a invitar al bot con el botón «Añadir a Discord» (se necesita el ámbito applications.commands) y espera un minuto.
El bot no escribe en un canal
Comprueba que su rol puede ver el canal y enviar mensajes e incrustaciones. Los canales sin este permiso se señalan en los menús.
El panel pide un código 2FA
VRChat ha enviado un código por correo o aplicación: introdúcelo en el módulo «VRChat».
¿Necesitas ayuda? Únete a nuestro servidor de Discord o escribe a [email protected].