Bot de Discord y retransmisión en la nube

Configuración del bot de Discord de Saba-chan y flujo de emparejamiento del relay en la nube, que le permite controlar su servidor sin reenvío de puertos.

Bot de Discord y retransmisión en la nube

El bot de Discord de Saba-chan es un bot oficial que funciona en el servidor relay en la nube. No necesita ejecutar ningún proceso de bot ni gestionar usted mismo un token de Discord. Invite al bot oficial a su servidor de Discord y empareje el bot una vez con un código de la aplicación Saba-chan.


1. Cómo funciona

Nube
DiscordComandos por chat
Relé de DiscordBot de Saba-chan · nube
Tu PC
Daemon de Saba-chanTu PC
Servidor de juegoTu PC
  1. 1
    Daemon de Saba-chanRelé de Discord

    Esperar comandos nuevos (long polling)

  2. 2
    DiscordRelé de Discord

    Enviar un comando /saba … o chat

  3. 3
    Relé de DiscordDaemon de Saba-chan

    Entregar el comando

  4. 4
    Daemon de Saba-chan

    Comprobar permisos

  5. 5
    Daemon de Saba-chanServidor de juego

    Inicio · comando de consola

  6. 6
    Daemon de Saba-chanRelé de Discord

    Enviar el resultado

  7. 7
    Relé de DiscordDiscord

    Responder con el resultado

Tu PC conecta hacia fuera y recoge los comandos, así que no hace falta abrir puertos en el router. Las peticiones se firman con el token emitido al emparejar. Cada 60 segundos el daemon informa al relé de la lista y el estado de los servidores.
  • El bot se ejecuta dentro del servidor relay. En su PC no se instala nada relacionado con el bot.
  • Los servidores de juego se ejecutan en su PC. El demonio de Saba-chan de su PC se conecta hacia fuera al servidor relay mediante long-polling, recoge los comandos y devuelve los resultados.
  • El demonio envía los comandos de juego en el orden stdin (consola del servidor) → REST → RCON. Palworld usa su API REST. RCON solo se usa para un juego que únicamente admite RCON, y solo por loopback (127.0.0.1).
  • El tráfico demonio ↔ relay es únicamente HTTPS saliente desde su PC. No hace falta reenvío de puertos en el router.
  • Saba-chan cantante se gestiona en el lado del relay sin pasar por su PC, así que funciona incluso con el PC apagado.

2. Emparejamiento

El emparejamiento registra un host (el demonio de Saba-chan) y nodos (servidores de Discord) en el servidor relay. Termina con la introducción de un único código.

2.1 Diagrama del flujo

Tu PC
App GUITu PC
Daemon de Saba-chanTu PC
Nube
Relé de DiscordBot de Saba-chan · nube
DiscordComando de barra
  1. 1
    App GUIDaemon de Saba-chan

    Pedir un código de emparejamiento

  2. 2
    Daemon de Saba-chanRelé de Discord

    Solicitar un código

  3. 3
    Relé de DiscordDaemon de Saba-chan

    Código + secreto de sondeo (5 min)

  4. 4
    Daemon de Saba-chanApp GUI

    Mostrar el código

  5. 5
    DiscordRelé de Discord

    /saba connect code:…

  6. 6
    Relé de Discord

    Registrar el PC · emitir token de nodo

  7. 7
    App GUIDaemon de Saba-chan

    Comprobar el estado cada 3 s

  8. 8
    Daemon de Saba-chanRelé de Discord

    Comprobar el estado (con el secreto)

  9. 9
    Relé de DiscordDaemon de Saba-chan

    Conectado + token de nodo (una sola vez)

  10. 10
    Daemon de Saba-chan

    Guardar el token · iniciar la conexión al relé

  11. 11
    Daemon de Saba-chanApp GUI

    Mostrar «conectado»

