Average Essentials

AverageEssentials es un plugin ligero de Java para servidores de Hytale, construido con Gradle, diseñado para mejorar la funcionalidad básica del servidor con herramientas esenciales para la gestión de jugadores, comunicación y administración.

Características

Gestión del Chat

• Formato del Chat: Formatea automáticamente los mensajes de chat de los jugadores con prefijos basados en grupos. Muestra el prefijo del grupo de permisos con mayor peso junto al nombre de usuario del jugador y su mensaje para una experiencia de chat limpia y organizada.
• Sistema de Filtrado de Chat: Moderación de contenido avanzada con filtrado en tres niveles:
  • Términos Prohibidos: Banea automáticamente a los jugadores que usen términos prohibidos especificados. Los jugadores que utilicen palabras prohibidas son desconectados al instante y baneados permanentemente del servidor.
  • Términos Censurables: Censura automáticamente (reemplazando por ****) palabras especificadas mientras permite que el mensaje sea enviado, proporcionando un enfoque de moderación menos disruptivo.
  • Términos Eliminables: Bloquea silenciosamente los mensajes que contengan palabras restringidas y notifica al jugador que el mensaje no fue permitido. Los mensajes no se envían a otros jugadores.
  • Coincidencia de Patrones Regex: Todos los filtros utilizan coincidencia de patrones regex sin distinción entre mayúsculas y minúsculas con detección de límites de palabras para un filtrado preciso y flexible.
• Soporte de Códigos de Color: Analiza los códigos de color al estilo Minecraft (&0-&f para colores, &l para negrita) en mensajes y prefijos para un formato de texto enriquecido. Opcionalmente, se pueden desactivar los códigos de color en el chat según la configuración.
• Difusión Configurable: Difusiones programadas con frecuencia y mensajes personalizables, alternando a través de una cola para mayor variedad.

Administración

• Gestión de Plugins: Proporciona comandos completos para listar, cargar, descargar, recargar y gestionar plugins directamente desde la consola del servidor o en el juego.
• Gestión de Grupos: Permite a los administradores establecer y gestionar prefijos para grupos de permisos, almacenados en archivos JSON configurables.
• Mensajes Informativos: Soporta mensajes de bienvenida para nuevos jugadores, difusiones periódicas a todos los jugadores en línea y comandos dinámicos para una rápida difusión de información (por ejemplo, enlaces de Discord).

Requisitos

• Servidor de Hytale (compatible con las API básicas para eventos, permisos, comandos y mensajería)
• Java 8 o superior
• Gradle para la construcción (incluido en el proyecto)

Instalación

• Descarga la última versión del JAR desde la sección de lanzamientos.
• Coloca el archivo JAR en el directorio de plugins de tu servidor.
• Reinicia el servidor para cargar el plugin.
• Configura grupos, mensajes y difusiones a través de los archivos de configuración JSON generados en mods/AverageEssentials/.

Configuración

Configuración del Filtro de Chat (chat.json)

El filtro de chat es altamente configurable y permite a los administradores definir tres niveles de moderación de contenido:

{
  "config": {
    "bannableTerms": ["badword1", "badword2"],
    "termsToCensor": ["mildword1", "mildword2"],
    "termsToDisable": ["restrictedword1", "restrictedword2"],
    "allowUsersToUseChatColorCodes": true
  }
}

Opciones de Configuración:

• bannableTerms (String[]): Un array de términos que desencadenan un baneo automático permanente. Los jugadores que utilicen estas palabras son desconectados y baneados al instante. Utiliza esto para las violaciones más severas.

• termsToCensor (String[]): Un array de términos que son reemplazados automáticamente por **** en los mensajes de chat. Los mensajes aún se entregan a los jugadores. Utiliza esto para lenguaje suave o prevención de spam.

• termsToDisable (String[]): Un array de términos restringidos cuyos mensajes son bloqueados silenciosamente. El remitente recibe una notificación, pero otros jugadores no ven el mensaje. Utiliza esto para mantener la relevancia del tema o prevenir discusiones específicas.

• allowUsersToUseChatColorCodes (Boolean): Cuando true, los jugadores pueden usar códigos de color al estilo Minecraft (&0-&f, &l, etc.) en sus mensajes. Cuando false, los códigos de color se tratan como texto plano. Predeterminado: true

Comportamiento de Filtrado:

• Todos los filtros son insensibles a mayúsculas para capturar variaciones en la capitalización
• Utiliza detección de límites de palabras (regex de ruptura de palabras) para coincidir solo palabras completas, evitando falsos positivos (por ejemplo, “test” no coincidirá en “testing”)
• Los filtros se procesan en orden: Prohibidos → Eliminables → Censurables
• Si un mensaje desencadena un término prohibido, se bloquea inmediatamente y el jugador es baneado
• Si desencadena un término eliminable, el mensaje se bloquea y se notifica al jugador
• Los términos censurables se aplican después de que otros controles hayan pasado

Configuración del Gestor de Grupos (group.json)

Configura los prefijos de grupos de permisos para el formato del chat:

{
  "groups": {
    "admin": {
      "prefix": "&c[Admin]&r",
      "weight": 100
    },
    "moderator": {
      "prefix": "&6[Mod]&r",
      "weight": 50
    },
    "member": {
      "prefix": "&7[Member]&r",
      "weight": 1
    }
  }
}

• weight: Determina la prioridad cuando un jugador tiene múltiples grupos. Mayor peso = mayor prioridad en la visualización del chat.
• prefix: El texto que se muestra antes del nombre del jugador en el chat, soportando códigos de color.