Funciones
Flujos
Encaja bloques en el panel que reaccionan a eventos de Minecraft y Discord.
Un flujo empieza con un evento, como «Cuando alguien entra al servidor», seguido de los bloques que deben ejecutarse. Lo construyes en el panel, en «Flujos». Los eventos y acciones de Minecraft necesitan un servidor conectado, consulta Sincronización del chat.
Los flujos todavía están en beta.
Configurar
- En el panel, abre «Flujos».
- Haz clic en «Nuevo flujo» y elige una plantilla o «Empezar en blanco».
- Arrastra un evento arriba y engancha las acciones debajo. Haz clic en un bloque para ver qué hace.
- Rellena los desplegables, como el canal o el servidor.
- Haz clic en «Guardar». Un flujo nuevo está desactivado; actívalo con «Activar».
Tres botones encima del lienzo te ayudan a probarlo:
| Botón | Efecto |
|---|---|
| «Comprobar» | Revisa el flujo sin guardarlo |
| «Simulación» | Guarda y recorre el flujo sin hacer nada de verdad |
| «Ejecutar ahora» | Guarda e inicia el flujo al momento. Escribe los campos del evento en «Valores de prueba». |
«Simulación» y «Ejecutar ahora» solo funcionan mientras el flujo está activado.
«Últimas ejecuciones» muestra cada ejecución con su estado, sus pasos y su registro.
Ejemplo: mensaje de bienvenida
Todo el que entra al servidor de Minecraft recibe un saludo en #welcome.
- Haz clic en «Nuevo flujo» y elige «Mensaje de bienvenida».
- El lienzo muestra «Cuando alguien entra al servidor» con «Mensaje a Discord» debajo. El texto une el jugador «del evento» con « ha entrado al servidor.».
- En «Mensaje a Discord», elige el canal
#welcome. - En el evento, elige el servidor
Survival. Si lo dejas vacío, vale para todos los servidores conectados. - Haz clic en «Guardar» y luego en «Activar».
Cuando Notch entra, #welcome muestra «Notch ha entrado al servidor.».
Disparadores
| Grupo | Eventos |
|---|---|
| Minecraft | «Cuando alguien escribe en Minecraft», «Cuando alguien entra al servidor», «Cuando alguien sale del servidor», «Cuando muere un jugador», «Cuando alguien logra un progreso», «Cuando arranca el servidor de Minecraft», «Cuando se apaga el servidor de Minecraft», «Cuando llega una línea de consola», «Cuando se ejecuta el comando de Minecraft» |
| Discord | «Cuando alguien escribe en Discord», «Cuando alguien entra al servidor de Discord», «Cuando alguien sale del servidor de Discord», «Cuando alguien recibe un rol», «Cuando a alguien se le quita un rol», «Cuando se ejecuta el comando de Discord» |
| Tiempo | «Cada día a las» con hora, zona horaria y días de la semana, «Cada pocos minutos» |
| Manual | «Cuando lo inicio yo», «Cuando llega una petición a la API» |
- Los mensajes de chat, consola y Discord se pueden limitar a una palabra con «contiene» en el evento. El flujo solo se inicia entonces con los mensajes que coinciden.
- «Cuando se ejecuta el comando de Discord» crea un comando de barra en tu servidor de Discord. «Cuando se ejecuta el comando de Minecraft» crea un comando en el servidor de Minecraft y necesita allí MC-Sync 2.2.0 en Spigot, Paper o Folia. Configura los argumentos debajo del lienzo.
- «Cuando llega una petición a la API» muestra una «URL de activación» debajo del lienzo. Al llamarla se inicia el flujo.
Acciones
| Bloque | Efecto |
|---|---|
| «Ejecutar comando de Minecraft» | Ejecuta un comando como si se escribiera en la consola. Que el servidor lo acepte depende de commands.mode. |
| «Escribir en el chat de Minecraft» | Escribe una línea en el chat del juego |
| «Petición HTTP a través del servidor de Minecraft» | Necesita MC-Sync 2.2.0 y http.mode: "allow", consulta Configuración |
| «Mensaje a Discord», «Embed a Discord» | Publica en un canal. Las menciones en el texto no hacen ping; para eso usa el bloque «mención». |
| «Dar rol», «Quitar rol» | Para un miembro, por ID o por nombre |
| «Añadir a la whitelist», «Quitar de la whitelist» | Para un jugador en un servidor |
| «Fijar variable», «Aumentar variable» | Guarda un valor para «este flujo» o para «todo el servidor» |
| «Espera» | Hace una pausa, de hasta 30 segundos cada vez |
| «Escribir en el registro» | Una línea en «Últimas ejecuciones» |
| «Detener el flujo», «Iniciar otro flujo» | Termina este flujo, o inicia otro con los mismos campos del evento |
Condiciones y valores
- Control: «Si» (con y sin «si no»), «Repite», «Repite mientras», «Para cada elemento», «Contar» y «Salir del bucle».
- Valores: «del evento» lee campos como el jugador, el mensaje o el canal. «variable» lee un valor guardado. «jugadores en», «está accesible» y «lista de jugadores de» consultan un servidor de Minecraft.
- Lógica, cálculo, texto, listas: comparaciones, «y», «o», «no», «une», «contiene» y más. El texto se compara sin distinguir mayúsculas y minúsculas.
Permisos y límites
Un flujo necesita el acceso de cada bloque que contiene: «Consola» para comandos de Minecraft, chat y HTTP, «Ajustes» para mensajes a Discord, «Permisos» para roles, «Whitelist» para la whitelist. Si te falta uno, no puedes abrir el flujo.
| Límite | Valor |
|---|---|
| Flujos por servidor de Discord | 30 |
| Duración por ejecución, esperas incluidas | 60 segundos |
| Pasos por ejecución | 10.000 |
| Vueltas por bucle | 1.000 |
| Ejecuciones simultáneas por servidor de Discord | 2, y hasta 50 más en espera |
| Inicios por minuto y servidor de Discord | 60 |
| Variables | 200 por servidor de Discord, 50 por flujo |
Un flujo que falla cinco veces seguidas se desactiva solo. Entonces muestra «Desactivado automáticamente» y el último error.
Problemas
Al guardar aparece «A un bloque le falta un campo obligatorio.»
Hay un desplegable vacío, normalmente el canal o el servidor. Después de una plantilla o una importación, esos campos están vacíos.
El flujo no se ejecuta
- Comprueba en la lista que está «activo». Un flujo nuevo está desactivado, y mientras lo esté, «Simulación» y «Ejecutar ahora» tampoco lo inician.
- Revisa el filtro «contiene» del evento.
- Si «Últimas ejecuciones» dice «no se inició», había demasiados flujos ejecutándose a la vez en el servidor de Discord.
Se rechaza el comando de Minecraft
El servidor de Minecraft solo acepta lo que permiten commands.mode y commands.allow. Por defecto, solo la whitelist. Consulta Configuración.
El flujo se ha desactivado solo
Falló cinco veces seguidas. «Últimas ejecuciones» muestra por qué. Corrígelo y haz clic en «Volver a activar».
Contexto: flujos en el servidor de Minecraft
Los flujos se ejecutan en el bot. Con flows.mode: "on" en la configuración, el servidor de Minecraft ejecuta él mismo los flujos cuyo evento y acciones solo afectan a ese servidor: un evento de Minecraft o de tiempo, exactamente un servidor y nada con Discord, la whitelist ni variables compartidas entre servidores. El bot decide qué flujos cumplen esto al guardarlos. Sus ejecuciones siguen apareciendo en «Últimas ejecuciones».