Aunque alguien vea el código, sin el secreto de sondeo no puede obtener el token. El token se entrega una sola vez y lo guarda el daemon, no la GUI. Para emparejar en un servidor de Discord hace falta el permiso «Gestionar servidor».
  • El código de emparejamiento tiene 32 caracteres y pollSecret tiene 48. El código es válido durante 5 minutos.
  • El token se devuelve una sola vez (intercambio atómico). Es el demonio, no la GUI, quien lo guarda en .node_token en cuanto llega y quien inicia la conexión con el relay. La app solo entrega el secreto de sondeo al demonio de tu PC, y el demonio lo envía al relay en una cabecera, nunca en la URL.
  • Aunque alguien vea su código de emparejamiento, no puede interceptar el token sin el pollSecret.
  • Puede conectar varios PC a una cuenta de Discord. Si conecta desde una cuenta que ya tiene un PC, aparecen los botones Conectar como PC nuevo y Reconectar para sus PC anteriores. Al reconectar un PC, su token anterior deja de valer. Un servidor de Discord también puede tener PC de varias personas (Discord).

2.2 Pasos en la aplicación

  1. En la aplicación Saba-chan, abra Discord → Conexión y haga clic en Conectar un servidor de Discord.
  2. Si el bot oficial de Saba-chan todavía no está en su servidor de Discord, invítelo primero con Invitar al bot.
  3. La pantalla muestra un código de conexión y el comando que hay que escribir. Haga clic en Copiar e introdúzcalo en un canal de Discord como /saba connect code:<código> (la aplicación puede mostrar el nombre coreano /사바쨩 연결 코드:<código>; es el mismo comando).
  4. Solo los miembros con el permiso Gestionar servidor en ese servidor de Discord pueden ejecutar este comando. Si lo envía en un mensaje directo al bot, conecta solo el PC a su cuenta, sin servidor de Discord.
  5. Si es una cuenta de Discord que usa Saba-chan por primera vez, el bot le guía primero en el registro. Con Registrarse confirma los términos en el sitio web y se registra, y esa respuesta pasa a ser la confirmación de la conexión. Hasta que acepte, no se conecta ningún PC.
  6. Cuando el bot muestre un botón que pregunta si desea conectar, pulse Conectar. Si introduce un código que le dio otra persona, el PC de esa persona se conecta a su cuenta, así que pulse el botón solo si el código lo obtuvo directamente en la aplicación Saba-chan.
  7. La aplicación comprueba el estado cada 3 segundos a través del demonio y cambia a «Conectado» en cuanto el demonio ha guardado .node_token.

Una vez emparejado, el demonio mantiene automáticamente una conexión long-poll con el servidor relay. Si desactiva el interruptor Retransmisión de comandos en la aplicación, su PC deja de recibir comandos de Discord y el bot no responderá.

2.3 Conectar otro servidor de Discord sin código

Si su cuenta de Discord ya está emparejada, puede ejecutar simplemente /saba connect (sin código) en otro servidor de Discord.

  • El bot conecta de inmediato a ese servidor de Discord todos los PC vinculados a su cuenta. No hace falta aceptar nada en el PC ni elegir un PC.
  • Si es una cuenta que lo usa por primera vez, primero se registra. Al registrarse, ese servidor de Discord también queda registrado en Saba-chan y, si no hay ningún PC conectado, se queda como servidor sin PC (§2.5). Si la cuenta ya está registrada pero no tiene PC, el bot le indicará que se conecte con un código de emparejamiento.
  • Un servidor de Discord conectado así no muestra ningún servidor de juego al principio. Elija en la aplicación Saba-chan de su PC los servidores que se usarán en ese servidor de Discord.
  • Un servidor de Discord conectado con un código de emparejamiento sigue el ajuste Abrir de inmediato mis servidores en los servidores de Discord nuevos de la pantalla de conexión de Discord de la aplicación. Si está activado, todos los servidores se ven de inmediato; si no, los elige usted.
  • Igual que con un código, necesita el permiso Gestionar servidor. Si ya hay otro PC conectado a ese servidor de Discord, no se lo quita: añade su PC junto al otro.

2.4 Desemparejar

  • Haga clic en Desconectar en la aplicación → el demonio detiene la retransmisión de comandos y elimina .node_token. Este PC se desconecta de todos los servidores de Discord.
  • Para desvincular un solo servidor de Discord, ejecute /saba disconnect en ese servidor. Solo puede usarlo quien lo conectó o el propietario del servidor de Discord, y también se eliminan las asignaciones de canales de ese servidor.

