MAutoModGenerator – Easily patch other mods files (interface, language and more!)

MAutoModGenerator – Generador de Mods Automático para Hytale

Un plugin generador de mods automatizado para servidores de Hytale que construye automáticamente archivos jar de mods a partir de directorios de origen configurados.

Resumen

MAutoModGenerator es un plugin que genera automáticamente archivos jar de mods de Hytale al recopilar archivos de directorios de origen configurados y crear un paquete de mod adecuado con manifest.json. Esto es útil para empaquetar contenido personalizado, activos o configuraciones en archivos de mod distribuibles.

Caso de Uso Principal: Parcheo de Mods de Activos

El propósito principal de MAutoModGenerator es simplificar la creación de mods de activos, especialmente para parchear otros mods.

Dado que Hytale carga los mods en un orden específico, los mods generados por MAutoModGenerator siempre se cargan al final. Esto lo hace perfecto para crear mods de parche que sobrescriben o extienden archivos de otros mods:

• Archivos de Idioma: Reemplazar o agregar traducciones a mods existentes
  • Corregir errores de traducción en otros mods
  • Agregar nuevas traducciones de idiomas para mods que aún no han sido traducidos
  • Personalizar texto y mensajes para que coincidan con el estilo de tu servidor
• Imágenes y Texturas: Sobrescribir texturas, íconos y elementos de UI
  • Reemplazar texturas con versiones personalizadas
  • Actualizar elementos de UI para que coincidan con el tema de tu servidor
  • Corregir errores visuales o inconsistencias
• Archivos de Interfaz: Modificar componentes y diseños de UI
  • Personalizar elementos de interfaz
  • Ajustar diseños y estilos
  • Agregar o modificar componentes de UI

Cómo funciona: Simplemente coloca los archivos que deseas sobrescribir en el directorio files con la misma estructura de ruta que el mod original. Cuando se carga el mod generado, reemplazará los archivos de los mods originales.

Ejemplo: Para parchear un archivo de idioma de otro mod ubicado en Server/Languages/pt-BR/somemod.lang, simplemente coloca tu archivo personalizado en files/Server/Languages/pt-BR/somemod.lang en el directorio de archivos de MAutoModGenerator.

Características

• Construcción Automática de Mods: Construye automáticamente archivos jar de mods en la inicialización del plugin
• Directorios de Origen Configurables: Soporta múltiples directorios de origen para recopilar archivos
• Generación Automática de Manifest: Genera manifest.json basado en la configuración
• Reconstrucción Basada en Comandos: Reconstruye mods bajo demanda usando el comando /mautomodgenerator rebuild
• Directorio de Origen Predeterminado: Incluye automáticamente archivos del directorio config/com.machina/mautomodgenerator/files

Instalación

Coloca el archivo JAR del plugin MAutoModGenerator en el directorio mods o builtin de tu servidor Hytale

Asegúrate de tener el archivo HytaleServer.jar en el directorio lib/

Reinicia el servidor o recarga los plugins

El plugin construirá automáticamente el mod en la primera carga

Configuración

Todas las configuraciones se gestionan a través del archivo config.json5 en el directorio de datos del plugin.

Configuración del Manifest

{
    "manifest": {
        "group": "com.machina",
        "name": "mautomodgenerator-pack",
        "version": "1.0.0",
        "author": "Machina",
        "description": "Un mod que genera mods automáticamente"
    }
}

Opciones de Configuración:

• manifest.group: El identificador del grupo del mod (debe ser compatible con archivos: ^[a-zA-Z0-9_.-]+$)
• manifest.name: El nombre del mod (debe ser compatible con archivos: ^[a-zA-Z0-9_.-]+$)
• manifest.version: La versión del mod (por ejemplo, “1.0.0”)
• manifest.author: El nombre del autor
• manifest.description: La descripción del mod

Configuración de Directorios de Origen

{
    "src": {
        "directories": [
            "/path/to/custom/files",
            "/another/path/to/files"
        ]
    }
}

Opciones de Configuración:

• src.directories: Lista de directorios para recopilar archivos (opcional)
  • El plugin incluye automáticamente config/com.machina/mautomodgenerator/files por defecto
  • Se pueden especificar directorios adicionales en esta lista
  • Todos los archivos de estos directorios se incluirán en el archivo jar de mod generado

Uso

Construcción Automática

El mod se construye automáticamente cuando:

• El plugin se carga por primera vez
• El servidor se inicia con el plugin habilitado

El archivo jar de mod generado se creará en el directorio raíz del servidor con el formato: {group}-{name}.zip

Ejemplo: com.machina-mautomodgenerator-pack.zip

Reconstrucción Manual

Puedes reconstruir manualmente el mod en cualquier momento usando el comando:

/mautomodgenerator rebuild

O usando el alias:

/mamg rebuild

Permiso: Requiere mautomodgenerator.command.rebuild.permission

Cómo Funciona

Recopilación de Archivos: El plugin escanea todos los directorios de origen configurados (incluyendo el predeterminado config/com.machina/mautomodgenerator/files)

Generación de Manifest: Crea un archivo manifest.json basado en tu configuración

Creación de jar: Empaqueta todos los archivos recopilados junto con el manifest en un archivo jar

Salida: El jar de mod generado se guarda en el directorio raíz del servidor

Estructura de Archivos

El jar de mod generado tendrá la siguiente estructura:

mod.zip
├── manifest.json
├── (archivos de directorios de origen)
└── ...

Ejemplos de Casos de Uso

• 🩹 Parcheo de Mods (Caso de Uso Principal): Crear mods de parche para sobrescribir archivos de otros mods
  • Parcheos de Idioma: Corregir traducciones, agregar nuevos idiomas o personalizar texto
  • Parcheos de Textura: Reemplazar imágenes, íconos y activos visuales
  • Parcheos de UI: Modificar elementos y diseños de interfaz
• Packs de Activos: Empaquetar texturas, modelos o sonidos personalizados en un mod distribuible
• Mods de Configuración: Agrupar configuraciones del servidor o reglas de juego personalizadas
• Packs de Contenido: Crear mods con contenido personalizado que se pueden distribuir fácilmente
• Flujo de Trabajo de Desarrollo: Empaquetar automáticamente mods durante el desarrollo

Notas

• El archivo jar de mod generado se crea en el directorio raíz del servidor
• Las rutas de archivos en el jar son relativas a los directorios de origen
• El plugin valida que el grupo y el nombre sean compatibles con archivos (solo alfanuméricos, puntos, guiones bajos, guiones)
• Todos los archivos de los directorios de origen se incluyen de forma recursiva (se procesan subdirectorios)

Comunidad

💬 ¡Únete a nuestra comunidad de Discord!

Obtén ayuda, comparte tus ideas y conéctate con otros desarrolladores:

• 🆘 Soporte: Obtén ayuda con la configuración y la solución de problemas
• 💡 Sugerencias: Comparte tus ideas y comentarios
• 🤝 Comunidad: Conéctate con otros desarrolladores de Hytale

👉 Únete al Servidor de Discord

Desarrollado por Machina Studios – Soluciones Profesionales para Servidores de Hytale