Referencia

Configuración

Todos los ajustes del plugin y del mod MC-Sync, con su valor por defecto y lo que hacen.

El archivo se crea la primera vez que arranca el servidor. El plugin y el mod comparten los mismos ajustes en dos notaciones: api: → token: en YAML es api.token= en el archivo properties. Dos ajustes solo existen en Spigot, Paper y Folia.

Servidor	Archivo
Spigot, Paper, Folia	`plugins/mc-sync/config.yml`
Fabric, Quilt, Forge, NeoForge	`config/mc-sync.properties`

yaml

# plugins/mc-sync/config.yml
commands:
  mode: allow
  allow: ["say", "lp user * parent add"]

properties

# config/mc-sync.properties
commands.mode=allow
commands.allow=say,lp user * parent add

Las listas van entre corchetes en YAML y separadas por comas en el archivo properties. En YAML, pon "off" y "on" entre comillas.

Recargar o reiniciar

/mcsync reload vuelve a leer el archivo. Estos ajustes se aplican al momento:

commands.mode, commands.allow y commands.consoleFallback
performance.report, error.report y dev.mode

Estos necesitan un reinicio:

api.token
queue.*, update.mode, console.live, http.mode, http.allow y flows.mode
flowCommands.enabled. Tras una recarga solo se aplica cuando los comandos cambian en el panel.

Si a un archivo antiguo le falta un ajuste, MC-Sync lo añade con su valor por defecto al arrancar y con /mcsync reload. Los valores existentes se quedan como están, y el archivo antiguo se guarda al lado como config.yml.bak-… o mc-sync.properties.bak-….

api

Clave	Por defecto	Efecto
`api.token`	`YOUR_API_TOKEN`	El token del panel o de `/server add`. El marcador de posición cuenta como vacío.

En Fabric, Quilt, Forge y NeoForge, el mod lee el token de la variable de entorno MC_SYNC_TOKEN cuando el archivo no tiene ninguno. Cómo conseguir un token se explica en Sincronización del chat.

queue

Mientras no se puede contactar con Discord, el chat, las entradas y las muertes esperan en disco: en plugins/mc-sync/queue/ o en config/mc-sync-queue/. Sobreviven a un reinicio y después se envían en su orden original.

Clave	Por defecto	Efecto
`queue.maxAgeMinutes`	`60`	Cuánto tiempo espera un evento, en minutos. De 1 a 1440. Los más antiguos se descartan.
`queue.maxEvents`	`10000`	Cuántos eventos esperan como máximo. A partir de ahí se descartan los más antiguos. Como máximo 100000.
`queue.maxSizeMb`	`10`	Cuánto espacio en disco ocupan los eventos en espera, en MB. A partir de ahí se descartan los más antiguos. Como máximo 1024.

Un valor por encima del límite cuenta como el límite. 0, un valor vacío o un texto cuentan como el valor por defecto.

update

Clave	Por defecto	Efecto
`update.mode`	`notify`	`notify` avisa de una versión nueva en el registro del servidor y en `/mcsync status`. `off` desactiva la comprobación.

Solo se tienen en cuenta versiones para la versión de Minecraft del servidor. MC-Sync nunca descarga nada por su cuenta; tú sustituyes el archivo a mano.

commands

Qué comandos acepta el servidor de Minecraft desde Discord, el panel y los flujos. Quién puede enviar comandos desde Discord se fija allí, consulta Comandos desde Discord.

Clave	Por defecto	Efecto
`commands.mode`	`whitelist`	`off`: ningún comando. `whitelist`: solo `whitelist add`, `whitelist remove` y `whitelist list`. `allow`: la whitelist más todo lo que esté en `commands.allow`. `all`: cualquier comando.
`commands.allow`	vacío	Comandos adicionales para `allow`. Una entrada coincide con el principio del comando, palabra por palabra. `*` equivale exactamente a una palabra.
`commands.consoleFallback`	`false`	Solo Spigot, Paper, Folia. Si un comando de un plugin rechaza la consola que MC-Sync usa para capturar la salida, `true` lo ejecuta otra vez en la consola real, sin salida. Puede ejecutarse entonces dos veces.

Con lp user * parent add, lp user Notch parent add vip funciona y lp user Notch parent remove vip no.

console

Clave	Por defecto	Efecto
`console.live`	`true`	Los administradores del servidor de Discord conectado pueden ver la consola en directo en el panel, consulta Consola. Puede contener direcciones IP de jugadores.

performance

Clave	Por defecto	Efecto
`performance.report`	`true`	Envía una vez por minuto TPS, MSPT, memoria, chunks, entidades y tiempo en marcha. Con eso se alimentan el gráfico del panel y el aviso de TPS bajos.

error

Clave	Por defecto	Efecto
`error.report`	`true`	Informa a sus desarrolladores de fallos del propio MC-Sync: el error, dónde ocurrió, el loader y las versiones. Los problemas de red y de configuración nunca se informan. No se envían nombres de jugadores, chat ni direcciones IP.

dev

Clave	Por defecto	Efecto
`dev.mode`	`false`	Escribe en detalle cada petición al bot en el registro del servidor. Con `false`, solo los errores.

http

Peticiones HTTPS salientes de los flujos, con el bloque «Petición HTTP a través del servidor de Minecraft».

Clave	Por defecto	Efecto
`http.mode`	`off`	`off`: ninguna petición. `allow`: solo a los hosts de `http.allow`.
`http.allow`	vacío	Hosts permitidos, como `api.example.com`. Un host incluye también sus subdominios.

Las direcciones privadas y locales siempre están bloqueadas, aunque un host de http.allow apunte a una. Solo se permite https://.

flowCommands

Clave	Por defecto	Efecto
`flowCommands.enabled`	`true`	Solo Spigot, Paper, Folia. Los flujos pueden crear sus propios comandos en el servidor. Lo que ejecutan esos comandos se sigue comprobando con `commands.mode`.

Si el nombre ya está ocupado, por ejemplo online, llegas al comando como /mcsync:online.

flows

Clave	Por defecto	Efecto
`flows.mode`	`off`	`off`: los flujos se ejecutan en el bot. `on`: los flujos que solo afectan a este servidor se ejecutan en el propio servidor.

commands.mode y http.mode siguen aplicándose. Qué flujos cumplen las condiciones se explica en Flujos.