Zum Inhalt

Requisitos

Antes de comenzar a desarrollar plugins para Hytale, asegúrate de tener los siguientes requisitos.

Software Requerido

Java Development Kit (JDK)

  • Versión: JDK 17 o superior
  • Recomendado: JDK 21 (LTS)

El código de Hytale está compilado con Java 17+. Necesitarás el JDK completo (no solo el JRE) para compilar plugins.

Descarga: - Oracle JDK - OpenJDK - Amazon Corretto

Verificar instalación: 

java -version
javac -version

IDE (Entorno de Desarrollo)

Se recomienda usar uno de estos IDEs:

IntelliJ IDEA (Recomendado)

  • Versión: Community o Ultimate
  • Ventajas: Excelente soporte para Java, refactoring, debugging
  • Descarga: jetbrains.com/idea

Eclipse

  • Versión: Eclipse IDE for Java Developers
  • Descarga: eclipse.org

Visual Studio Code

Build Tool

Elige uno de estos sistemas de construcción:

Gradle (Recomendado)

plugins {
    id 'java'
}

group = 'com.ejemplo.miplugin'
version = '1.0.0'

sourceCompatibility = '17'
targetCompatibility = '17'

repositories {
    mavenCentral()
}

dependencies {
    // API de Hytale (descompilada)
    compileOnly files('libs/hytale-api.jar')

    // Librerías para manipulación de bytecode
    implementation 'org.ow2.asm:asm:9.6'
    implementation 'org.ow2.asm:asm-commons:9.6'
}

Maven

<project>
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.ejemplo</groupId>
    <artifactId>miplugin</artifactId>
    <version>1.0.0</version>

    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.ow2.asm</groupId>
            <artifactId>asm</artifactId>
            <version>9.6</version>
        </dependency>
    </dependencies>
</project>

Herramientas Adicionales

Para Manipulación de Bytecode

ASM Library

Biblioteca para leer, escribir y transformar bytecode Java.

<dependency>
    <groupId>org.ow2.asm</groupId>
    <artifactId>asm</artifactId>
    <version>9.6</version>
</dependency>

ByteBuddy (Alternativa)

Framework de alto nivel para manipulación de bytecode.

<dependency>
    <groupId>net.bytebuddy</groupId>
    <artifactId>byte-buddy</artifactId>
    <version>1.14.11</version>
</dependency>

Para Debugging

JD-GUI

Descompilador Java para inspeccionar bytecode. - Descarga: java-decompiler.github.io

Recaf

Editor de bytecode Java avanzado. - Descarga: github.com/Col-E/Recaf

Conocimientos Recomendados

Esenciales

  • ✅ Java básico: Clases, interfaces, herencia
  • ✅ Programación orientada a objetos
  • ✅ Manejo de excepciones
  • ✅ Colecciones y genéricos

Avanzados (para Early Plugins)

  • 🔧 Bytecode Java: Entender el formato class
  • 🔧 ASM o ByteBuddy: Manipulación de bytecode
  • 🔧 ClassLoaders: Cómo Java carga clases
  • 🔧 Reflection API: Introspección en tiempo de ejecución

Útiles

  • 💡 Gradle/Maven: Gestión de dependencias
  • 💡 Git: Control de versiones
  • 💡 Debugging: Técnicas de depuración
  • 💡 Patrones de diseño: Singleton, Factory, Observer, etc.

Entorno de Pruebas

Servidor de Hytale

  • Necesitas una copia del servidor de Hytale
  • Recomendado: servidor de desarrollo separado
  • NO pruebes en servidores de producción

Estructura Mínima

hytale-dev/
├── earlyplugins/          # Early plugins aquí
├── plugins/               # Standard plugins aquí
├── hytale-server.jar      # Servidor
└── config/                # Configuración

Checklist

Antes de continuar, verifica que tienes:

  • JDK 17+ instalado y configurado
  • IDE instalado (IntelliJ IDEA recomendado)
  • Build tool configurado (Gradle o Maven)
  • Servidor de Hytale para pruebas
  • Descompilador Java (JD-GUI o similar)
  • Conocimientos básicos de Java

Siguiente Paso

Una vez que tengas todo listo, continúa con:

→ Instalación y Configuración

¿Problemas con los requisitos? Consulta Troubleshooting