Estructura de los archivos

Esta guía explica la estructura de archivos de un servidor de Hytale, así como la organización interna de los mundos (universe).
Conocer esta estructura te ayudará a administrar mods, mundos y configuraciones correctamente.

Estructura principal del servidor

En la raíz del servidor encontrarás las siguientes carpetas y archivos:

.cache/

Carpeta utilizada para almacenar archivos temporales y optimizados con el fin de mejorar el rendimiento del servidor. No se recomienda borrar su contenido mientras el servidor esté en funcionamiento.

logs/

Contiene los registros del servidor. Es útil para revisar errores, advertencias, caídas del servidor o problemas relacionados con mods y configuraciones.

mods/

En esta carpeta se instalan todos los mods del servidor. Cada mod suele tener su propio archivo o carpeta. Después de añadir o eliminar mods, normalmente es necesario reiniciar el servidor.

universe/

Carpeta principal donde se almacenan los mundos, los datos de los jugadores y el progreso del servidor. Es una de las carpetas más importantes.

Archivos de configuración

bans.json

Contiene la lista de jugadores baneados del servidor.

whitelist.json

Lista de jugadores autorizados a entrar al servidor cuando la whitelist está activada.

permissions.json

Archivo donde se definen los permisos de jugadores y grupos, controlando el acceso a comandos y acciones.

config.json

Archivo principal de configuración del servidor. Aquí se definen los parámetros globales y el comportamiento general del servidor.

Estructura del Universe (Mundos)

Dentro de la carpeta universe/worlds/ se encuentran todos los mundos jugables del servidor. Cada mundo cuenta con su propio archivo config.json, permitiendo configuraciones independientes.

Configuración de un mundo (config.json)

El archivo config.json de cada mundo controla su comportamiento y reglas de juego. Algunos de los parámetros más importantes son:

• Version: Versión del formato del mundo.
• UUID: Identificador único del mundo.
• Seed: Semilla utilizada para la generación del mundo.
• WorldGen: Define el tipo y nombre del generador del mundo.
• IsPvpEnabled: Activa o desactiva el PvP.
• IsFallDamageEnabled: Controla el daño por caída.
• IsGameTimePaused: Pausa o reanuda el tiempo del mundo.
• GameTime: Tiempo actual del mundo.
• IsSpawningNPC: Permite la aparición de NPCs.
• IsAllNPCFrozen: Congela todos los NPCs.
• IsSavingPlayers: Guarda los datos de los jugadores.
• IsSavingChunks: Guarda los chunks del mundo.
• IsUnloadingChunks: Descarga chunks no utilizados.
• RequiredPlugins: Plugins necesarios para el mundo.

Rendimiento y procesamiento

Cada mundo se ejecuta en su propio hilo principal y las tareas paralelas se procesan mediante un thread pool compartido. Esto permite un mejor rendimiento y una experiencia más estable cuando hay varios mundos activos.

Recomendaciones

• Realiza copias de seguridad de la carpeta universe/ antes de realizar cambios.
• No edites archivos de configuración mientras el servidor esté encendido.
• Revisa la carpeta logs/ si el servidor presenta errores.
• Los cambios en mods o mundos suelen requerir reiniciar el servidor.