JemAnnouncements

Un plugin para servidores de Hytale que proporciona un sistema de anuncios automatizado con soporte para chat, notificaciones, títulos y mensajes sonoros. Este plugin te permite programar y personalizar anuncios que se envían automáticamente a todos los jugadores en línea en intervalos configurables.

Características Actuales

• Varios Tipos de Mensajes: Soporte para mensajes de chat, notificaciones en la barra de acción, títulos y efectos de sonido
• Programación Flexible: Intervalos configurables para anuncios automáticos
• Orden de Mensajes: Elige entre un orden secuencial o aleatorio de los mensajes
• Sistema de Prioridad: Establece prioridades de mensajes para controlar el orden de visualización
• Centrado de Mensajes: Centra automáticamente los mensajes de chat para una mejor presentación
• Múltiples Archivos de Mensajes: Crea mensajes de anuncio ilimitados como archivos JSON separados
• Formato Rico: Soporte para colores hexadecimales, rgb, colores heredados (& códigos) y etiquetas TinyMsg
• Recarga Rápida: Recarga la configuración y los mensajes sin reiniciar el servidor usando /announce-reload
• Activación Manual: Activa manualmente cualquier anuncio por nombre usando /announce <nombre-del-mensaje>
• Comprobación de Actualizaciones: Verifica las versiones en GitHub para actualizaciones y te notifica si hay una disponible
• Plantillas de Ejemplo: Genera automáticamente plantillas de mensajes de ejemplo en el primer lanzamiento

Tipos de Mensajes

• Mensajes de Chat: Envía mensajes de chat formateados a todos los jugadores (soporta múltiples líneas, centrado y formato rico)
• Notificación: Muestra notificaciones similares a las de recogida de objetos con iconos personalizados
• Mensajes de Título: Muestra mensajes de título y subtítulo con temporización de desvanecimiento personalizable y soporte para títulos principales
• Efectos de Sonido: Reproduce sonidos personalizados para todos los jugadores con volumen y tono configurables

Instalación

• Descarga la última versión desde la página de lanzamientos
• Coloca el archivo JemAnnouncements-x.x.x.jar en la carpeta mods de tu servidor de Hytale
• Inicia tu servidor para generar los archivos de configuración
• Edita el archivo Jemsire_JemAnnouncements/AnnouncementConfig.json para configurar intervalos y orden
• (Opcional) Personaliza los archivos de mensajes en la carpeta Jemsire_JemAnnouncements/messages/
• En el juego escribe /announce-reload para recargar rápidamente la configuración y activar el plugin

Nota: Las plantillas de mensajes de ejemplo se crean automáticamente en el primer lanzamiento. Puedes personalizarlas o crear tus propios archivos de mensajes.

Configuración

Después del primer lanzamiento, se crearán archivos de configuración en tu carpeta de mods. El plugin utiliza un sistema de configuración de dos niveles:

• AnnouncementConfig.json: Configuración principal con ajustes de temporización y orden
• messages/: Archivos de configuración de mensajes individuales

Archivo de Configuración Principal (AnnouncementConfig.json)

El archivo de configuración principal se encuentra en Jemsire_JemAnnouncements/AnnouncementConfig.json:

{
  "IntervalSeconds": 300,
  "Enable-Randomization": false,
  "Version": 1
}

Opciones de Configuración:

• IntervalSeconds: Tiempo en segundos entre anuncios (por defecto: 300 = 5 minutos)
• Enable-Randomization: Establece en true para un orden de mensajes aleatorio, false para un orden secuencial (por defecto: false)
• Version: Versión de configuración (actualmente 1)

Archivos de Configuración de Mensajes

Cada mensaje de anuncio tiene su propio archivo de configuración en Jemsire_JemAnnouncements/messages/. Las plantillas de ejemplo se crean automáticamente en el primer lanzamiento:

• example.json – Ejemplo completo con todos los tipos de mensajes
• example-chat.json – Solo mensajes de chat
• example-notification.json – Solo notificación de barra de acción
• example-title.json – Solo mensaje de título
• example-sound.json – Solo efecto de sonido
• example-all.json – Todos los tipos de mensajes combinados
• example-no-center.json – Ejemplo sin centrado de mensajes

Estructura de Configuración de Mensajes

{
  "Enabled": true,
  "Center": true,
  "Priority": 0,
  "ChatMessages": [
    "<aqua><bold>---[Anuncio]---</bold></aqua>",
    "<yellow>¡Este es un mensaje de anuncio!</yellow>"
  ],
  "Notification": {
    "Title": "<yellow><bold>Anuncio</bold></yellow>",
    "Subtitle": "<gray>Esta es una notificación</gray>",
    "Icon": "Weapon_Sword_Mithril"
  },
  "Title": {
    "Title": "<green><bold>Anuncio</bold></green>",
    "Subtitle": "<gray>Este es un título</gray>",
    "IsMajor": false,
    "FadeIn": 0.25,
    "Stay": 5.0,
    "FadeOut": 0.25
  },
  "Sound": {
    "SoundName": "SFX_Unbreakable_Block",
    "Volume": 1.0,
    "Pitch": 1.0
  }
}

