Instalación y primeros pasos

Descarga #

Antes de instalar, revisá los requisitos: Paper o Spigot 1.21 – 1.21.x o 26.1 – 26.3, y Java 21 o superior. Folia no es compatible.

Instalar #

1. Poné ChatShield-1.0.0.jar en la carpeta plugins/ de tu servidor.

2. Reiniciá el servidor. No uses /reload.

3. Mirá la consola. En cada arranque, ChatShield muestra su banner y una línea como esta:

   ChatShield v1.0.0 | Paper 1.21.11 | panel http://127.0.0.1:8765 | lang en | Free

El primer arranque también crea plugins/ChatShield/config.yml. Desde ese momento el chat se captura y se analiza; no hay base de datos ni servidor web que instalar.

Los comandos de esta guía están escritos para el juego, con barra (/chatshield status). En la consola del servidor, escribilos sin la barra (chatshield status). El alias corto /cs funciona en lugar de /chatshield (/cs status).

Primeros pasos #

1. Eximite y permití tus propios enlaces #

Normalmente tu propia cuenta no debería generar casos, y tu propio sitio web y tu invitación de Discord nunca deberían contar como publicidad.

• Eximí tu cuenta: /chatshield exempt add <your name>. Esto edita exempt.players en config.yml y lo recarga por vos.

• Poné el sitio web y la invitación de Discord de tu comunidad en advertising.allowed de config.yml, y después corré /chatshield reload:

  advertising:
    allowed: [myserver.net, discord.gg/abc123]

2. Entrá al panel #

Como operador (los operadores tienen chatshield.admin, que permite todos los comandos y todas las secciones del panel), podés:

• correr /chatshield panel en el juego: recibís un enlace de acceso clickeable, que vale 10 minutos y se puede usar una sola vez. Es la forma más segura de entrar, porque no se escribe ninguna contraseña en el chat; o
• definir una contraseña del panel con /chatshield password <at least 8 characters> y después ingresar con tu nombre de Minecraft y esa contraseña. El plugin deja esta línea fuera del log del servidor, pero otros plugins (un espía de comandos, por ejemplo) igual pueden verla.

3. Abrí el panel #

El panel escucha en http://127.0.0.1:8765, o sea que solo responde en la propia máquina del servidor. Abrí esa dirección en un navegador ahí e ingresá con tu nombre de Minecraft.

Para llegar al panel desde tu propia computadora:

• Para un vistazo rápido, usá un túnel SSH: ssh -L 8765:127.0.0.1:8765 user@your-server, y después abrí http://127.0.0.1:8765/ en tu computadora.
• Para el uso diario, poné el panel detrás de un proxy inverso con HTTPS (recomendado), o activá el HTTPS integrado del plugin. Mirá la guía del panel.

4. Dale acceso a tu staff #

1. Dale chatshield.panel a cada miembro del staff que tenga que ingresar. Permite /chatshield panel y /chatshield password.

2. Poné sus grupos de LuckPerms o Vault en access.groups de config.yml, con lo que puede ver cada grupo. En Free solo cuentan los dos primeros grupos de la lista.

   access:
     groups:
       owner: { violations: [all], punishments: true, logs: true, analytics: true, settings: true, users: true, ai: true }
       admin: { violations: [all], punishments: true, logs: true, analytics: true, settings: false, users: false, ai: true }

3. Dale chatshield.alerts al staff que tenga que recibir alertas en el juego.

4. Corré /chatshield reload.

Con LuckPerms, desde la consola:

lp group mod permission set chatshield.panel true
lp group mod permission set chatshield.alerts true

También podés crear cuentas vos mismo con /chatshield user add <name> [password], para jugadores que entraron al servidor al menos una vez. Una cuenta nunca da nada por sí sola: lo que puede ver siempre sale de los grupos y permisos del jugador.

5. Extras opcionales #

• Alertas y resúmenes por email: completá la sección email de config.yml y probala con /chatshield email test <address>. Mirá Configuración.
• Explicaciones con IA: agregá tu propia clave de Anthropic o compatible con OpenAI en la sección ai y probala con /chatshield ai test. Mirá Configuración.
• Pro: activá tu clave con chatshield license activate <key>. Mirá Licencias y pago.

Actualizar #

ChatShield busca versiones nuevas más o menos un minuto después de que arranca el servidor y después cada 6 horas, y avisa en la consola, en el panel y a los jugadores con chatshield.update.notify.

• /chatshield update download descarga la versión nueva en la carpeta de actualizaciones del servidor. Se aplica en el próximo reinicio, y solo después de comprobar que su firma es válida. Funciona en Free y en Pro.
• En Pro, updates.auto-download: true hace la descarga por vos.
• También podés reemplazar vos mismo el jar en plugins/ y reiniciar el servidor.

Cuando una versión nueva suma ajustes, tu config.yml se actualiza al arrancar: las claves que faltan se agregan con sus comentarios, las líneas existentes nunca se reescriben y se guarda una copia del archivo anterior.