E-Utils

 

EverlastingUtils (Hytale)

Nota: Si estás viendo esto como una dependencia o requisito para otro mod, simplemente puedes instalarlo e ignorar esta documentación.

 

EverlastingUtils es una robusta biblioteca de utilidades para el desarrollo de servidores Hytale. Abstrae el complejo código boilerplate, permitiendo a los desarrolladores centrarse en las características del juego en lugar de la infraestructura.

Características

Gestión Avanzada de Configuración

Un puerto directo de un robusto sistema de configuración JSONC.

• Soporte JSONC: Soporta completamente comentarios (// y /* */) en archivos de configuración.
• Recarga en Caliente: Detecta automáticamente cambios en los archivos y recarga las configuraciones en tiempo de ejecución sin reiniciar el servidor.
• Auto-Guardado y Copia de Seguridad: Generación automática de copias de seguridad y guardado automático incorporado antes de las migraciones.
• Versionado: Maneja las actualizaciones de versión de configuración automáticamente.

Hilos y Programación

Un envoltorio seguro para gestionar tareas en el entorno de Hytale.

• Seguridad: Previene errores comunes de concurrencia al definir explícitamente la ejecución Asincrónica vs Sincrónica.
• Limpieza: Rastrea y cancela automáticamente tareas al cerrar el plugin.
• API Unificada: Métodos estáticos simples para ejecutar tareas únicas o repetitivas.

Análisis de Color

Conectando el vacío entre flujos de trabajo heredados y el sistema de componentes de Hytale.

• Soporte Heredado: Analiza los códigos clásicos &a, &l, &f en objetos Message de Hytale.
• Soporte Hex: Mapea automáticamente los códigos de color estándar a valores Hex específicos.

 

Ejemplos de Uso

1. Gestión de Configuración

Crea tu clase de configuración implementando ConfigManager.ConfigData:

public class MyConfig implements ConfigManager.ConfigData {
    // Métodos requeridos
    @Override public String getVersion() { return "1.0.0"; }
    @Override public String getConfigId() { return "my_plugin"; }

    // Tus Ajustes
    public boolean debugMode = false;
    public String welcomeMessage = "Hello World";
}

Inicialízalo en tu clase principal:

// Configurar Metadatos (Comentarios de encabezado, etc)
ConfigMetadata meta = ConfigMetadata.createDefault("my_plugin");

// Inicializar Gestor
ConfigManager<MyConfig> configManager = new ConfigManager<>(
    MyConfig.class, 
    new MyConfig(), 
    meta
);

// Acceder a valores en cualquier lugar
boolean isDebug = configManager.getConfig().debugMode;

 

2. Programación de Tareas

Inicializa el programador en el inicio de tu plugin (para engancharse al hilo principal del juego):

@Override
public void onServerStarted() {
    // Engancharse al ejecutor del hilo principal de Hytale
    SchedulerManager.init(runnable -> 
        HytaleServer.getInstance().getScheduler().execute(runnable)
    );
}

Programa tareas fácilmente:

// Ejecutar una tarea 5 segundos después en el Hilo Principal (Sincrónico)
SchedulerManager.schedule("my_task_id", 5, TimeUnit.SECONDS, false, () -> {
    player.sendMessage(Message.raw("¡Mensaje retrasado!"));
});

// Ejecutar una tarea asíncrona genérica de inmediato
SchedulerManager.schedule("async_calc", 0, TimeUnit.SECONDS, true, () -> {
    // Cálculo pesado aquí...
});

 

3. Análisis de Color

Envía fácilmente mensajes formateados utilizando códigos heredados:

String rawText = "&a¡Éxito! &7Has recibido &e100 Monedas&7.";
Message message = ColorParser.parse(rawText);

player.sendMessage(message);

 

Instalación para Desarrolladores

Agrega la biblioteca a tu build.gradle.kts.

1. Agrega el jar a una carpeta libs

C:UsersAdministratorDesktopModsEventAntiXraylibseverlastingutils-1.0.0.jar

2. Agrega la Dependencia: Dado que EverlastingUtils es un mod independiente, usa compileOnly para que no se incluya dentro de tu jar:

dependencies {
    compileOnly("com.hysocs:everlastingutils:1.0.0")
    // O si usas un jar local en libs/
    // compileOnly(files("libs/everlastingutils-1.0.0.jar"))
}

Nota: Asegúrate de que el jar de EverlastingUtils esté presente en la carpeta mods de tu servidor durante la ejecución.