Configuracion

Esta página describe todas las opciones disponibles en el archivo /plugins/SGChat/config.yml.

A continuación encontrarás una guía completa de cada sección, sus funciones, valores permitidos y ejemplos.

🧩 1. General Settings

check-update

check-update: true

Activa o desactiva la verificación automática de actualizaciones al iniciar el servidor.

true → SGChat avisará si existe una nueva versión.
false → No se comprobarán actualizaciones.

🧩 2. Custom Placeholders

custom-placeholders:
  server: "&6My Server"
  website: "&bwww.example.com"
  discord: "&9discord.gg/example"

SGChat permite crear placeholders personalizados, que luego puedes usar en cualquier mensaje o formato.

Ejemplo de uso en el chat o motd:

Welcome to {server}!
Join our Discord: {discord}

Notas:

No uses llaves {} aquí; SGChat las agrega automáticamente.
Los códigos de color & son compatibles.
Puedes añadir los placeholders que quieras.

💬 3. Chat System

Toda la configuración principal del chat se encuentra en esta sección.

3.1 General Chat Format

chat:
  enable-format: true
  format: "&8[&a{level}&8] &7{displayname} &8» &f{message}"

enable-format:
- true → SGChat reemplaza el chat vanilla con tu formato personalizado.
- false → Se mantiene el chat original o el de otro plugin.
format: El diseño del mensaje de chat. Placeholders disponibles:
- {player}
- {displayname}
- {message}
- {level} (o cualquier placeholder personalizado o de PAPI)

3.2 Anti-Spam

anti-spam-delay: 2s
block-duplicate-messages: false

anti-spam-delay: Tiempo mínimo entre mensajes (ej: 2s, 1s, 500ms).
block-duplicate-messages:
- true → bloquea mensajes repetidos.
- false → permite enviar el mismo mensaje varias veces.

3.3 Blocked Words

blocked-words:
  - bitch
  - dick
  - nigga

Lista de palabras prohibidas en el chat. SGChat puede:

Bloquear mensaje
Dar advertencias
Aplicar mute automático (si está activado)

3.4 Automatic Mute System

warnings-before-mute: 3
enable-mute: false
mute-duration: 5m

enable-mute: activa/desactiva el sistema automático de mute.
warnings-before-mute: cantidad de advertencias antes del mute.
mute-duration: duración del mute (ej: 30s, 2m, 10m, 1h).

3.5 Group Formats

enable-group-formats: false
group-formats:
  admin: "&8┃ &c&lADMIN &8┃ &f{displayname} &8» &f{message}"
  mod: "&8┃ &9&lMOD &8┃ &f{displayname} &8» &7{message}"
  vip: "&8┃ &6&lVIP &8┃ &f{displayname} &8» &e{message}"
  default: "&8┃ &7{displayname} &8» &f{message}"

Permite tener formatos diferentes según el grupo del jugador (LuckPerms o Vault).

enable-group-formats: true → Activa los formatos por grupo.
Si un jugador no pertenece a ninguno definido, se usa default.

👥 4. Global Join/Quit Messages

Join

join:
  enabled: true
  message: "&8[&a+&8] &a{player}"

Quit

quit:
  enabled: true
  message: "&8[&4-&8] &4{player}"

Placeholders:

{player} → nombre del jugador
{displayname} → displayname del jugador

Si enabled = false, no se mostrará el mensaje.

🌐 5. Discord Webhooks

SGChat puede enviar eventos del servidor directamente a un canal de Discord usando un webhook.

discord:
  enable: false
  webhook-url: ""
  username: "SGChat"
  avatar-url: ""
  send-join: true
  send-quit: true
  join-message: "{player} joined"
  quit-message: "{player} left"
  use-embeds: true
  join-embed-title: "{player} joined the server"
  join-embed-description: "{player} joined. Welcome!"
  quit-embed-title: "{player} left the server"
  quit-embed-description: "{player} left. Farewell!"
  send-chat: true
  chat-message-template: "**{displayname}** » {message}"

Opciones principales:

enable: activa o desactiva la integración.
webhook-url: URL del webhook de Discord.
username / avatar-url: nombre e icono del bot en Discord.
send-join / send-quit: envía eventos al unirse o salir.
use-embeds: envía mensajes en formato embed.
send-chat: envía el chat del servidor a Discord.
chat-message-template: formato del mensaje enviado al webhook.

Placeholders disponibles:

{player}
{displayname}
{message}
{server} (placeholder personalizado)

⭐ 6. MOTD Messages

SGChat permite crear un MOTD dinámico cuando un jugador entra al servidor.

motd:
  enabled: true
  message:
    - "&8&m----------------------------------------"
    - "  &6&lWelcome to {server}"
    - ""
    - "  &7Players online: &b{online}&7/&b{maxplayers}"
    - "  &eJoin our Discord: {discord}"
    - "  &eVisit our website: {website}"
    - "&8&m----------------------------------------"