Plugins (Java)

Plugins are Java-based server modifications that provide deep control over game logic. Build commands, minigames, economies, and entirely new systems.

What Can You Build?

Use Case	Examples
Commands	Custom slash commands, admin tools, player utilities
Minigames	PvP arenas, racing games, survival challenges
Economies	Currency systems, shops, trading
Systems	Permissions, moderation, integrations
New Features	Custom mechanics not possible with packs alone

Requirements

Tool	Version	Notes
Java	25+	Download from Adoptium
IDE	Any	IntelliJ IDEA recommended
Build Tool	Maven or Gradle	Examples use Maven

Quick Start

Ready to create your first plugin?

Create Your First Plugin - Build a /hello command in 10 minutes

Plugin Types

Standard Plugins

Most plugins are standard plugins:

Run within the normal plugin system
Use the official API
Stored in mods/ folder
Safe and supported

Early Plugins

For low-level modifications:

Run outside the standard plugin system
Perform bytecode modifications
Stored in earlyplugins/ folder
Requires --accept-early-plugins flag

Getting Started

Maven Dependency

<dependency>
    <groupId>com.hypixel.hytale</groupId>
    <artifactId>Server</artifactId>
    <scope>provided</scope>
</dependency>

Key Packages

com.hypixel.hytale.protocol.packets  # Network packets

Development Tips

Disable Sentry During Development

Hytale uses Sentry for crash reporting. Disable it to avoid submitting your development errors:

java -jar HytaleServer.jar --assets PathToAssets.zip --disable-sentry

Use the Server Source

The server is not obfuscated. You can decompile it to:

Understand how systems work
Learn the API before documentation catches up
Read actual implementation instead of guessing

Official server source code will be released 1-2 months after launch.

Study Real Plugins

Check these open-source plugins for reference:

Plugin	Description
Nitrado:WebServer	Base plugin for web APIs
Nitrado:Query	Server status via HTTP
ApexHosting:PrometheusExporter	Server metrics

Learn More

Project Setup - IDE and Maven configuration
Commands - Creating custom commands
Events - Listening to game events
Minigames - Building game modes

Plugins + Packs

Plugins work best when combined with packs:

Packs define content (blocks, items, NPCs)
Plugins handle logic (game rules, scoring, systems)

For content without custom logic, start with Packs (JSON).