Opciones de Configuración:

• Enabled: Habilitar o deshabilitar este mensaje (true/false)
• Center: Centrar los mensajes de chat en la ventana de chat (true/false, por defecto: true)
• Priority: Los mensajes de mayor prioridad se muestran primero al ordenarse (por defecto: 0)
• ChatMessages: Array de cadenas de mensajes de chat (enviados en orden)
• Notification: configuración de notificación (opcional)
• Title: configuración de título/subtítulo (opcional)
• Sound: configuración de efecto de sonido (opcional)

Ejemplos de Formato de Mensaje

Solo Mensajes de Chat:

{
  "Enabled": true,
  "Center": true,
  "ChatMessages": [
    "<aqua><bold>---[Reglas del Servidor]---</bold></aqua>",
    "<yellow>1. Sé respetuoso con otros jugadores</yellow>",
    "<yellow>2. No hacer griefing ni hacer trampas</yellow>",
    "<yellow>3. ¡Diviértete!</yellow>"
  ]
}

Notificación:

{
  "Enabled": true,
  "Notification": {
    "Title": "<yellow><bold>¡Evento del Servidor Comenzando!</bold></yellow>",
    "Subtitle": "<gray>Únete a nosotros en 5 minutos</gray>",
    "Icon": "Weapon_Sword_Mithril"
  }
}

Mensaje de Título:

{
  "Enabled": true,
  "Title": {
    "Title": "<green><bold>¡Bienvenido al Servidor!</bold></green>",
    "Subtitle": "<gray>Disfruta de tu estancia</gray>",
    "IsMajor": true,
    "FadeIn": 0.5,
    "Stay": 7.0,
    "FadeOut": 0.5
  }
}

Efecto de Sonido:

{
  "Enabled": true,
  "Sound": {
    "SoundName": "SFX_Unbreakable_Block",
    "Volume": 1.0,
    "Pitch": 1.0
  }
}

Combinado (Todos los Tipos):

{
  "Enabled": true,
  "Center": true,
  "ChatMessages": [
    "<aqua><bold>---[Ejemplo Completo]---</bold></aqua>",
    "<yellow>¡Esto incluye todos los tipos de mensajes!</yellow>"
  ],
  "Notification": {
    "Title": "<yellow><bold>Ejemplo Completo</bold></yellow>",
    "Subtitle": "<gray>Todos los tipos de mensajes combinados</gray>",
    "Icon": "Weapon_Sword_Mithril"
  },
  "Title": {
    "Title": "<green><bold>Anuncio Completo</bold></green>",
    "Subtitle": "<gray>Chat, Notificación, Título y Sonido</gray>",
    "IsMajor": true,
    "FadeIn": 0.5,
    "Stay": 7.0,
    "FadeOut": 0.5
  },
  "Sound": {
    "SoundName": "SFX_Unbreakable_Block",
    "Volume": 1.0,
    "Pitch": 1.0
  },
  "Priority": 0
}

Soporte de Formato

El plugin soporta tanto etiquetas TinyMsg como códigos de color heredados:

Etiquetas TinyMsg (como html):

• <red>, <blue>, <green>, etc. – Etiquetas de color
• <bold>, <italic>, <underline>, <strikethrough> – Etiquetas de formato
• <color:#FF0000> – Colores hexadecimales personalizados
• <reset> – Restablecer formato

Códigos de Color Heredados:

• &0 a &f – Códigos de color
• &l (negrita), &o (cursiva), &n (subrayado), &m (tachado)
• &r – Restablecer formato

Nota: Los códigos de color heredados se convierten automáticamente al formato TinyMsg. Ambos formatos se pueden usar juntos en el mismo mensaje.

Comandos

• /announce-reload – Recarga la configuración del plugin y los mensajes sin reiniciar el servidor

  • Permiso: jemsire.announcements.reload
  • Uso: Recarga la configuración principal y todos los archivos de mensajes, reinicia el programador si se cambió el intervalo o el orden

• /announce <nombre-del-mensaje> – Activa manualmente un anuncio por nombre de mensaje

  • Permiso: jemsire.announcements.announce
  • Uso: /announce ejemplo (nombre del mensaje sin la extensión .json)
  • Ejemplo: /announce example activa el mensaje del example.json

Este proyecto es de código abierto:

¡Siéntete libre de contribuir o adaptarlo a tu propio sistema! Consulta el Github

¿Quieres recibir actualizaciones de todos mis proyectos?

¡Únete al discord! ¡Únete ahora!