The first comprehensive, community-driven reference for Hytale's dedicated server internals.
Built from decompilation and analysis of HytaleServer.jar (pre-release 2026.02.05-9ce2783f7), this repository documents the server's plugin API, command system, event architecture, permission nodes, and the complete World Generation V2 asset pipeline — covering 170+ registered types across 19 reference documents.
- Quick Start
- Server Plugin API
- World Generation V2
- Version History
- Source Analysis
- Related Projects
- Community
- Disclaimer
| Document | Description |
|---|---|
| Documentation Index | Full documentation index with all guides and references |
| Permissions Reference | All 54+ permission nodes (hytale.command.*, hytale.editor.*, hytale.system.*) |
| Commands Reference | Every server command — syntax, arguments, required permissions, player/console availability |
| Events Reference | All 77 event classes — player, world, entity, and permission events |
| Plugin API | Plugin lifecycle, event registration, command registration |
| Changelog | Version diff: 55 new classes, 17 removed, 963 modified between releases |
| WorldGen V2 Overview | Entry point for the V2 world generation system (start here) |
Documentation for building Hytale server plugins. See the Documentation Index for the complete guide structure.
- Permissions — All permission nodes across three namespaces:
hytale.command.*,hytale.editor.*,hytale.system.* - Commands — Every server command with syntax, argument types, required permissions, and console/player availability
- Events — 77 event classes for player, world, entity, and permission lifecycle hooks
- Plugin API — Plugin lifecycle, event registration, command registration
Deep-dive documentation into Hytale's internal systems:
- Architecture Overview — High-level system architecture
- Player Entity — Player entity component system
- Messaging — Server messaging and communication
- Protocol Enums — Network protocol enumeration types
- Storage Registry — Data storage and registry patterns
- ECS Component System — Entity Component System internals
Step-by-step guides for building plugins:
- Plugin System — Plugin loading, lifecycle, and structure
- Event System — Subscribing to and handling events
- Command System — Registering and implementing commands
- Permissions System — Permission nodes and access control
- Built-in Modules — Documentation for Hytale's built-in server modules
The V2 world generation system is Hytale's asset-based procedural generation pipeline. It replaces the legacy zone system with a fully data-driven architecture built on 170+ registered JSON asset types. Every terrain shape, block material, biome boundary, and prop placement rule is defined through composable asset graphs.
This is the first community reference for this system. The documentation covers the complete pipeline from world structure definitions down to individual density function nodes.
WorldStructure -- biome distribution via noise ranges
└── Biomes[] -- terrain + materials + props per biome
├── Terrain (DAOTerrain) -- density function graph defining 3D shape
│ └── Density -- 68 composable node types
├── MaterialProvider -- 14 types selecting block materials
├── Props[] -- 11 types placing structures/vegetation
│ ├── PositionProvider -- 14 types generating candidate XZ positions
│ ├── Scanner -- 5 types finding valid Y positions
│ ├── Pattern -- 15 types validating placement conditions
│ ├── Assignments -- 5 types distributing prop selection
│ └── BlockMask -- placement/replacement rules
├── EnvironmentProvider -- atmosphere, weather, spawn density
└── TintProvider -- biome color tinting
| Document | Types | Description |
|---|---|---|
| Overview and Architecture | — | V1/V2 pipelines, asset registry, threading model, entry points |
| World Structures | 1 | NoiseRange root definition, biome ranges, transition blending |
| Biomes | 1 | BiomeAsset fields, DAOTerrain, prop runtime stages, build pipeline |
| Document | Types | Description |
|---|---|---|
| Density Functions | 68 | Computational graph core — noise, math, shapes, warping, caching, coordinates |
| Curves | 19 | Value-mapping functions — manual, arithmetic, clamping, min/max |
| Material Providers | 14 | Block selection — SpaceAndDepth subsystem, 4 layer types, 7 condition types |
| Vector Providers | 5 | 3D vector generation for warping and directional operations |
| Document | Types | Description |
|---|---|---|
| Props | 11 | Object/structure placement — box, prefab, cluster, density, weighted |
| Position Providers | 14 | Candidate coordinate generation — grid, noise-filtered, cached |
| Scanners | 5 | Vertical position scanning — linear, random, area |
| Patterns | 15 | Boolean placement conditions — surface, block, spatial, logic |
| Assignments | 5 | Prop distribution strategies — constant, weighted, field function, sandwich |
| Block Masks | — | Placement/replacement rules and prefab filter syntax |
| Document | Types | Description |
|---|---|---|
| Environment and Tint | 4 | Atmosphere, weather, spawn density, and color tinting |
| Framework | 2 | Named constants and shared position providers via ReferenceBundle |
| Settings | — | Performance tuning — concurrency, buffers, view distance |
| File System | — | Asset overlay system for mod overrides and version packs |
| Document | Description |
|---|---|
| World.json | V1 world configuration — dimensions, masks, data overrides |
| Zones | V1 zone system — discovery config, tile biomes, cave generators, color masks |
This documentation tracks the Hytale dedicated server across releases.
| Property | Value |
|---|---|
| Current Version | 2026.02.05-9ce2783f7 (pre-release) |
| Previous Version | 2026.01.24-6e2d4fc36 (release) |
| Server Java Version | 21 |
| Build JDK | 25 |
| Root Package | com.hypixel.hytale |
The Changelog documents the diff between these versions: 55 new classes, 17 removed, 963 modified. Notable changes include world generation refactoring, world map markers, sleep system, and builder tools.
| Detail | Value |
|---|---|
| Source JAR | HytaleServer.jar (~84 MB) |
| Decompiler | Vineflower 1.11.2 |
| Scope | com.hypixel.hytale.* only |
| Total Classes | 7,265 |
| Decompiled Files | 5,272 |
| Area | Documented Items |
|---|---|
| Permission Nodes | 54+ |
| Command Classes | ~446 |
| Event Classes | 77 |
| WorldGen V2 Asset Types | 170+ |
| WorldGen V2 Reference Docs | 19 |
| Package | Area |
|---|---|
server.core.permissions |
Permission system |
server.core.command |
Command framework |
server.core.event |
Event system |
server.core.plugin |
Plugin loading |
server.core.universe |
World management |
builtin.hytalegenerator |
World generation V2 |
procedurallib |
Procedural generation library |
server.worldgen |
World generation config and loading |
protocol |
Network protocol |
All packages are under the com.hypixel.hytale root.
| Project | Description |
|---|---|
| HyperVerse | Multi-world management plugin — create, configure, and teleport between worlds using V1 and V2 generators |
| HyperPerms | Permission management plugin |
| HyperHomes | Home system plugin |
| HyperFactions | Factions plugin |
Join the Discord for discussion, support, and updates: https://discord.gg/SNPjyfkYPc
This documentation is provided for educational and modding purposes. All content is derived from analysis of publicly available server binaries. Hytale is a trademark of Hypixel Studios. This project is not affiliated with or endorsed by Hypixel Studios.