Guía: Crea tu Primer Plugin de Hytale (Java)

¿Sueñas con personalizar tu experiencia en Hytale? El desarrollo de plugins en Java es la puerta a infinitas posibilidades. Esta guía te llevará paso a paso a través de la creación de tu primer plugin usando la plantilla oficial de la comunidad.

Modding en Hytale: Enfoque "Server-First"

En Hytale, todo se gestiona del lado del servidor. Incluso jugando solo, tu juego corre en un servidor local. Tus plugins corren en este servidor, asegurando que todos los jugadores conectados experimenten lo mismo sin descargar mods del lado del cliente.

Prerrequisitos

1. Java 25 JDK: Hytale requiere esta versión específica.
2. IntelliJ IDEA: El entorno de desarrollo recomendado.

Paso 1: Preparación del Proyecto

Para evitar errores, usamos una plantilla pre-configurada:

1. Descarga la plantilla del repositorio de GitHub.
2. Extrae el archivo.
3. Configura ANTES de abrir IntelliJ:
   • Edita settings.gradle: cambia rootProject.name = 'MyFirstPlugin'.
   • Edita gradle.properties: define tu maven_group.
4. Importa en IntelliJ como proyecto Gradle.

Paso 2: El Manifiesto (manifest.json)

Ubicado en src/main/resources/manifest.json. Es el DNI de tu plugin.

{
  "Name": "MyFirstPlugin",
  "Version": "1.0.0",
  "Main": "com.hytalegame.myfirstplugin.MyFirstPlugin",
  "Description": "My first test plugin",
  ...
}

Paso 3: El Código Java

Crea tu clase principal heredando de JavaPlugin.

public class MyFirstPlugin extends JavaPlugin {
    @Override
    public void start() {
        getLogger().at(Level.INFO).log("MyFirstPlugin has started successfully!");
        getCommandRegistry().registerCommand(new SimpleCommand());
    }
}

Paso 4: Tu Primer Comando

Crea una clase SimpleCommand.

public class SimpleCommand extends AbstractCommand {
    public SimpleCommand() {
        super("myplugin", "Muestra un mensaje de bienvenida.");
    }

    @Override
    protected CompletableFuture<Void> execute(CommandContext context) {
        context.sender().sendMessage(Message.raw("¡Felicidades! ¡Tu plugin funciona!"));
        return null;
    }
}

Paso 5: Lanzamiento y Prueba

La plantilla incluye una configuración de ejecución "HytaleServer".

1. Dale al Play en IntelliJ.
2. Autenticación (Solo primera vez): Escribe auth login device en la consola y sigue los pasos. Luego auth persistence Encrypted.
3. Entra al juego (IP: localhost) y prueba /myplugin.

Paso 6: Compilar

Usa la pestaña Gradle en IntelliJ: Tasks -> build -> build. Tu .jar aparecerá en build/libs/. ¡Listo para compartir!

Fuente: Enlace original