Complementos de Servidor en Hytale: configuración del entorno de desarrollo

Modificar Hytale requiere preparar un entorno de desarrollo completo, incluyendo todas las herramientas y dependencias necesarias para crear complementos (plugins) de servidor de manera eficiente.

Esta guía cubre desde los prerrequisitos hasta los primeros pasos para comenzar a desarrollar tus propios mods.

Cómo crear un MOD de Hytale: Guía completa paso a paso desde cero

Prerrequisitos

Antes de configurar tu entorno de desarrollo, asegúrate de contar con:

• Una computadora con Windows 10/11, macOS o Linux
• Al menos 8 GB de RAM
• 10 GB de espacio libre en disco
• Privilegios administrativos en tu sistema

Software requerido

Para trabajar con complementos de Hytale necesitarás instalar varias herramientas clave:

1. Kit de desarrollo de Java (JDK)

Hytale requiere Java 25 o posterior, preferiblemente OpenJDK.

Ventanas

1. Descargar OpenJDK 25 desde Adoptium
2. Ejecutar el instalador con la configuración predeterminada
3. Verificar la instalación ejecutando en el Símbolo del sistema:

java -version

macOS

# Using Homebrew
brew install openjdk@25

Linux (Ubuntu/Debian)

sudo apt update
sudo apt install openjdk-25-jdk

2. Entorno de desarrollo integrado (IDE)

Se recomienda IntelliJ IDEA Community Edition:

1. Descargar desde el sitio web de JetBrains
2. Instalar con la configuración predeterminada
3. Iniciar IntelliJ y completar el asistente de configuración inicial

3. Maven

Maven es necesario para manejar dependencias y construir proyectos:

1. Visitar el sitio web oficial
2. Descargar apache-maven-3.9.12-bin.zip
3. Descomprimir el archivo
4. Añadir apache-maven-3.9.12/bin/ a tu PATH

Verifica la instalación ejecutando:

mvn -version

Asegúrate de abrir una nueva terminal para que los cambios en el PATH surtan efecto.

Configuración de su espacio de trabajo

1. Clonar la plantilla del complemento

En lugar de crear un proyecto vacío, usa la plantilla oficial de Hytale:

# Clone the template repository
git clone https://github.com/HytaleModding/plugin-template.git MyFirstMod
cd MyFirstMod

2. Abrir en IntelliJ IDEA

1. Abrir IntelliJ IDEA
2. Hacer clic en “Abrir” y navegar al directorio MyFirstMod
3. IntelliJ detectará automáticamente un proyecto Maven
4. Esperar a que el proyecto se indexe y se descarguen las dependencias

3. Agregar la dependencia HytaleServer.jar

Antes de comenzar a modificar, necesitas agregar HytaleServer.jar:

1. Descargar usando Hytale Downloader

2. En IntelliJ IDEA:

   • Hacer clic en Archivo → Estructura del proyecto
   • Ir a Bibliotecas
   • Hacer clic en el icono +
   • Seleccionar HytaleServer.jar descargado

4. Agregar HytaleServer a tus artefactos

⚠ Advertencia: Esta es una solución temporal hasta que haya un repositorio Maven oficial.

Ejecuta en la consola:

mvn install:install-file -Dfile=[ROUTE TO HytaleServer.jar] -DgroupId=com.hypixel.hytale -DartifactId=HytaleServer-parent -Dversion=1.0-SNAPSHOT -Dpackaging=jar

• Reemplaza [ROUTE TO HytaleServer.jar] con la ruta real al archivo en tu sistema

Próximos pasos

Con tu entorno de desarrollo listo y la plantilla configurada, puedes comenzar a crear tu primer complemento:

1. Personaliza la plantilla: editar pom.xml y manifest.json para cambiar nombre y detalles de tu mod
2. Explora la estructura del código: familiarízate con la organización de la plantilla
3. Comienza a modificar: empieza a escribir tu primer complemento

Aprende a:

• Crear comandos
• Crear eventos

Y mucho más, la documentación completa incluye todas las funciones disponibles y mejores prácticas de desarrollo.