2.5 Servidores de Discord sin PC

Quien no ha instalado la aplicación Saba-chan también puede invitar al bot y usar Saba-chan cantante, Saba-chan parlante, Saba-chan lectora, los comandos de gestión del servidor y las estadísticas de juegos.

  • Los ajustes se guardan en el relay. El propietario del servidor de Discord o quien tenga el permiso Gestionar servidor cambia el idioma, la asignación de canales de Saba-chan parlante y Saba-chan cantante, la ampliación de emojis, los ajustes de Saba-chan parlante y los de Saba-chan lectora. Se hace con los comandos /saba de Discord o en Saba-chan web, y se registra la primera vez que cambia algo.
  • No hay niveles de Saba-chan (escalera de permisos) ni comandos de servidores de juego. Los canales de avisos, chat del juego y panel de estado los alimenta el PC, así que no se pueden asignar.
  • Si más tarde conecta un PC, hereda los ajustes tal cual y, desde entonces, el original de los ajustes es ese PC.
  • Usar Saba-chan cantante o charlar como miembro normal no requiere registro.

3. Slash commands del bot

Estos son los comandos bajo el comando raíz del bot oficial. En los clientes de Discord configurados en un idioma distinto del coreano, la raíz aparece como /saba con nombres de subcomandos en inglés; en coreano es /사바쨩. En un servidor de Discord sin PC conectado solo se ven connect, assign, language, settings, reading, web, big-emoji y help, y los usa el propietario del servidor de Discord o quien tenga el permiso Gestionar servidor en lugar del «propietario del nodo». Los demás slash commands (/tts, stats, clear, etc.) están en Comandos.

ComandoQuiénAcción
/saba statusCualquieraMuestra el estado del PC conectado a este servidor y de cada servidor de juego (CPU, RAM)
/saba connect [code]Permiso Gestionar servidorConectar con un código de emparejamiento. Deje el código vacío para conectar a este servidor todos los PC de su cuenta (§2.3). Si es la primera vez, primero se registra
/saba disconnectQuien conectó o propietario del servidorDesconecta este servidor de su PC
/saba permission <level> [user]Propietario del nodoSi elige un usuario, le da ese nivel de comandos (Revocar en la lista de niveles borra el nivel propio y lo devuelve al nivel predeterminado); si lo deja vacío, fija el nivel predeterminado de los miembros sin nivel propio (User al principio). La lista de niveles es la escalera de permisos de este servidor
Clic derecho en un miembro → Apps → Cambiar nivel de Saba-chanPropietario del nodoElige en una lista el nivel de comandos de ese miembro (también hay Revocar). Hace lo mismo que /saba permission. El menú solo lo ven quienes tienen el permiso Gestionar servidor
/saba sleepPropietario del nodoPone el bot en reposo en este servidor (ignora todos los mensajes)
/saba wakePropietario del nodoDespierta al bot
/saba assign kind:<Saba-chan parlante|Saba-chan cantante|Avisos|Chat del juego|Status board>Propietario del nodo o del servidorAsigna este canal como canal de Saba-chan parlante (varios, hasta 20; Saba-chan parlante solo habla allí), canal de Saba-chan cantante (uno; los mensajes normales se eliminan, por lo que pide confirmación), canal de avisos (uno; avisos de fallo del servidor, actualización, copia de seguridad y reinicio programado, además de un botón Reiniciar en los avisos de fallo), canal de chat del juego (uno; reenvía el chat dentro del servidor de juego) o canal de panel de estado (uno; una tarjeta de estado por cada servidor en marcha). Más detalles en las funciones de canal de Comandos. Un canal solo tiene un tipo; ejecutar de nuevo el mismo tipo lo quita. También se puede cambiar en la pestaña Gestión del servidor, en Asignación de Saba-chan, del servidor de Discord de la aplicación
/saba language <language>Propietario del nodoIdioma en el que responde el bot en este servidor (Auto = seguir el idioma de la aplicación vinculada)
/saba readingPropietario del nodoAjustes de volumen, velocidad y tono de Saba-chan lectora de este servidor, y de si dice los nombres. Solo usted lo ve
/saba big-emoji state:<On|Off>Propietario del nodo o del servidorConvierte en imagen grande un mensaje que solo contiene un emoji personalizado (desactivado por defecto)
/saba webCualquiera (su cuenta)Enlace de un solo uso (5 minutos) a Saba-chan web. Si tiene PC, también ese PC; si no, solo los ajustes de los servidores de Discord que administra. Solo usted lo ve
/saba settingsPropietario del nodoCambia los ajustes de Saba-chan parlante de este servidor (activado/desactivado, intervenir, memoria, moderación con IA, pasos de confirmación antes de ejecutar, herramientas por categoría, palabras de activación). Las herramientas bloqueadas en la aplicación como herramientas permitidas globalmente no se pueden activar. Solo usted lo ve
/saba helpCualquieraMuestra cómo usar Saba-chan y la lista de comandos (solo usted puede verlo)
/mysaba webCualquiera (su cuenta)Igual que /saba web. Funciona en cualquier servidor y en mensajes directos
/mysaba my-pcsCualquiera (sus PC)Lista los PC conectados a su cuenta de Discord, para renombrarlos o quitarlos (solo usted lo ve)
/mysaba agentCualquiera (su cuenta)Ver y desconectar los agentes de IA (MCP remoto) conectados a su cuenta de Discord. Si no hay ninguno, muestra la dirección que hay que poner en el agente. Funciona en mensajes directos; solo usted lo ve (Conectar un agente de IA)
/saba updateQuien conectó el PCBusca actualizaciones de Saba-chan en el PC conectado a este servidor y las aplica al pulsar el botón de confirmación

