Skip to content

Hytale Server Documentation

Unofficial community guides for setting up and modding Hytale dedicated servers.

Getting Started

Learn what you need to run a Hytale server and understand the basics. Read more

Installation

Install Java 25 and set up your server files step by step. Get started

Server Configuration

Configure server settings, worlds, and performance options. Configure

System Requirements

4GB RAM minimum, Java 25, UDP port 5520 access.

Modding Overview

Start here to understand the Hytale server modding architecture and concepts. Read overview

Plugin System

Create powerful plugins with the JavaPlugin framework and lifecycle management. Learn more

Event System

Subscribe to game events with priority ordering and async support. Explore events

ECS Components

Use the Entity-Component-System architecture for game objects. View components

Commands

Register custom commands with argument parsing and permissions. View commands

Examples

Complete code examples and common patterns for plugin development. See examples

QUIC Protocol

Hytale uses the modern QUIC protocol over UDP for fast, reliable connections.

Server Mesh

Built-in support for connecting multiple servers without third-party proxies.

Automatic Backups

Configure automatic world backups with customizable frequency.

Authentication

OAuth 2.0 based authentication with support for offline mode.

Join our community to get help, share your server setups, and connect with other administrators.

  • Discord - Get real-time help from the community
  • GitHub - Report issues and contribute to the documentation