Config Files

Config.yml

# ====================================
#     DISCORD INTEGRATION CONFIG
# ====================================

# Configuración del bot de Discord
discord:
  # Token del bot de Discord (REQUERIDO)
  # Ve a https://discord.com/developers/applications para crear tu bot
  token: "PON_AQUI_TU_TOKEN "

  # ID del servidor de Discord (REQUERIDO)
  # Habilita el modo desarrollador en Discord y haz clic derecho en tu servidor
  guild_id: "ID_DEL_SERVIDOR_DE_DISCORD"

  # Configuración de conexión
  connection:
    # Tiempo de espera para conectar (segundos)
    timeout: 30
    # Reintentos automáticos en caso de fallo
    auto_retry: true
    # Máximo número de reintentos
    max_retries: 5
    # Tiempo entre reintentos (segundos)
    retry_delay: 10

# Configuración de actualización de datos
update:
  # Intervalo de actualización en segundos (mínimo 30)
  interval: 60
  # Habilitar actualizaciones automáticas
  enabled: true
  # Usar caché para reducir requests a Discord API
  use_cache: true
  # Tiempo de vida del caché en segundos
  cache_duration: 45

# Configuración de logging
logging:
  # Nivel de logging: DEBUG, INFO, WARN, ERROR
  level: "INFO"
  # Registrar conexiones/desconexiones
  log_connections: true
  # Registrar errores de API
  log_api_errors: true
  # Registrar actualizaciones de datos
  log_updates: false

# Configuración de comandos
commands:
  # Habilitar comandos del plugin
  enabled: true
  # Prefijo para comandos (opcional)
  prefix: ""
  # Cooldown entre comandos por jugador (segundos)
  cooldown: 3

# Variables PlaceholderAPI disponibles:
# %discordintegration_count% - Número total de usuarios en Discord
# %discordintegration_online_count% - Usuarios online en Discord
# %discordintegration_boost_count% - Número de boosts del servidor
# %discordintegration_boost_level% - Nivel de boost del servidor
# %discordintegration_server_name% - Nombre del servidor de Discord
# %discordintegration_status% - Estado de conexión del bot

# Configuración de PlaceholderAPI
placeholders:
  # Habilitar la integración con PlaceholderAPI
  enabled: true
  # Formato para números (usar 0 para mostrar siempre, # para mostrar si hay)
  number_format: "#,###"
  # Texto cuando el bot está desconectado
  offline_text: "Desconectado"
  # Texto cuando no hay datos disponibles
  no_data_text: "N/A"

# Configuración de funciones específicas
features:
  # Habilitar estadísticas de miembros
  member_stats: true
  # Habilitar estadísticas de boosts
  boost_stats: true
  # Habilitar estadísticas de presencia
  presence_stats: true
  # Habilitar información del servidor
  server_info: true

# NO EDITES ESTA LÍNEA - Versión de configuración
config_version: 1

Messages.yml

# ====================================
#        MENSAJES DEL PLUGIN
# ====================================

# Colores disponibles: &0-&9, &a-&f, &k-&r
# También puedes usar códigos hex: &#FF0000 (rojo)

# Prefijo del plugin
prefix: "&#293AA3&l&nP&#2D40B2&l&nl&#3145C2&l&nD&#354BD1&l&ni&#3850E0&l&ns&#3C56F0&l&nc&#405BFF&l&no&#3C56F0&l&nr&#3850E0&l&nd&#354BD1&l&nI&#3145C2&l&nn&#2D40B2&l&nf&#293AA3&l&no&r &r&7»&r "

# Mensajes generales
general:
  no_permission: "&#FF0000¡No tienes permisos para usar este comando!"
  command_cooldown: "&#FF0000¡Debes esperar &n{time}&r&#FF0000 segundos antes de usar este comando nuevamente.!"
  only_players: "&#FF0000Este comando solo puede ser usado por jugadores."
  unknown_command: "&#FF0000Comando desconocido. Usa &c&n/discordhelp&r &#FF0000para ver los comandos disponibles."