/mysaba son comandos sobre su cuenta, así que no aparecen en la lista de miembros del servidor. Si tras conectar el PC instala Saba-chan en su cuenta de Discord con el botón Instalar en mi cuenta que muestra el bot, los verá en cualquier servidor o mensaje directo, y solo usted. En el mensaje directo con el bot funcionan sin instalar, como /saba web, /saba my-pcs y /saba agent.

En un servidor de Discord con PC conectado, el original de los ajustes de permisos, reposo, idioma, Saba-chan cantante y Saba-chan lectora es la configuración de Saba-chan en su PC, así que estos comandos surten efecto mientras el PC está encendido (los servidores sin PC, §2.5). Los mismos ajustes pueden cambiarse en la pantalla del servidor de Discord de la aplicación. Los permisos están en las pantallas Comandos por nivel y Nivel por miembro, que se abren al pulsar un servidor en la pestaña Instancias; Saba-chan cantante y Saba-chan lectora tienen cada una su pestaña; el idioma, el prefijo y el aspecto de los slash commands están en la pestaña Ajustes del bot. Poner en reposo todos los servidores de Discord a la vez se hace en Discord → Conexión.

3.1 Slash commands por servidor y menú de acciones

Tras el emparejamiento, el bot registra comandos adicionales en cada servidor de Discord.

  • /<nombre del servidor> command:<comando> arg1:… arg2:…: un comando por instancia de servidor de juego. La lista de comandos de Discord muestra una sola línea por servidor. Al pulsar el campo command aparece una lista con los comandos que se pueden usar en ese servidor (iniciar, detener, estado, acciones y comandos del módulo), y al escribir se filtra por nombre. Los campos de argumentos muestran, según el comando elegido, una lista de opciones, sí/no, un rango numérico o una indicación de entrada.
  • De la lista se excluyen los comandos que su nivel no permite usar y los que no encajan con el estado actual del servidor (iniciar en un servidor encendido, detener en uno apagado), y los que usó hace poco en ese servidor salen primero. Si realmente se puede usar lo vuelve a decidir la aplicación Saba-chan.
  • Acciones: las acciones que la aplicación Saba-chan abre a Discord (reiniciar, copia de seguridad, etc.) también están en la misma lista de comandos. Las acciones que requieren confirmación según el ajuste de repreguntas (§5) muestran lo que va a cambiar y quien la pidió debe pulsar el botón de ejecutar. Las actualizaciones de la app Saba-chan no están en el menú de tareas; use /saba update.
  • Jugadores: los servidores cuyo juego lo admite tienen un comando jugadores en la lista que muestra cuántas personas hay conectadas y sus nombres.
  • Restaurar copia de seguridad: elija la copia en una lista (al escribir se filtra). Si el servidor está encendido, el bot pregunta primero; Detener y continuar detiene el servidor y luego restaura. Restaurar es una acción peligrosa, así que pide confirmación una vez más. Solo quien lo pidió puede pulsar los botones.
  • Aviso de listo: cuando inicia o reinicia un servidor con su comando /<nombre del servidor>, el botón Reiniciar de un aviso o Saba-chan parlante, el mismo canal recibe un aviso cuando ya acepta jugadores. Si no llega a encenderse, recibe el motivo en una línea.
  • Solo aparecen las instancias permitidas para ese servidor (pestaña Instancias de la pantalla del servidor de Discord de la aplicación).

