McGuardian

GUÍA TÉCNICA MINECRAFT JAVA

Instalar McGuardian en tu servidor de Minecraft.

Elige el artefacto adecuado para tu servidor y conéctalo al panel de McGuardian para revisar actividad y coordinar las decisiones de moderación de tu equipo.

Plataformas Bukkit, Fabric, Quilt, Forge y NeoForgeProxies Velocity y BungeeCordRed Conexiones salientes HTTPS y WSS por el puerto 443

01 / CONFIGURACIÓN

Pasos para conectar con Bukkit (Paper/Spigot)

  1. 01

    Registra el servidor en McGuardian

    Entra en tu cuenta, abre Servidores y añade el servidor con un identificador único, por ejemplo survival-1. Emite una credencial para ese servidor y selecciona solo los permisos que vayas a usar.

  2. 02

    Instala el archivo del plugin

    Detén Paper o Spigot, coloca el archivo .jar de McGuardian en la carpeta plugins/ y vuelve a iniciar el servidor. La descarga actual es una versión candidata compatible con Paper 1.21.x y Java 21.

    Descargas

    McGuardian v2.0.0-rc.1

    Candidata

    Selecciona la plataforma y la versión de tu servidor.

    Java 25+Un único JAR Bukkit cubre esta versión.
    Descargar Paper / Spigot SHA-256
  3. 03

    Guarda la configuración y la credencial

    En el asistente de McGuardian, copia la configuración generada en plugins/McGuardian/config.yml. Comprueba que el server-id coincide con el registrado y que server-credential contiene la clave de ese servidor. La clave completa se muestra una sola vez: guárdala como un secreto. 

    api-url: "https://api.mcguardian.win/api/sanctions/analyze"
server-credential: "cgs_…"
server-id: "survival-1"

    Usa los valores que muestra tu asistente. No reutilices una credencial en servidores distintos.

  4. 04

    Reinicia y confirma la conexión

    Reinicia Paper o Spigot para cargar los cambios. Ejecuta /mcguardian status en la consola o en el juego con permiso y comprueba en Servidores que el canal aparece conectado.

02 / PERMISOS DEL PLUGIN

Activa solo las funciones necesarias

La credencial limita qué puede enviar o recibir cada servidor:

  • analysis:writeEnviar mensajes para su análisis de moderación.
  • sanctions:receiveRecibir sanciones que el equipo haya aprobado en el panel.
  • presence:writeActualizar sesiones y perfiles de jugadores.
  • reports:writeRecibir reportes enviados desde el servidor.
  • replays:writeEnviar datos de actividad y replays compatibles.

Para una red con lobby, survival u otros modos, registra cada servidor por separado y emite una credencial distinta para cada uno.

03 / CONTROL Y PRIVACIDAD

Revisa sanciones y datos antes de activar todo

La IA ayuda a revisar el chat; el staff decide qué sanción aplicar. Si está activada la ejecución de sanciones, las acciones aprobadas se envían al plugin. Revisa enforcement.commands en config.yml para confirmar que sus comandos coinciden con tu plugin de sanciones.

El contexto de chat puede enviar mensajes recientes al proveedor de IA. Puedes desactivarlo poniendo enabled: false dentro de la sección context. Los perfiles también pueden enviar la IP del jugador; para desactivar ese envío, cambia a send-ip: false dentro de profiles. Informa a tu comunidad de los datos que registra el servidor.

04 / ACTUALIZAR

Actualizar el plugin

El plugin no se actualiza automáticamente. Cuando haya una versión nueva, descarga el archivo publicado aquí, detén Paper, guarda una copia de plugins/McGuardian/config.yml, sustituye el JAR anterior y vuelve a iniciar el servidor. Revisa las notas de esa versión por si requiere cambios de configuración y confirma la conexión con /mcguardian status. El panel mostrará la versión que se conectó.

La descarga actual está identificada como candidata (RC); comprueba la etiqueta de versión antes de instalarla en producción.

05 / PLATAFORMAS Y VERSIONES

Descarga el archivo para tu servidor

Elige la plataforma y la versión en el selector. Debajo encontrarás el JAR correspondiente y su checksum SHA-256.

Spigot y Paper

Minecraft 1.16.5 o posterior · Java 16+. Usa el JAR Bukkit en plugins/ y configura plugins/McGuardian/config.yml.

Fabric

1.20.1 · Java 17; 1.21.1–1.21.11 · Java 21; 26.1.2 · Java 25. El selector elige el JAR adecuado para cada versión; colócalo en mods/.

Quilt

1.20.1 · Java 17 y 1.21.1 · Java 21. Usa el JAR Fabric correspondiente y añade QFAPI/QSL; no instales Fabric API por separado.

Forge

Minecraft 1.20.1 · Java 17. Coloca el JAR Forge en mods/.

NeoForge

Minecraft 1.21.1 · Java 21. Coloca el JAR NeoForge en mods/.

Proxies

Velocity 3/4 y BungeeCord · Java 17+. Elige el JAR del proxy y colócalo en su carpeta plugins/.

Fabric, Quilt, Forge y NeoForge crean su configuración en config/mcguardian/mcguardian.properties. Bukkit usa plugins/McGuardian/config.yml.

Los adaptadores Fabric, Quilt, Forge y NeoForge ofrecen moderación de chat. Reportes, presencia, sanciones y replays se mantienen en el adaptador Bukkit.

Ir a las descargas de todas las plataformas ↓

06 / SI NO CONECTA

Comprobaciones rápidas

  • Paper o Spigot está iniciado y el plugin aparece cargado en la consola.
  • El identificador y la credencial corresponden al mismo servidor registrado.
  • La credencial conserva los permisos que requiere cada función activada.
  • El hosting permite conexiones salientes HTTPS/WSS por el puerto 443; no hace falta abrir puertos entrantes.

Consulta /mcguardian status y los mensajes de la consola para ver el estado del plugin.

07 / PREGUNTAS

Preguntas frecuentes

¿Tengo que abrir un puerto en mi servidor?

No. El plugin inicia conexiones salientes seguras por HTTPS y WSS en el puerto 443.

¿La IA aplica sanciones automáticamente?

No decide por tu equipo: el staff revisa y aprueba. El plugin ejecuta la acción aprobada si la función está activada y configurada.

¿Puedo conectar varios servidores?

Sí. Registra cada uno en el panel y configura un identificador y credencial únicos por servidor.

¿El plugin se actualiza automáticamente?

No. Descarga la nueva versión desde esta página, reemplaza el JAR y reinicia Paper; conserva una copia de la configuración y revisa las notas de actualización.

¿Puedo usar McGuardian sin Paper?

Sí. Hay artefactos para Spigot, Fabric, Quilt, Forge, NeoForge, Velocity y BungeeCord. Las versiones compatibles y los requisitos aparecen en la sección de plataformas y en el selector de descargas.