Funciones

Sincronización del chat

Envía el chat de Minecraft a un canal de Discord y los mensajes del canal de vuelta al juego.

La sincronización del chat conecta un canal de Discord con el chat de tu servidor de Minecraft. Para ello, el plugin o el mod de MC-Sync se ejecuta en el servidor. No necesitas abrir ningún puerto.

Configurar

Descarga el archivo para tu servidor desde la página de descargas.
Colócalo en la carpeta plugins (Spigot, Paper, Folia) o en la carpeta mods (Fabric, Quilt, Forge, NeoForge) e inicia el servidor. Así se crea la configuración.
Conecta el servidor con un canal de Discord:

En el panel, abre «Servidores» y después tu servidor. Si no está, añádelo con «Añadir un servidor».
Abre la pestaña «Conexión y chat».
Elige el canal de chat.
Acepta las condiciones y haz clic en «Conectar y crear token».

Ejecuta /server add name: Survival channel: #minecraft. Si el servidor ya está en la lista, usa /server connect server: Survival channel: #minecraft.
Haz clic en «Aceptar y conectar». El bot muestra el token una sola vez y solo a ti.

Pon el token en la configuración y reinicia el servidor.

yaml

# Spigot, Paper, Folia: plugins/mc-sync/config.yml
api:
  token: "tu-token"

properties

# Fabric, Quilt, Forge, NeoForge: config/mc-sync.properties
api.token=tu-token

Escribe un mensaje en el juego. Aparece en el canal de Discord al cabo de unos segundos.

Si no aparece, consulta Problemas.

Ajustes

En el panel, los interruptores están en «Conexión y chat». En Discord los ajustas con /server chat.

Panel	`/server chat`	Efecto
Activa	`active`	Desactiva la sincronización del chat. El canal y el token se mantienen.
Chat	`chat-messages`	Mensajes de chat en los dos sentidos
Entradas y salidas	`join-leave-messages`	Publica cuando alguien entra o sale del servidor
Muertes	`death-messages`	Mensajes de muerte del juego
Progresos	`advancements`	Progresos, a partir de Minecraft 1.12
	`language`	Idioma de los mensajes que escribe el propio bot
	`channel`	Lleva el chat a otro canal

/server chat server: Survival death-messages: False

Solo en el panel:

Formato del chat: mensajes como el jugador, con cabeza y nombre, como embed o como línea sencilla. Tus propias plantillas para entrada, salida, muerte y progreso, y un filtro de palabras.
Token: una fecha de caducidad y un periodo de gracia al renovarlo, durante el cual el token anterior sigue funcionando.
Historial del chat: los últimos mensajes del canal, cargados directamente desde Discord.

El inicio, la parada, las caídas y el informe semanal se configuran en Avisos.

Comandos en el juego

Comando	Efecto
`/mcsync status`	Muestra si la conexión funciona, qué comandos acepta el servidor y si hay una actualización
`/mcsync reload`	Vuelve a leer la configuración. El token y algunos ajustes siguen necesitando un reinicio.
`/mcsync toggle`	Oculta el chat de Discord solo para ti
`/mcsync link <code>`	Vincula tu cuenta de Minecraft con Discord, consulta Vincular cuentas

status y reload necesitan el permiso mcsync.admin. En Fabric, Quilt, Forge y NeoForge puede usarlos quien pueda usar /kick. toggle y link los puede usar cualquiera.

Desconectar

Panel: «Conexión y chat» → «Desconectar».
Discord: /server disconnect server: Survival.

El token deja de funcionar. El servidor se queda en la lista con su dirección y su página pública. /server remove borra también el servidor.

Problemas

El plugin no se comunica con el bot

Comprueba que el token está completo en la configuración, sin espacios.
Reinicia el servidor después de añadirlo. /mcsync reload no basta para el token.
El servidor tiene que poder llegar a api.mc-sync.eu por HTTPS. Algunos proveedores bloquean las conexiones salientes; pregunta al tuyo.

Los mensajes de Discord no aparecen en el juego

Comprueba que el interruptor «Chat» está activado.
El bot tiene que poder ver el canal («Ver canal»).
Si un jugador usó /mcsync toggle, solo él deja de ver el chat de Discord.

Los mensajes aparecen como embed en lugar de con la cabeza del jugador

Para publicar como el jugador, el bot necesita «Gestionar webhooks» en el canal. Sin ese permiso publica un embed. Concédeselo en los ajustes de Discord del canal, en «Permisos».

El canal no está en la lista

Un canal solo puede pertenecer a un servidor. Los canales que ya se usan para otra cosa no se ofrecen.

`/mcsync` no existe

En Forge anterior a Minecraft 1.19, el mod no tiene el comando. Puedes ver si la conexión funciona en el panel, en «Conexión y chat».

Contexto: cómo llega el chat sin un puerto abierto

El propio servidor de Minecraft abre una conexión HTTPS saliente hacia el bot y la mantiene abierta. Los mensajes de Discord llegan por esa conexión. Si se corta, el servidor vuelve a intentarlo cada segundo hasta que se restablece.

Mientras no se puede llegar a Discord, el chat, las entradas y las muertes esperan en el disco del servidor: en plugins/mc-sync/queue/ o config/mc-sync-queue/. También sobreviven a un reinicio. Cuánto tiempo esperan se fija en la configuración en queue.*.