Configuración

ChatShield se configura en plugins/ChatShield/config.yml, que el primer arranque crea con comentarios en cada clave. Editalo y corré /chatshield reload; no hace falta reiniciar salvo donde se indica. En Pro también podés cambiar cada ajuste desde la página Configuración del panel. En Free el panel puede cambiar el idioma, el tema y el color de acento, y todo lo demás se sigue pudiendo editar en el archivo.

Un valor incorrecto nunca frena el plugin: la consola indica la clave, qué se esperaba y el valor por defecto que usa en su lugar. Si el archivo directamente no es YAML válido, se siguen usando los ajustes anteriores.

Las claves marcadas como Pro solo tienen efecto con una licencia Pro. En Free se conservan, nunca se borran.

General #

Consola #

Captura #

Qué registra el plugin. Los comandos de ingreso, registro y contraseña nunca se capturan, pongas lo que pongas acá.

Almacenamiento #

Todo se guarda en un solo archivo SQLite, plugins/ChatShield/data.db. Hacé la copia de seguridad con el servidor apagado, o copiá data.db, data.db-wal y data.db-shm juntos.

Grupos y exenciones #

Las líneas de los jugadores exentos igual se guardan y se muestran como contexto en los casos de otros jugadores. El permiso chatshield.exempt también exime a un jugador.

Publicidad #

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

Un mensaje que comparte uno de estos enlaces nunca se marca por eso, lo escriban como lo escriban los jugadores: con o sin https:// y www., en un subdominio, en mayúsculas, entre paréntesis o corchetes o detrás de un código de color, o escrito con palabras ("myserver punto net"). Todo lo demás se sigue marcando: otro Discord u otro sitio web, un nombre parecido, una dirección más larga (myserver.net.ru) o el mismo código en otro servicio de invitaciones (dsc.gg, discord.me).

• Escribí un host (myserver.net) o una invitación (discord.gg/abc123). Si una entrada tiene un puerto o una query, se ignoran.
• Una entrada con una ruta (tu página en una lista de servidores, como minecraft-mp.com/server/123456) permite esa página y las que están debajo de ella, no el resto del sitio.
• Un código de invitación con mayúsculas solo coincide cuando se escribe exactamente así. Escribí en minúsculas las invitaciones personalizadas.
• Un nombre solo (myserver) permite ese nombre en cualquier dominio, así que ponelo solo si nadie más tiene un servidor con ese nombre.

Detección #

Acciones #

Cada tipo y gravedad tiene una lista de acciones: log (solo guardar; va siempre implícita), notify (alerta en el juego, emails en tiempo real y una notificación en el panel) o command (Pro, corre las entradas de detection.commands que correspondan). Los tipos que no están en la lista usan default. Así viene de fábrica:

detection:
  actions:
    default:       { low: [log], medium: [notify], high: [notify] }
    advertising:   { low: [notify], medium: [notify], high: [notify] }
    personal_data: { low: [notify], medium: [notify], high: [notify] }
    spam:          { low: [log], medium: [log], high: [notify] }
    caps:          { low: [log], medium: [log], high: [log] }

Comandos automáticos (Pro) #

Por defecto no se sanciona nada automáticamente. Una entrada de detection.commands se corre una vez por caso, como la consola, cuando el caso llega a threshold eventos de gravedad min-severity o mayor, y solo mientras la fila de detection.actions de ese tipo y gravedad incluya command. Placeholders: {player}, {uuid}, {type}, {severity}, {case} y {server}. Usá los comandos de tu plugin de sanciones, y probalos primero a mano.

detection:
  actions:
    advertising: { low: [notify], medium: [notify], high: [notify, command] }
  commands:
    - { type: advertising, min-severity: high, threshold: 3, run: ["warn {player} Advertising (case {case})"] }

Archivos de reglas #

Las reglas están en plugins/ChatShield/rules/:

• en.yml y es.yml son los paquetes de idioma incluidos, que se copian en el primer arranque.
• custom.yml tiene tus propias reglas y siempre se carga al final. Sus listas se suman a las de los paquetes, salvo que pongas merge: replace arriba de todo.

# rules/custom.yml
version: 1
merge: append
detectors:
  advertising:
    allowed: []        # p. ej. [myserver.net, discord.gg/abc123]
    hosts: []          # más hosts de la competencia
  insult:
    words: []          # más raíces de palabras
    safe-words: []     # palabras que nunca tienen que marcarse
  custom:
    toxic-links:       # aparece como "custom:toxic-links" en el panel
      enabled: false
      severity: medium
      regex: ["\\bbit\\.ly/\\w+\\b"]

• Las palabras son raíces: idiot también coincide con idiots e idiotic. Terminá una entrada con ! para que solo coincida la palabra entera.
• Las expresiones regulares usan la sintaxis de Java y, por defecto, se comparan con el texto normalizado: en minúsculas, sin acentos y con el leetspeak deshecho. Empezá un patrón con raw: para compararlo con el texto original.
• Los patrones se revisan cuando se carga el archivo. Un patrón que podría colgarse (como (a+)+) se rechaza, y uno que tarda más de 50 ms con una entrada hostil se desactiva y se nombra en la consola.
• Un archivo de reglas con un error se informa, y las reglas anteriores siguen activas hasta que se corrija.

