EtherTitle

 

EtherTitle es un plugin para servidores de Hytale que permite a los administradores crear, gestionar y mostrar mensajes de título personalizados a los jugadores. Los títulos aparecen en el centro de la pantalla del jugador, similar a las notificaciones de logros o anuncios de eventos.

Características

• Crear múltiples configuraciones de títulos nombrados
• Establecer texto personalizado para el título principal y el subtítulo
• Mostrar títulos a todos los jugadores conectados
• Almacenamiento persistente utilizando JSON
• Interfaz simple basada en comandos

Instalación

Coloca el archivo JAR del plugin en la carpeta mods de tu servidor

Inicia o reinicia tu servidor de Hytale

El plugin creará automáticamente un directorio mods/EtherTitle

Se generará un archivo titles.json con ejemplos predeterminados

 
Comandos

Comando Principal

/ethertitle

Muestra el menú de ayuda con todos los subcomandos disponibles.

Crear un Título

/ethertitle create <nombre>

Crea una nueva configuración de título vacía con el nombre especificado.

Ejemplo:

/ethertitle create hola

Salida:

Título 'hola' creado con éxito!
Ahora puedes configurarlo:
  /ethertitle addtitle hola <text>
  /ethertitle addsubtitle hola <text>

Agregar Texto del Título Principal

/ethertitle addtitle <nombre> <text>

Establece el texto del título principal (texto grande mostrado en el centro).

Ejemplo:

/ethertitle addtitle hola ¡Bienvenido!

Salida:

Título principal agregado a 'hola'
Vista previa: ¡Bienvenido!

Agregar Texto del Subtítulo

/ethertitle addsubtitle <nombre> <text>

Establece el texto del subtítulo (texto más pequeño mostrado debajo del título principal).

Ejemplo:

/ethertitle addsubtitle hola Disfruta tu estadía

Salida:

Subtítulo agregado a 'hola'
Vista previa: Disfruta tu estadía

Mostrar Título a los Jugadores

/ethertitle show <nombre>

Muestra el título configurado a todos los jugadores en línea.

Ejemplo:

/ethertitle show hola

Salida:

Título 'hola' mostrado!

Lo que ven los jugadores:

• Título principal: “¡Bienvenido!” (texto grande, centro de la pantalla)
• Subtítulo: “Disfruta tu estadía” (texto más pequeño debajo)
• Temporización predeterminada: 0.5s desvanecimiento, 3.5s visualización, 1s desvanecimiento

Listar Todos los Títulos

/ethertitle list

Muestra todas las configuraciones de títulos creadas.

Ejemplo de Salida:

===========================
  Títulos (2)
===========================

> hola
  Título: ¡Bienvenido!
  Subtítulo: Disfruta tu estadía

> welcome
  Título: ¡BIENVENIDO!
  Subtítulo: Disfruta tu estadía en el servidor
===========================

Eliminar un Título

/ethertitle delete <nombre>

Elimina una configuración de título de forma permanente.

Ejemplo:

/ethertitle delete hola

Salida:

Título 'hola' eliminado!

Recargar Títulos

/ethertitle reload

Recarga todos los títulos desde el archivo titles.json.

Ejemplo de Salida:

Títulos recargados!
Total: 2 títulos

Ejemplo Completo de Uso

A continuación se muestra un ejemplo paso a paso para crear un título llamado “hola”:

# Paso 1: Crear la configuración del título
/ethertitle create hola
# Salida: Título 'hola' creado con éxito!

# Paso 2: Establecer el texto del título principal
/ethertitle addtitle hola ¡Bienvenido al Servidor!
# Salida: Título principal agregado a 'hola'
# Salida: Vista previa: ¡Bienvenido al Servidor!

# Paso 3: Establecer el texto del subtítulo
/ethertitle addsubtitle hola Diviértete y disfruta tu aventura
# Salida: Subtítulo agregado a 'hola'
# Salida: Vista previa: Diviértete y disfruta tu aventura

# Paso 4: Mostrar el título a todos los jugadores
/ethertitle show hola
# Salida: Título 'hola' mostrado!
# Todos los jugadores en línea verán el título en su pantalla

# Paso 5: Verificar que fue creado
/ethertitle list
# La salida muestra:
# > hola
#   Título: ¡Bienvenido al Servidor!
#   Subtítulo: Diviértete y disfruta tu aventura

Almacenamiento de Datos

Ubicación del Archivo

mods/EtherTitle/titles.json

Estructura JSON

{
  "hola": {
    "title": "¡Bienvenido al Servidor!",
    "subtitle": "Diviértete y disfruta tu aventura",
    "fadeIn": 10,
    "stay": 70,
    "fadeOut": 20
  },
  "welcome": {
    "title": "¡BIENVENIDO!",
    "subtitle": "Disfruta tu estadía en el servidor",
    "fadeIn": 10,
    "stay": 70,
    "fadeOut": 20
  }
}

Valores de Temporización

• fadeIn: Ticks para la animación de desvanecimiento (10 ticks = 0.5 segundos)
• stay: Ticks para mostrar el título (70 ticks = 3.5 segundos)
• fadeOut: Ticks para la animación de desvanecimiento (20 ticks = 1 segundo)

 

Títulos Predeterminados

El plugin viene con dos títulos de ejemplo:

1. “hola”

• Título: ¡Hola Mundo!
• Subtítulo: Bienvenido al servidor

2. “welcome”

• Título: ¡BIENVENIDO!
• Subtítulo: Disfruta tu estadía en el servidor

Detalles Técnicos

Cómo se Muestran los Títulos

El plugin utiliza el método EventTitleUtil.showEventTitleToPlayer() de Hytale para mostrar títulos directamente en el centro de la pantalla de cada jugador. Este es el mismo sistema utilizado para notificaciones de eventos y logros.

Objetivo de los Jugadores

Al usar /ethertitle show <nombre>, el plugin:

Recupera todos los jugadores actualmente en línea del Universo

Valida cada referencia de jugador

Envía el mensaje del título a cada jugador válido

Utiliza los valores de temporización configurados (fadeIn, stay, fadeOut)

Persistencia

• Todas las configuraciones de títulos se guardan automáticamente en titles.json
• Los cambios se guardan inmediatamente después de cada comando
• El archivo se carga cuando se inicia el plugin
• Usa /ethertitle reload para actualizar manualmente desde el disco

Mensajes de Error

Mensaje
Causa
Solución

¡El título 'hola' no existe!
Intentando modificar/mostrar un título inexistente
Créalo primero con /ethertitle create hola

¡El título 'hola' ya existe!
Intentando crear un título duplicado
Usa un nombre diferente o elimina el existente

¡Error al mostrar el título!
Error interno durante la visualización
Revisa los registros del servidor para más detalles

Permisos

Actualmente, el plugin no implementa un sistema de permisos. Todos los comandos pueden ser ejecutados por cualquier jugador con acceso a comandos. Esto puede ser modificado en versiones futuras.

Información de la Versión

• Versión del Plugin: 1.0.0
• API de Hytale: Compatible con la API del Servidor Hytale de Hypixel
• Dependencias: Ninguna (usa solo las API principales de Hytale)