Bots personalizados | Documentación de Noxyr

Qué es un bot personalizado

Un bot personalizado es Noxyr funcionando con un token de bot que tú controlas. Los miembros ven tu nombre y tu avatar, pero el código, los ajustes y la base de datos son de Noxyr: un cambio que hagas en el panel se aplica a ambos bots, y nada se duplica.

Noxyr lo aloja por ti en uno de sus nodos. Cada servidor tiene un único bot responsable: donde está presente tu bot personalizado, Noxyr se aparta y deja de responder; donde no está, Noxyr sigue como siempre. Una cuenta de Discord tiene un bot personalizado, y puedes usar ese mismo bot en todos los servidores que administres.

Lo que necesitas

Un voto en Top.gg: Votar por Noxyr desbloquea el formulario de configuración durante 12 horas. Ese es todo el coste: no hay un plan de pago.
Tu propia aplicación: Créala en el Portal para desarrolladores de Discord. No se acepta el token de Noxyr ni un token de usuario.
Dos intents privilegiados: Server Members Intent y Message Content Intent deben estar activados en Bot → Intents de Gateway privilegiados. El panel lo comprueba antes de aceptar el token.
Noxyr en el servidor: Tu bot personalizado funciona con los ajustes y la base de datos de Noxyr, así que Noxyr tiene que seguir en cada servidor al que da servicio.
Administrador: Solo las personas que pueden abrir el servidor en el panel pueden configurar un bot personalizado para él.

Cómo configurarlo

Vota por Noxyr en Top.gg y después abre Bot personalizado en el panel del servidor.
En el Portal para desarrolladores pulsa Nueva aplicación y ponle el nombre que debe tener el bot. En la pestaña Bot configura el avatar y activa los dos intents privilegiados.
Pulsa Restablecer token, cópialo una sola vez y pégalo en la página de Bot personalizado. Se guarda cifrado; solo el sitio web y el nodo que ejecuta tu bot pueden leerlo.
Elige un host (Automático elige el nodo más rápido con espacio libre) y pulsa Start my bot.
Usa el enlace de invitación que te da la página. El bot estará en línea en unos veinte segundos y registrará los comandos de Noxyr con su propio nombre.

Solo la persona que pegó el token puede reemplazarlo después. Los demás administradores del servidor pueden ver el bot, pero no pueden poner un token distinto con tu nombre.

Ventana de voto, periodo de gracia y recordatorios

Un voto mantiene el bot personalizado desbloqueado durante 12 horas, que es también cada cuánto te deja votar Top.gg. Cuando se cierra esa ventana, empieza un periodo de gracia de 74 horas: el bot sigue funcionando, pero la página de Bot personalizado se bloquea hasta que votes de nuevo.

Llega un MD de recordatorio 24 horas después de tu último voto, es decir, 12 horas dentro del periodo de gracia, con una cuenta atrás hasta el corte. Si el periodo de gracia también se agota, el bot se desconecta y sus comandos se eliminan del servidor. No se borra nada: el token, los ajustes y cada ticket, producto y factura se quedan exactamente donde estaban, y un solo voto lo vuelve a activar todo.

Ventana de voto: 12 horas desde el voto. Ambos contadores avanzan en vivo en la página de Bot personalizado.
Periodo de gracia: 74 horas después de que se cierre la ventana. Bot encendido, panel bloqueado.
MD de recordatorio: Se envía una vez por ventana, 24 horas después del voto.
Desactivado: Después del periodo de gracia. Vota de nuevo y el bot se reinicia solo.

Más tiempo sin votar

Los votos no son la única forma de mantener un bot personalizado en marcha. Cada opción de abajo añade horas sobre el tiempo que te quede, así que nada se desperdicia. La página Conseguir más tiempo (Bot personalizado → Conseguir más tiempo) muestra tu cuenta atrás, tu situación en cada opción y cada hora que se te ha acreditado.

Noxyr Rush: Un minijuego de navegador en la web. Consigue 3.000 puntos en una partida y obtén 12 horas. Puedes tener 12 horas de juego acumuladas a la vez; cuando se agoten, puedes volver a ganarlas. Solo ganan tiempo las cuentas que ejecutan un bot personalizado, y el servidor comprueba cada partida.
Invita a un amigo: Comparte tu enlace de referido desde la página Conseguir más tiempo. Cuando tu amigo configure su primer bot personalizado, ambos recibiréis 12 horas. Cuenta una vez por amigo, su cuenta de Discord debe tener al menos 30 días de antigüedad y puedes ganar tiempo con hasta 10 amigos cada 30 días.
Reportes de errores y sugerencias: Envía uno desde el Centro de soporte. Cuando el equipo de Noxyr lo apruebe, recibirás 12 horas, una vez por reporte.
Del equipo: El equipo de Noxyr puede añadir tiempo directamente, por ejemplo después de una caída del servicio.

Si Noxyr se elimina del servidor

Como el bot personalizado depende de la presencia de Noxyr, expulsar a Noxyr detiene el bot personalizado en ese servidor en un minuto aproximadamente. El bot envía un MD a quien eliminó a Noxyr y, si es una persona distinta, también al dueño del bot, con un enlace de invitación.

Vuelve a invitar a Noxyr y el bot personalizado se inicia de nuevo solo. Mientras esté detenido por este motivo, tu ventana de voto se pausa en lugar de gastarse, siempre que ninguno de tus otros bots siga en marcha.

Ceder tu ventana de voto a otra persona

La persona que vota y la persona dueña del bot no tienen que ser la misma cuenta. Desde la página de Bot personalizado puedes ceder tu ventana restante a otro usuario de Discord indicando su ID de usuario: toda, o una cantidad de horas.

El tiempo se suma a lo que ya tenga, así que una transferencia nunca le perjudica. Tú conservas tu periodo de gracia, así que tu propio bot no se detiene a mitad de una conversación. Ambos recibiréis un MD con lo que se movió.

Solo se puede transferir una ventana activa: una vez estás en el periodo de gracia no queda nada que ceder. Las transferencias de menos de cinco minutos se rechazan.

Solución de problemas

"Discord rechazó este token" (código de gateway 4004): El token se restableció en el Portal para desarrolladores, así que el anterior ya no sirve. El bot está apagado hasta que pulses Restablecer token de nuevo y pegues el nuevo en la página de Bot personalizado.
"Discord rechazó la conexión" (código de gateway 4013 / 4014): Se desactivó un intent privilegiado después de la configuración. Vuelve a activar Server Members Intent y Message Content Intent, y después enciende el bot de nuevo desde el panel.
"Vota primero en Top.gg": Tu ventana de voto se ha agotado. Vota y vuelve a intentarlo: la página se desbloquea al instante.
"Ese bot ya es el bot personalizado del servidor de otra persona": Una aplicación solo puede pertenecer a un dueño. Crea una nueva aplicación para ti.
"Ya ejecutas …": Una cuenta, un bot personalizado. Usa también el bot existente en este servidor (la página lo ofrece) o bórralo antes.
Cambiar nodo aparece en gris: Cada cambio exige un nuevo inicio de sesión de Discord, así que hay un enfriamiento de cinco minutos entre cambios.
El estado muestra "suspendido": Se agotaron el voto y el periodo de gracia, o bien Noxyr se eliminó del servidor. El mensaje de estado de la página indica cuál de los dos.