# Mensajes de conexión
connection:
  connecting: "&#405BFF¡Conectado con DISCORD...! Espera unos segundos."
  connected: "&#405BFF✔ ¡Se ha conectado exitosamente!"
  disconnected: "&#405BFF✘ ¡Desconectado del servidor :c!"
  reconnecting: "&#405BFF¡Reconectando con Discord...! (Intento {attempt}/{max})"
  failed: "&#405BFF¡Error al conectar con Discord: {error}!"
  timeout: "&#405BFF¡Tiempo agotado al conectar con Discord!"

# Mensajes de configuración
config:
  reloaded: "&#405BFF¡La configuración ha sido regargada exitosamente!"
  reload_error: "&#405BFF¡Error al cargar la configuración: {error}!"
  missing_token: "&#405BFF¡Token del bot de DISCORD no ha sido configurados! &n(config.yml)"
  missing_guild: "&#405BFF¡No has configurado el ID del servidor!"
  invalid_config: "&#405BFF¡La configuración es inválida!"

# Mensajes del comando /discordstats
stats:
  header: ""
  footer: ""
  total_members: " &r&7»&r &7Miembros totales: &a{count}"
  online_members: " &r&7»&r &7Miembros online: &a{count}"
  boost_count: " &r&7»&r &7Boosts del servidor: &d{count}"
  boost_level: " &r&7»&r &7Nivel de boost: &d{level}"
  server_name: " &r&7»&r &7Servidor: &b{name}"
  connection_status: " &r&7»&r &7Estado: {status}"
  last_update: " &r&7»&r &7Última actualización: &e{time}"
  no_data: " &r&7»&r &cNo hay datos disponibles. El bot podría estar desconectado."

# Mensajes del comando /discordinfo
info:
  header: " &r&7»&r "
  footer: ""
  server_name: " &r&7»&r &7Nombre del servidor: &b{name}"
  server_id: " &r&7»&r &7ID del servidor: &e{id}"
  creation_date: " &r&7»&r &7Fecha de creación: &e{date}"
  owner: " &r&7»&r &7Propietario: &a{owner}"
  region: " &r&7»&r &7Región: &e{region}"
  verification_level: " &r&7»&r &7Nivel de verificación: &e{level}"
  total_channels: " &r&7»&r &7Canales totales: &a{count}"
  total_roles: " &r&7»&r &7Roles totales: &a{count}"

# Estados de conexión
status:
  connected: "&aConectado"
  connecting: "&eConectando..."
  disconnected: "&cDesconectado"
  error: "&4Error"
  unknown: "&7Desconocido"

# Mensajes de error específicos
errors:
  bot_offline: "&cEl bot de Discord está desconectado."
  api_error: "&cError de la API de Discord: {error}"
  network_error: "&cError de red: {error}"
  permission_error: "&cEl bot no tiene permisos suficientes en Discord."
  guild_not_found: "&cNo se pudo encontrar el servidor de Discord especificado."
  rate_limit: "&cLímite de rate alcanzado. Reintentando en {seconds} segundos."

# Mensajes de ayuda
help:
  header: ""
  footer: ""
  stats: " &r&7»&r &e/discordstats &7- Muestra estadísticas del Discord"
  info: " &r&7»&r &e/discordinfo &7- Información general del Discord"
  reload: " &r&7»&r &e/discordreload &7- Recarga la configuración"

# Mensajes de debug (solo aparecen con logging en DEBUG)
debug:
  cache_hit: "Cache hit para datos de Discord"
  cache_miss: "Cache miss, obteniendo datos de Discord API"
  data_updated: "Datos de Discord actualizados"
  placeholder_request: "Solicitud de placeholder: {placeholder}"

# Formatos de fecha/hora
datetime:
  format: "dd/MM/yyyy HH:mm:ss"
  timezone: "UTC"