4. Comandos de chat (prefijo)

Una vez emparejado, puede manejar los servidores desde los canales de texto de Discord con comandos basados en un prefijo.

Saba-chan <servidor> <comando> [args…]

El prefijo predeterminado es Saba-chan. Puede cambiarlo o añadir otros para cada servidor de Discord en el servidor de Discord de la aplicación → pestaña Ajustes del bot, en Prefijo de comandos.

<servidor> puede ser un nombre de instancia, un alias de servidor, o un nombre o alias de módulo. Comandos comunes a todos los módulos:

ComandoDescripción
startInicia el servidor. Ejemplo: Saba-chan minecraft start
stopDetiene el servidor
statusConsulta el estado

Las palabras con que se llama a los servidores y a los comandos se definen en la pantalla del servidor de la aplicación → pestaña Discord. Consulte el documento Comandos para la lista completa de comandos.


5. Niveles de permiso

Los niveles son Propietario (3) > Admin (2) > Usuario (1) > Saba-chan parlante (0) > Bloqueado (-1). Los niveles son acumulativos: un nivel superior puede usar todos los comandos que puede usar uno inferior.

  • El Propietario es quien conectó el servidor (el propietario del nodo). Puede usar todos los comandos y no puede ser degradado.
  • Cada comando tiene un riesgo (Seguro, Precaución, Peligroso). Con el preajuste predeterminado, los niveles necesarios son Seguro = Saba-chan parlante, Precaución = Usuario, Peligroso = Admin. En el servidor de Discord de la aplicación, pulse un servidor en la pestaña Instancias: en la escalera Comandos por nivel puede elegir el preajuste (Flexible, Predeterminado, Estricto) o mover las fichas de comandos a otro nivel. El nivel de los miembros y el nivel predeterminado se fijan en Nivel por miembro, en el mismo sitio, y se aplican a la vez a todos los servidores de ese servidor de Discord.
  • La ayuda y las listas las puede usar cualquiera que no esté bloqueado. Los miembros Bloqueados no pueden usar ninguna función del bot, incluidas Saba-chan cantante y Saba-chan parlante.
  • Las solicitudes que pasan por Saba-chan parlante no pueden superar el Límite de Saba-chan parlante (nivel Saba-chan parlante por defecto).

Repreguntas: si se pregunta con un botón de confirmación a quien lo pide antes de ejecutar se decide en la tarjeta Repreguntas de la pestaña Ajustes del bot del servidor de Discord de la aplicación (o con saba-chan-cli bot confirm). En las peticiones hechas directamente al bot (prefijo y slash commands) por defecto solo se pregunta en los comandos peligrosos; Saba-chan parlante pregunta por defecto en todos los comandos. En ambos casos se elige entre todos los comandos, precaución o superior, solo los peligrosos y no preguntar. El nivel de riesgo que se usa para repreguntar se puede cambiar por comando en la ventana de edición de fichas de la pantalla de permisos (no cambia el nivel necesario). Las acciones de administración que elige Saba-chan parlante se preguntan siempre, sea cual sea el ajuste. Solo quien lo pidió puede pulsar el botón de confirmación.


6. Funciones de música

