hytale-mod

Hytale Modding Skill

Prime context for Hytale server plugin development and modding (Early Access, Dec 2025).

Environment Requirements

• Java 25 (required by Hytale server)
• Gradle Groovy DSL only — Kotlin DSL (.gradle.kts) fails with JDK 25
• Maven coordinates: com.hypixel.hytale:Server:2026.01.28-87d03be09

Project Structure

plugin-name/
├── build.gradle              # Groovy DSL, shadowJar
├── src/main/
│   ├── java/                 # Plugin code
│   └── resources/
│       ├── manifest.json     # Plugin manifest
│       ├── Server/           # Data assets (items, blocks)
│       └── Common/           # Visual assets (icons, UI, textures)

Gradle Configuration

plugins {
    id 'java'
    id 'com.github.johnrengelman.shadow' version '8.1.1'
}

java {
    sourceCompatibility = JavaVersion.VERSION_25
    targetCompatibility = JavaVersion.VERSION_25
}

repositories {
    mavenCentral()
    maven {
        name = "hytale-release"
        url = uri("https://maven.hytale.com/release")
    }
    maven {
        name = "hytale-pre-release"
        url = uri("https://maven.hytale.com/pre-release")
    }
}

dependencies {
    compileOnly("com.hypixel.hytale:Server:2026.01.28-87d03be09")
}

Plugin Lifecycle

package com.example.myplugin;

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().atInfo().log("Plugin loaded!");
    }

    @Override
    protected void setup() {
        // Register commands, events, components
        getLogger().atInfo().log("Plugin setup!");
    }

    @Override
    protected void start() {
        // Start tasks, load config
        getLogger().atInfo().log("Plugin started!");
    }

    @Override
    protected void shutdown() {
        // Save data, clean up resources
        getLogger().atInfo().log("Plugin shutdown!");
    }
}