MessagesPlus

Un plugin de chat y mensajería integral para servidores de Hytale, diseñado para mejorar la comunicación entre jugadores y los anuncios del servidor, completamente personalizable a través de JSON.

Características

• Formato de Chat Personalizado: Configura formatos de chat basados en permisos (grupos) con soporte de prioridad.
• Mensajes de Entrada y Salida: Mensajes de entrada, primera entrada y salida personalizables. Suprime los mensajes de entrada predeterminados del servidor para que solo se vean los tuyos.
• Anuncios Programados: Configura mensajes de difusión automatizados con intervalos configurables.
• Soporte de Color Hex: Soporte completo para colores RGB Hex (&#RRGGBB) y códigos heredados (&a, &l).
• Estilo de Texto Enriquecido: Soporta Negrita (&l), Cursiva (&o), Subrayado (&n), Tachado (&m) y Ofuscado (&k).
• Recargable: Recarga configuraciones al instante sin reiniciar el servidor.
• Marcadores de Posición: Soporte de marcadores de posición integrados para mensajes dinámicos.

Instalación

Instalación Manual

• Descargar: Obtén la última versión de MessagesPlus-x.x.x.jar desde la página de Releases.
• Instalar: Coloca el archivo JAR en el directorio mods (o plugins) de tu servidor de Hytale.
• Ejecutar: Inicia tu servidor. Los archivos de configuración predeterminados se generarán en el directorio de datos del plugin.

Comandos

Comando Principal

Alias: /messagesplus o /mp

Subcomandos

1. General

• /mp reload: Recarga todos los archivos de configuración (welcome-leave.json, chat-format.json, scheduled.json) de inmediato.

2. Programación

Gestiona mensajes de difusión automatizados directamente desde el juego o la consola.

• /mp schedule list: Lista todos los mensajes programados activos con sus IDs e intervalos.
• /mp schedule add <interval_seconds> <message>: Añade un nuevo mensaje programado.
  • Ejemplo: /mp schedule add 300 &a¡No olvides unirte a nuestro Discord!
  • Nota: Los intervalos están en segundos.
• /mp schedule remove <id>: Elimina un mensaje programado por su ID (encontrado en /mp schedule list).

Configuración

El plugin genera los siguientes archivos de configuración en su carpeta de datos:

1. chat-format.json

Define formatos de chat basados en permisos. El plugin verifica las reglas de formato de arriba hacia abajo. Se aplicará la primera regla para la que el jugador tenga el permiso.

{
  "owner": {
    "format": "&8[&cOwner&8] &c%playername%&8: &f%message%",
    "permission": "messagesplus.owner"
  },
  "admin": {
    "format": "&8[&cAdmin&8] &c%playername%&8: &f%message%",
    "permission": "messagesplus.admin"
  },
  "default": {
    "format": "&7%playername%: &7%message%"
  }
}

• Consejo: Coloca los grupos de mayor prioridad (como Owner/Admin) en la parte superior del archivo.

2. welcome-leave.json

Configura mensajes para eventos de conexión de jugadores.

{
  "first_join_message": "&e¡Bienvenido &b%playername%&e al servidor por primera vez!",
  "join_message": "&e%playername% &eha entrado al juego.",
  "leave_message": "&e%playername% &ese ha desconectado.",
  "debug": false
}

• first_join_message: Se emite solo cuando un jugador se une por primera vez.
• join_message: Se emite para jugadores que regresan.
• leave_message: Se emite cuando un jugador se desconecta.

3. scheduled.json

Almacena los anuncios programados. Aunque puedes editar esto manualmente, recomendamos usar los comandos /mp schedule.

{
  "messages": [
    {
      "id": 1,
      "interval": 300,
      "text": "&a¡Visita nuestro sitio web en example.com!",
      "lastSent": 123456789
    }
  ]
}

Marcadores de Posición

Puedes usar estos marcadores de posición en formatos de chat, mensajes de entrada/salida y anuncios:

Marcador de posición	Descripción
%playername%	El nombre de usuario del jugador.
%uuid%	El ID único del jugador.
%world%	El nombre del mundo en el que se encuentra actualmente el jugador.
%message%	El contenido del mensaje de chat (solo Formatos de Chat).
%health%	(Próximamente) La salud del jugador.

Códigos de Color

Colores Legados

Códigos de color al estilo estándar de Minecraft utilizando &.

• &0 Negro, &1 Azul Oscuro, &2 Verde Oscuro, &3 Aqua Oscuro
• &4 Rojo Oscuro, &5 Púrpura Oscuro, &6 Oro, &7 Gris
• &8 Gris Oscuro, &9 Azul, &a Verde, &b Aqua
• &c Rojo, &d Púrpura Claro, &e Amarillo, &f Blanco

Formateo

• &l Negrita
• &o Cursiva
• &n Subrayado
• &m Tachado
• &k Ofuscado

Colores Hex

Utiliza códigos hex RGB modernos para colores precisos.

• Formato: &#RRGGBB
• Ejemplo: &#FF5555¡Este es un rojo personalizado!

Licencia

Licencia MIT