La reproducción de música la gestiona el servidor de música oficial (music-server) que funciona junto al servidor relay.

  • Cuando ejecuta un comando como Saba-chan play …, el bot lo pasa al servidor de música, que transmite el audio al canal de voz de Discord.
  • No necesita instalar ffmpeg/yt-dlp en su PC.
  • Los comandos de música funcionan en cualquier canal. Si define un canal de Saba-chan cantante con /saba assign kind:Saba-chan cantante, allí puede escribir comandos sin el prefijo (o solo un término de búsqueda), y se muestra una pantalla de reproductor.
  • Saba-chan cantante está activada por defecto; desactívela en el servidor de Discord de la aplicación → pestaña Saba-chan cantante. En los servidores donde está activada existe el slash command /music (Comandos, Saba-chan cantante).

7. Saba-chan parlante (chat con IA)

  • Saba-chan parlante solo funciona después de registrar una clave de API en la aplicación y activarla en cada servidor de Discord (pestaña Saba-chan parlante de la pantalla del servidor de Discord o /saba settings; en un servidor nuevo está desactivada). La clave solo la conocen su PC y el relay; nunca se muestra en Discord.
  • Las herramientas que puede usar (manejar servidores de juego, búsqueda web, estadísticas de LoL, TFT y PUBG, personajes de MapleStory, búsqueda en varios juegos, información cotidiana, generación de imágenes) también se activan en cada servidor de Discord. Las herramientas bloqueadas en el menú común de la aplicación como herramientas permitidas globalmente no se usan en ningún servidor. Si no activa las herramientas de servidores de juego, no toca los servidores.
  • Saba-chan parlante solo habla en los canales asignados con /saba assign kind:Saba-chan parlante. En otros canales no responde aunque se le llame.
  • Saba-chan parlante solo puede usar las acciones que un módulo o una extensión le abren. Todo lo demás se rechaza.
  • Las consultas se ejecutan al momento. Las acciones que cambian algo se convierten primero en un plan y pasan por un botón de confirmación según el nivel de repreguntas (§5; al principio, todos los comandos). Las acciones de administración siempre pasan por el botón de confirmación. Solo quien lo pidió puede pulsar el botón.
  • Lo que ejecuta nunca supera el límite de Saba-chan parlante (§5).
  • Con Saba-chan parlante activada, un comando de chat que el demonio no reconoce se convierte en un comando exacto mediante Saba-chan parlante y se intenta una vez más.
  • Pregunte a Saba-chan parlante por los registros y leerá los registros del servidor, incluidas ejecuciones anteriores. Si pide el registro como archivo, adjunta un .log sin pasarlo por la IA (hasta 4 MiB, se conserva lo más reciente; IP, secretos y rutas ocultos).

8. Modelo de seguridad

  • El demonio envía el token de nodo obtenido en el emparejamiento (sbn_{hostId}.{secret}) en la cabecera Authorization: Bearer por HTTPS. El relay compara ese token con su hash Argon2 guardado.
  • El servidor relay nunca almacena el token en sí; lo compara con un hash Argon2.
  • El demonio no acepta conexiones entrantes. Las contraseñas de los servidores de juego no se envían al relay.

9. Resolución de problemas

SíntomaCausa / Solución
El bot no respondeCompruebe el prefijo (por defecto Saba-chan) y que haya un espacio después. El bot debe estar en el servidor, el emparejamiento debe estar completo y Retransmisión de comandos debe estar activada en la aplicación. Compruebe también que el bot no se haya puesto en reposo con /saba sleep
Saba-chan … start → servidor no encontradoLa primera palabra es el servidor (nombre/alias de instancia o nombre/alias de módulo) y la segunda es el comando. Si tiene varios servidores del mismo juego, use el nombre de instancia o un alias de servidor
El código de emparejamiento caducóEl código es válido durante 5 minutos y ese tiempo ya pasó. Obtenga un código nuevo en la aplicación
La aplicación se queda esperandoCompruebe que realmente se ejecutó el slash command /saba connect y que tiene el permiso Gestionar servidor
Los comandos de Discord no llegan al PCSi al emparejar desde otro sitio elige este PC con Reconectar, la conexión anterior de este PC se corta. Vuelva a emparejar este PC

Para flujos de resolución más detallados, consulte el documento Resolución de problemas.