Chat Interactions Plugin

LocalGlobalChat (Hytale Plugin)

Plugin de chat para Hytale que incluye chat global/local, mensajería privada, herramientas de administración, un radio de chat local configurable y un modo de bloqueo de chat opcional (lista blanca).

Requisitos (Dependencias)

• ChatInteractions no tiene dependencias requeridas para funcionar.
• TinyMessage / TinyMsg (Opcional)
  Si está instalado, permite mejores colores y formato en el chat.
  Simplemente coloca tinymessage-*.jar en mods/.

Características

• Canales de chat global y local
• Chat local filtrado por radio de distancia (mismo mundo)
• Mensajes privados con /msg (el mensaje es totalmente rosa)
• Comando de administrador para limpiar el chat (Global + Local)
• Comando de administrador para inspeccionar/debugar variables de chat
• Configuración de radio local solo para administradores (persiste después del reinicio)
• Modo de bloqueo de chat solo para administradores (desactiva el chat para jugadores normales)
• Lista blanca de administradores de chat: se puede permitir a los jugadores hablar incluso mientras el chat está desactivado
• Soporte opcional para TinyMessage/TinyMsg para mejores colores/formato

Instalación

• Compila el plugin y obtén el .jar generado.
• Mueve el .jar del plugin a:
  • mods/
• (Opcional, recomendado) Instala TinyMessage/TinyMsg:
  • Mueve tinymessage-*.jar a mods/
• Reinicia el servidor.

Con TinyMessage/TinyMsg instalado, los colores y el formato del chat se ven mejor.

Cómo Funciona

• Cuando un jugador se une, su canal de chat predeterminado es Local.

• El chat local solo se entrega a los jugadores:
  • en el mismo mundo
  • dentro del radio configurado (en bloques)

• Cuando el chat está desactivado a través de /chatdisable, solo:

  • los administradores del servidor (que pueden ejecutar comandos de administrador), y/o
  • los jugadores añadidos con /chatadmin add ...

  podrán enviar mensajes de chat (Global/Local).

“Mini” Tutorial

Comandos

Todos (sin permisos requeridos)

• /g

  • Cambia al canal de chat Global.

• /l

  • Cambia al canal de chat Local (basado en distancia).

• /msg <jugador> <mensaje...>

  • Envía un mensaje privado a otro jugador (totalmente rosa).
  • Ejemplo: /msg player2 oi tudo bem com voce ?

Comandos solo para administradores

• /localradius <número>

  • Establece el radio de chat local en bloques.
  • El valor predeterminado es 50.
  • Este valor se guarda/persiste después del reinicio.
  • Ejemplo: /localradius 80

• /clearchat

  • Limpia el chat del juego para todos los jugadores en línea (Global + Local).
  • Alias: /cc

• /chatdebug

  • Muestra información de depuración / variables relacionadas con el chat del servidor (útil para verificar configuraciones/estado actuales).

• /chatdisable

  • Activa/desactiva el modo de bloqueo de chat:
  • Si el chat está habilitado: desactiva el chat para jugadores normales (solo los roles/usuarios permitidos pueden hablar).
  • Si el chat está desactivado: habilita el chat globalmente de nuevo.
  • Alias: /cdb

• /chatadmin

  • Gestiona la lista blanca de administradores de chat (jugadores que pueden hablar mientras el chat está desactivado).

  • Variantes:

  • /chatadmin add (<Jugador> o <UUID>)

  • Añade permiso de administrador de chat al jugador elegido (permite hablar incluso si el chat está desactivado).
  • Ejemplo: /chatadmin add PlayerName
  • Ejemplo: /chatadmin add 123e4567-e89b-12d3-a456-426614174000

  • /chatadmin remove (<Jugador> o <UUID>)

  • Elimina el permiso de administrador de chat del jugador elegido.

  • /chatadmin list

  • Lista todos los jugadores (y sus UUIDs) que actualmente tienen permiso de administrador de chat.

Permisos / Acceso

Este plugin utiliza dos niveles de acceso prácticos:

• Todos (permiso cero):

  • /g, /l, /msg

• Nivel de administrador:

  • /localradius, /clearchat (/cc), /chatdebug, /chatdisable (/cdb), /chatadmin ...

Adicionalmente:

• Administradores de chat (lista blanca) son gestionados por administradores a través de /chatadmin add/remove/list.
• Los administradores de chat son los jugadores que pueden seguir hablando cuando el chat está desactivado.

Persistencia (Radio Local)

El radio local se guarda en un archivo de configuración y persiste después de un reinicio.

Ruta de respaldo predeterminada: ./plugins/com.example_ChatInteractions/localglobalchat.properties

Ejemplo de contenido (localglobalchat.properties):

Ejemplo de clave almacenada: localRadius=50

Notas

• Filtrado de chat local:
  • Mismo mundo
  • Distancia ≤ radio configurado
• El plugin utiliza automáticamente TinyMsg si está instalado.