Alertas #

Panel #

Los cambios en panel.bind, panel.port, panel.base-path y panel.https.* se aplican con un reinicio o con /chatshield reload desde la consola o el juego, no al guardar en el panel. Las recetas de configuración están en la guía del panel.

Acceso #

Qué grupos pueden ingresar al panel y qué ve cada uno.

access:
  permissions-override: true
  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 }
    mod:   { violations: [advertising, insult, harassment, discrimination, sexual, threat], punishments: true, logs: false, analytics: true, settings: false, users: false, ai: false }

• Cada entrada es un nombre de grupo, tal como figura en LuckPerms o en tu plugin de permisos de Vault. violations es [all] o una lista de tipos de infracción; las otras claves son true o false (las que faltan cuentan como false).
• El acceso de un jugador es la suma de todos sus grupos, el principal y los heredados. Un jugador sin ningún grupo que coincida y sin ningún permiso del panel no puede ingresar.
• Free usa solo los dos primeros grupos (de fábrica, mod es el tercero). La consola lo avisa al arrancar.
• chatshield.admin (los operadores, por defecto) siempre ve todo.
• access.permissions-override (Pro con LuckPerms o Vault): los permisos chatshield.panel.* suman acceso por encima de los grupos. Sin LuckPerms ni Vault, esos permisos son la única forma de entrar, en Free y en Pro.
• El alcance settings puede cambiar los comandos automáticos, que corren como la consola. Dáselo solo a los dueños.

Email #

email:
  recipients:
    - { address: "[email protected]", language: en, categories: [all, digest], min-severity: medium, mode: digest, every: "daily@08:00" }

Cada destinatario tiene un idioma (en, es, es_AR), categorías (tipos de infracción, punishments, digest o all), una gravedad mínima y un modo: realtime, digest o both. Los horarios de los resúmenes son del estilo de 30m, 6h, daily@08:00, daily@08:00,20:00 o weekly@mon-08:00. Free usa solo el primer destinatario, con emails en tiempo real o un resumen diario; Pro permite cualquier cantidad de destinatarios, cualquier horario y los dos modos.

Sirve cualquier servicio SMTP: una contraseña de aplicación de Gmail o Google Workspace, Outlook o Microsoft 365, SendGrid, Mailgun, Brevo o tu propio servidor. Probalo con /chatshield email test <address>.

IA #

Apagada por defecto. Nada del plugin depende de ella.

Free permite 10 explicaciones por día; Pro no tiene límite. Una explicación o una segunda opinión manda el caso marcado y las líneas de alrededor, con las direcciones de email y los números de teléfono reemplazados por [personal data]. El párrafo del resumen (Pro) manda, en cambio, el resumen del período: sus totales, el jugador, el grupo, el tipo, la gravedad y la primera línea de evidencia de cada caso nuevo, y las sanciones; ese texto no se enmascara. Las respuestas se muestran como texto y nunca se ejecutan. Probalo con /chatshield ai test.

Licencia #

Mirá Licencias y pago.

Actualizaciones #

Estadísticas de uso #

chatshield telemetry muestra los datos exactos del último informe. Qué guardamos y por cuánto tiempo: política de privacidad.

Sanciones #

LiteBans, AdvancedBan y los mutes de EssentialsX se leen directamente, y la lista de bans vanilla, que también usan los bans de Essentials, se revisa en busca de cambios. Para otros plugins de sanciones, los comandos de abajo se registran cuando el staff los escribe. La misma sanción vista dos veces en 5 segundos se registra una sola vez.

punishments:
  commands:
    ban: [ban, eban]
    tempban: [tempban, etempban]
    ipban: [ipban, banip, tempipban, tempbanip]
    unban: [unban, pardon, unbanip, pardon-ip]
    mute: [mute, tempmute, ipmute, emute]
    unmute: [unmute, eunmute]
    kick: [kick, ekick]
    warn: [warn, ewarn]

Avanzado #

Secretos en variables de entorno #

Cuatro claves son secretos: nunca se escriben en el log, el panel solo las muestra enmascaradas y pueden venir de variables de entorno en lugar del archivo. Una variable siempre gana sobre config.yml y nunca se escribe de vuelta en él.

Recargar #

/chatshield reload vuelve a leer config.yml, los archivos de reglas, los archivos de idioma, los prompts de la IA y las plantillas de email, y los aplica sin reiniciar. Si el config.yml nuevo no se puede leer, no cambia nada y se listan los errores.

• Las claves de la dirección del panel (panel.bind, panel.port, panel.base-path, panel.https.*) y advanced.http-threads se aplican con un reinicio o con /chatshield reload desde la consola o el juego.
• advanced.intake-queue y advanced.db-queue necesitan un reinicio completo.
• Nunca uses el /reload del propio servidor. Para actualizar el plugin, reiniciá el servidor.