McGuardian

GUÍA TÉCNICA PAPER

Instalar el plugin de moderación McGuardian en Paper

Conecta tu servidor Paper al panel de McGuardian para revisar actividad, gestionar jugadores y coordinar las decisiones de moderación de tu equipo.

Servidor Paper 1.21.xJava 21Red Conexiones salientes HTTPS y WSS por el puerto 443

01 / CONFIGURACIÓN

Pasos para conectar Paper

  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, coloca el archivo .jar de McGuardian en la carpeta plugins/ y vuelve a iniciar el servidor. El archivo del plugin se distribuye por separado; utiliza el que corresponde a tu instalación de McGuardian.

  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 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 / SI NO CONECTA

Comprobaciones rápidas

  • Paper 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.

05 / 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.