BroadcastSystem

La versión 1.1 será una versión final por ahora. Prefiero tener un plugin fiable sin errores que un plugin con múltiples métodos y errores o lags.

¿Buscas una forma sencilla de mostrar consejos del servidor, reglas, enlaces de Discord o anuncios? BroadcastSystem proporciona dos sistemas de auto-broadcast independientes (Chat + Título), además de mensajes de unión, comandos manuales, & colores, marcadores de posición y una configuración JSON limpia.

Características:

• ✅ Broadcasts de chat (soporte para múltiples líneas)
• ✅ Broadcasts de título (Título del evento / “gran título” en el centro de la pantalla)

También incluye:

• ✅ Comandos de broadcast manuales
• ✅ Mensajes de unión (mensaje privado para el que se une + mensaje público para todos)
• ✅ Códigos de color al estilo de Minecraft &
• ✅ Marcadores de posición como %player% y %joiner%
• ✅ Configuración JSON simple (config.json)

Características

1) Dos sistemas de broadcast independientes

Cada sistema tiene su propia configuración:

• habilitado/deshabilitado
• intervalo en segundos
• modo aleatorio (mezcla) o orden rotativo

Así que puedes ejecutar:

• Chat cada 120s
• Título cada 300s
• O deshabilitar uno por completo.

2) Pool de anuncios compartido con objetivos por entrada

Defines los anuncios una vez en "announcements" y eliges a dónde van usando:

• "targets": ["CHAT"]
• "targets": ["TITLE"]

Cada anuncio puede contener:

• contenido de "chat" (bloque de múltiples líneas)
• contenido de "title"
• contenido de "subtitle" (opcional)

3) Mensajes de unión (opcional)

Dos secciones dedicadas a mensajes de unión:

• joinSelf: solo enviado al jugador que se une
• joinServer: broadcast a todos los jugadores en línea

Ambos soportan:

• objetivos de chat y/o título
• bloques de múltiples líneas
• marcadores de posición
• desactivación opcional del mensaje de unión por defecto

4) Formateo de texto

Códigos de color heredados

Soporta códigos similares a los de Minecraft:

• Colores: &0 a &9, &a a &f
• Formateo: &l (negrita), &o (cursiva), &r (reiniciar)
• Funciona tanto con & como con §

Bloques de múltiples líneas

Para mensajes de chat (y chat de unión), puedes usar:

"chat": "----nLínea 1nLínea 2n----"

O simplemente usar n para saltos de línea.

5) Marcadores de posición

• %player%
  Reemplazado por el nombre del jugador receptor (el jugador que recibe el mensaje).
• %joiner%
  Reemplazado por el nombre del jugador que se une (solo significativo para mensajes de unión).
• %world%
  Reemplazado por el mundo actual del jugador receptor (mejor esfuerzo: nombre/id/uuid dependiendo de la disponibilidad de la API).
• %players_online%
  Reemplazado por el número de jugadores actualmente en línea.
• %online% (alias de %players_online%)
  Igual que arriba, nombre más corto.
• %server_uptime%
  Reemplazado por el tiempo de actividad del servidor/plugin (tiempo desde el arranque del plugin), formateado como:
  12m 05s, 3h 12m 09s, 2d 04h 01m 33s
• %time%
  Hora local actual del servidor: HH:mm:ss
  Ejemplo: 21:43:10
• %date%
  Fecha local actual del servidor: yyyy-MM-dd
  Ejemplo: 2026-01-15
• %datetime%
  Fecha local actual del servidor + hora: yyyy-MM-dd HH:mm:ss
  Ejemplo: 2026-01-15 21:43:10
• %day%
  Día actual de la semana (mayúsculas): LUNES, MARTES, etc.
• %timezone%
  ID de la zona horaria del sistema del servidor (ejemplo: Europe/Paris)

Número entero aleatorio

• %random_int:min:max%
  Genera un número entero aleatorio entre min y max (inclusive).
  Ejemplos:

• %random_int:1:100% → 42
• %random_int:-5:5% → -1
• %random_int:10:10% → 10

Elección aleatoria

• %random_choice:a|b|c%
  Selecciona aleatoriamente UNA opción de una lista separada por |.
  Ejemplos:

• %random_choice:Leer /rules|Unirse a Discord|Usar /help%
• %random_choice:Hola|Hi|Hey%

✅ Soporta marcadores de posición dentro de las opciones, por ejemplo:

• %random_choice:En línea: %online%|Mundo: %world%|Hora: %time%%

Comandos

Comando principal: /hb

/bs reload

Recarga config.json y reinicia los programadores de broadcast.

/bs status

Muestra el estado actual:

• si los sistemas de chat/título están habilitados
• intervalos
• tamaños de pool
• ruta del archivo de configuración

/bs now [chat|title|both]

Envía instantáneamente un broadcast desde el pool configurado.

Ejemplos:

• /bs now
• /bs now chat
• /bs now title

/bs start [chat|title|both]

Comienza a transmitir.

Ejemplos:

• /bs start
• /bs start chat

/bs stop [chat|title|both]

Detiene la transmisión.

Ejemplos:

• /bs stop
• /bs stop title

/bs send chat <mensaje...>

Envía un anuncio de chat manual a todos los jugadores.

Ejemplo:

• /bs send chat &a¡Hola mundo!

/bs send title <mensaje...>

Envía un anuncio de título manual a todos los jugadores.
Soporta n para forzar un título de múltiples líneas.

