MAC (ModList And Config)

MAC añade una lista de mods en el juego con metadatos ricos y un editor de configuración al que otros plugins pueden acceder con una pequeña llamada de registro. Descubre mods, muestra estado/iconos y expone la configuración de tu plugin como campos editables.

Características

• Lista de mods con nombre, versión, autores, descripción, sitio web, habilitado/deshabilitado, insignia de paquete de recursos
• Clasificación de lista agrupada + filtros + búsqueda
• Editor de configuración con recargas en vivo (booleano, número, control deslizante, enumeración, color, archivo, cadena)
• Iconos por mod e iconos de respaldo para Hytale/Hypixel y activos faltantes

Instalación

Coloca el mod MAC en tu carpeta de mods. Incluye un paquete de recursos y se cargará automáticamente.

Para desarrolladores: añadiendo configuraciones a tu plugin

MAC lee un esquema de configuración registrado en el código y genera automáticamente el archivo de configuración en disco. Los valores predeterminados provienen de la cadena de construcción (sin archivos de configuración de recursos).

1) Registrar un esquema de configuración

Usa PluginConfig.register(...) en la configuración de tu plugin:

PluginConfig<MySettings> config = PluginConfig.register(
    this.getLogger(),
    new PluginIdentifier(this.getManifest()),
    MySettings.class,
    MySettings::new,
    builder -> builder
        .add.booleanField("Habilitar Característica").defaultsTo(true)
        .add.slider("Conteo Máximo", 1, 100, 1).defaultsTo(50)
        .add.enumField("Modo", "seguro", "rápido", "salvaje").defaultsTo("seguro")
        .add.color("Color de Acento").defaultsTo("#1aa3a3")
        .add.file("Archivo de Icono", "Común/UI/Personalizado", "png").defaultsTo("")
        .add.stringField("Nota de Pie").defaultsTo("")
);

El archivo de configuración se escribe en:
config/<GRUPO>/<NOMBRE>_Config.json

El orden del esquema se preserva en la interfaz de usuario.

Valores predeterminados de configuración

Tu clase de configuración puede tener campos simples sin inicializadores. Los valores predeterminados se definen con
.defaultsTo(...) en el constructor del esquema.

Iconos

MAC busca un icono por mod en:
UI/Custom/<GRUPO>_<NOMBRE>.png
Esto coincide con las rutas de iconos de Better Modlist para compatibilidad:
https://www.curseforge.com/hytale/mods/better-modlist
por lo que los desarrolladores solo necesitan una ubicación de icono.

Respaldo:

• Grupo Hytale/Hypixel -> Icons/ItemCategories/Hypixel.png
• Icono faltante -> Icons/ItemCategories/Natural.png

Configuraciones de la lista de mods (configuración propia de MAC)

La configuración de MAC controla:

• Mostrar Hytale
• Solo con Descripciones
• Máximas Entradas Visibles
• Colores de insignia (versión/habilitado/deshabilitado/activos)

Este archivo es:
config/LYIVX/MAC_Config.json

Notas

• La interfaz de usuario de configuración solo edita claves presentes en el esquema registrado.
• Las claves desconocidas se preservan en memoria pero se eliminan del archivo en disco cuando se detectan.

Importante

• Si usas el sistema de configuración de MAC, tu mod depende de que MAC esté instalado. Eso significa que otros navegadores de lista de mods/configuración no funcionarán para tu mod a menos que MAC esté presente. Las futuras actualizaciones tienen como objetivo soportar configuraciones que funcionen sin requerir MAC como una dependencia estricta.
  Ejemplo completo

import com.hypixel.hytale.common.plugin.PluginIdentifier;

import com.hypixel.hytale.logger.HytaleLogger;

import net.lyivx.mac.config.PluginConfig;

public final class ExampleConfig {

    public static class Settings {

        public boolean enableFeature;

        public int maxCount;

        public String mode;

        public String accentColor;

        public String iconFile;

        public String footerNote;

    }
    public static PluginConfig<Settings> register(HytaleLogger logger, PluginIdentifier identifier) {

        return PluginConfig.register(

            logger,

            identifier,

            Settings.class,

            Settings::new,

            builder -> builder

                .add.booleanField("Habilitar Característica").defaultsTo(true)

                .add.slider("Conteo Máximo", 1, 100, 1).defaultsTo(50)

                .add.enumField("Modo", "seguro", "rápido", "salvaje").defaultsTo("seguro")

                .add.color("Color de Acento").defaultsTo("#1aa3a3")

                .add.file("Archivo de Icono", "Común/UI/Personalizado", "png").defaultsTo("")

                .add.stringField("Nota de Pie").defaultsTo("")

        );

    }

}