Hytale Plugin Development

git clone https://github.com/realBritakee/hytale-template-plugin.git
cd hytale-template-plugin
./gradlew build

{
    "Group": "com.yourname",
    "Name": "MyPlugin",
    "Version": "1.0.0",
    "Description": "My first Hytale plugin",
    "Authors": [
        {
            "Name": "Your Name",
            "Email": "your.email@example.com",
            "Url": "https://your-website.com"
        }
    ],
    "Website": "https://your-plugin-website.com",
    "ServerVersion": "*",
    "Dependencies": {},
    "OptionalDependencies": {},
    "DisabledByDefault": false
}

plugins {
    id("java")
    id("com.github.johnrengelman.shadow") version "8.1.1"
}

java {
    toolchain {
        languageVersion.set(JavaLanguageVersion.of(25))
    }
}

dependencies {
    compileOnly("com.hypixel.hytale:hytale-server:+")
}

tasks.shadowJar {
    archiveClassifier.set("")
}

rootProject.name = 'my-plugin'

hytale_version=latest
plugin_version=1.0.0

package com.yourname.plugin;

import com.hypixel.hytale.server.core.plugin.JavaPlugin;
import com.hypixel.hytale.server.core.plugin.JavaPluginInit;
import javax.annotation.Nonnull;

public class MyPlugin extends JavaPlugin {

    public MyPlugin(@Nonnull JavaPluginInit init) {
        super(init);
        getLogger().info("MyPlugin loaded!");
    }

    @Override
    public void setup() {
        // Called after constructor
        // Register systems and load configs here
        getLogger().info("MyPlugin setup complete!");
    }

    @Override
    public void start() {
        // Called when server is ready
        // Register commands and event listeners here
        getLogger().info("MyPlugin started!");
    }

    @Override
    public void shutdown() {
        // Called when server stops
        // Save data and cleanup here
        getLogger().info("MyPlugin shutting down!");
    }
}

import com.hypixel.hytale.server.core.event.events.PlayerConnectEvent;
import com.hypixel.hytale.server.core.event.events.PlayerDisconnectEvent;
import com.hypixel.hytale.server.core.event.events.PlayerChatEvent;

@Override
public void start() {
    // Listen for player connect
    getEventRegistry().register(PlayerConnectEvent.class, event -> {
        var player = event.getPlayer();
        getLogger().info(player.getName() + " connected!");
    });

    // Listen for player disconnect
    getEventRegistry().register(PlayerDisconnectEvent.class, event -> {
        var player = event.getPlayer();
        getLogger().info(player.getName() + " disconnected!");
    });

    // Listen for chat (async event)
    getEventRegistry().registerAsync(PlayerChatEvent.class, future -> {
        return future.thenApply(event -> {
            String message = event.getMessage();
            getLogger().info("Chat: " + message);
            return event;
        });
    });
}

import com.hypixel.hytale.server.core.event.EventPriority;

// Run before other handlers
getEventRegistry().register(EventPriority.FIRST, PlayerConnectEvent.class, event -> {
    // This runs first
});

// Run after other handlers
getEventRegistry().register(EventPriority.LAST, PlayerConnectEvent.class, event -> {
    // This runs last
});

import com.hypixel.hytale.server.core.event.events.BreakBlockEvent;

getEventRegistry().register(BreakBlockEvent.class, event -> {
    var block = event.getBlock();

    // Prevent breaking bedrock
    if (block.getType().getName().equals("bedrock")) {
        event.setCancelled(true);
    }
});

import com.hypixel.hytale.server.core.command.AbstractPlayerCommand;
import com.hypixel.hytale.server.core.command.CommandContext;
import java.util.concurrent.CompletableFuture;

public class HealCommand extends AbstractPlayerCommand {

    public HealCommand() {
        super("heal", "Restore your health to maximum");
    }

    @Override
    public CompletableFuture<Void> execute(CommandContext context) {
        var player = context.getPlayer();
        player.setHealth(player.getMaxHealth());
        player.sendMessage("You have been healed!");
        return CompletableFuture.completedFuture(null);
    }
}

import com.hypixel.hytale.server.core.command.AbstractAsyncCommand;

public class StatsCommand extends AbstractAsyncCommand {

    public StatsCommand() {
        super("stats", "View player statistics");
    }

    @Override
    public CompletableFuture<Void> execute(CommandContext context) {
        return CompletableFuture.runAsync(() -> {
            // Fetch data from database (async)
            var stats = fetchPlayerStats(context.getPlayer());
            context.getPlayer().sendMessage("Your stats: " + stats);
        });
    }
}

@Override
public void start() {
    getCommandRegistry().register(new HealCommand());
    getCommandRegistry().register(new StatsCommand());
}

if (player.hasPermission("myplugin.admin")) {
    // Player has admin permission
    player.sendMessage("You are an admin!");
} else {
    player.sendMessage("You don't have permission for that.");
}

public class MyPlugin extends JavaPlugin {
    private MyConfig config;

    public MyPlugin(@Nonnull JavaPluginInit init) {
        super(init);

        // Load config file
        this.config = withConfig("config.json", MyConfigCodec.INSTANCE);
    }
}

Path dataDir = getDataDirectory();
Path playerDataFile = dataDir.resolve("playerdata.json");

// Run a task later
getTaskRegistry().runLater(() -> {
    getLogger().info("This runs after a delay!");
}, Duration.ofSeconds(5));

// Run a repeating task
getTaskRegistry().runRepeating(() -> {
    getLogger().info("This runs every 10 seconds!");
}, Duration.ofSeconds(10));

./gradlew build

%appdata%\Hytale\UserData\Mods\

C:\Users\YourUsername\AppData\Roaming\Hytale\UserData\Mods\

package com.example.early;

import com.hypixel.hytale.plugin.early.ClassTransformer;

public class ExampleTransformer implements ClassTransformer {
    @Override
    public byte[] transform(String className, byte[] classBytes) {
        // Modify bytecode here using ASM or Mixin
        return classBytes;
    }

    @Override
    public int getPriority() {
        return 0; // Higher values run first
    }
}

com.example.early.ExampleTransformer