Ejemplo:

• /bs send title &eReinicio del servidorn&7En 5 minutos

Permisos

Permiso de administrador (control total)

- broadcast_system.admin
Permite:

• recargar
• estado
• iniciar/detener
• ahora

Permiso de envío (solo broadcasts manuales)

- broadcast_system.send
Permite:

• /hb send chat ...
• /hb send title ...

Fallback de operador

Si tu servidor usa permisos por roles, el plugin también permite:

• role.operator

Configuración

El plugin crea:

• mods/Yanisssch_BroadcastSystem/config.json

Secciones clave:

• chat
• title
• joinSelf
• joinServer
• announcements

Notas importantes

• Si "showSubtitle": false, los subtítulos estarán ocultos incluso si se proporcionan.
• Si el subtítulo está vacío, se usa title.defaultSubtitle (cuando está habilitado).
• Si disableDefaultJoinMessage es verdadero para las configuraciones de unión, el broadcast de unión por defecto está deshabilitado.
• No uses colores para el Título, esto no funciona….
• No uses el objetivo BOTH para el anuncio (actualmente arreglando un problema con este objetivo)
• Ten cuidado al hacer la configuración, guarda una copia de seguridad en caso de que cometas errores, el “,” y “{}” son muy importantes y no uses ” en el chat o título, puede romper la configuración misma 😉
• Tómate tu tiempo para probar el plugin y leer todo el archivo de configuración
• Y, este plugin es el primero que hice para Hytale, todavía estoy aprendiendo la API, así que si ves algunos errores no dudes en decírmelo en Discord “Yanisssch_Sori”

Ejemplo de Configuración 

{

  "_comment": "BroadcastSystem config.json - ejemplos. Colores(solo para el chat - no para los títulos!): &a, &6, &l, &r… Marcadores de posición: %player% = receptor, %joiner% = jugador que se une. 'n' bloques permiten texto de múltiples líneas solo para chat, ¡no para títulos!",

  "_help_targets": "los objetivos para JoinSelf y JoinServer pueden ser: ["CHAT"], ["TITLE"], y para el anuncio puede ser ["BOTH"] (o ["CHAT","TITLE"]).",

  "chat": {

    "_comment": "Anuncios automáticos en el chat.",

    "enabled": true,

    "intervalSeconds": 120,

    "shuffle": false,

    "prefix": "&6&l[INFO]&r "

  },
  "title": {

    "_comment": "Anuncios automáticos como título central (EventTitle).",

    "enabled": true,

    "intervalSeconds": 300,

    "shuffle": false,

    "showSubtitle": true,

    "defaultSubtitle": "&eAnuncio",

    "animate": true

  },
  "joinSelf": {

    "_comment": "Mensaje enviado SOLO al jugador que se une (privado).",

    "enabled": true,

    "disableDefaultJoinMessage": true,

    "targets": ["BOTH"],

    "chat": "----n&a¡Hola &f%player%&a!n&7¡Bienvenido! Por favor lee &f/rules&7 :)

----",

    "title": "¡Bienvenido %player% a ServerName!",

    "subtitle": "Diviértete ;)",
    "_example_title": {

      "_comment": "EJEMPLO ALTERNATIVO: mostrar un Título en lugar de chat",

      "enabled": false,

      "disableDefaultJoinMessage": true,

      "targets": ["TITLE"],

      "title": "BIENVENIDO",

      "subtitle": "&7Reglas: &f/rules"

    },
    "_example_chat": {

      "_comment": "EJEMPLO ALTERNATIVO: mostrar un Chat en lugar de título",

      "enabled": false,

      "disableDefaultJoinMessage": true,

      "targets": ["CHAT"],

      "chat": "----n&a¡Hola &f%player%&a!n&7¡Bienvenido! Por favor lee &f/rules&7 :)

----"

    }

  },
  "joinServer": {

    "_comment": "Mensaje enviado a TODOS cuando alguien se une.",

    "enabled": true,

    "disableDefaultJoinMessage": true,

    "targets": ["CHAT"],

    "chat": "----n&6&l[UNIÓN]&r &e%joiner% &ha unido al servidor!n----",
    "_example_both": {

      "_comment": "EJEMPLO ALTERNATIVO: enviar tanto CHAT + TÍTULO al mismo tiempo.",

      "enabled": false,

      "disableDefaultJoinMessage": true,

      "targets": ["BOTH"],

      "chat": "----n&6&l[UNIÓN]&r &e%joiner% &ha unido al servidor!n----",

      "title": "&a¡Nuevo jugador!",

      "subtitle": "&e%joiner%"

    }

  },
  "_comment": "Para el anuncio, no BOTH para el objetivo (Actualmente arreglando un problema con esta parte)",

  "announcements": [

    {

      "_comment": "EJEMPLO 1: anuncio de CHAT de múltiples líneas (con bloque ----n).",

      "targets": ["CHAT"],

      "chat": "----n&b¡Bienvenido &f%player%&b!n&7Asegúrate de leer &f/rules&7 :)

----"

    },
    {

      "_comment": "EJEMPLO 2: anuncio de TÍTULO.",

      "targets": ["TITLE"],

      "title": "BIENVENIDO",

      "subtitle": "¡Diviértete!"

    },
    {

      "_comment": "EJEMPLO 3: TÍTULO sin subtítulo).",

      "targets": ["TITLE"],

      "title": "¿Necesitas ayuda?",

      "subtitle":... [Truncado]