Minestom

Spec sheet

Product

Minestom is an open-source Java library for building custom Minecraft server software; it is not a server JAR to download and run.Read 8 Oct 2026 · minestom.net

Intended users

Minestom targets developers building custom servers with little reliance on vanilla features, such as minigames or KitPVP.Read 8 Oct 2026 · minestom.net

Support

The documentation directs users who need help to the Minestom Discord server.Read 8 Oct 2026 · minestom.net

License

The GitHub project states that Minestom is licensed under Apache License 2.0.Read 8 Oct 2026 · github.com

Authentication

A server starts in offline mode by default; enabling Mojang authentication validates the client's session token and applies the player's skin.Read 8 Oct 2026 · minestom.net

Compatibility limit

Minestom aims to keep up with the latest Minecraft version, and older clients are not directly supported; the documentation points to ViaVersion through a proxy as an option.Read 8 Oct 2026 · minestom.net

Custom gameplay

Minestom does not implement vanilla gameplay, so developers write the behaviors their servers need.Read 8 Oct 2026 · minestom.net

Developer audience

Minestom is aimed at developers building servers with custom gameplay, such as minigames or KitPVP.Read 8 Oct 2026 · minestom.net

Distribution

Minestom is published to Maven Central as a Java library dependency, with snapshots available for trying some upcoming features.Read 8 Oct 2026 · minestom.net

Gameplay limit

Minestom implements almost none of vanilla gameplay, so the documentation says survival gameplay would need to be rebuilt from scratch.Read 8 Oct 2026 · minestom.net

How it runs

You add Minestom as a dependency, write a server in Java or Kotlin, and compile it yourself; Minestom is not a server JAR to download and run.Read 8 Oct 2026 · minestom.net

Instances

Instances can be created and discarded at runtime, which the documentation says suits per-match maps better than loading worlds from disk.Read 8 Oct 2026 · minestom.net

Java requirements

The current documentation says Minestom requires Java 25 or newer.Read 8 Oct 2026 · minestom.net

Performance

The project describes Minestom as designed for efficiency and high performance with minimal overhead.Read 8 Oct 2026 · minestom.net

Performance design

Minestom uses a thread pool to manage chunks independently from instances and is designed for efficiency with minimal overhead.Read 8 Oct 2026 · minestom.net

Plugin and mod limit

Bukkit, Spigot, Paper, Forge, and Fabric plugins or mods do not run on Minestom.Read 8 Oct 2026 · minestom.net

Protocol

Minestom implements the Minecraft protocol and server essentials including networking, chunks, entities, and inventories, but does not implement vanilla gameplay.Read 8 Oct 2026 · minestom.net

Proxy integrations

The documentation lists Velocity, Gate, BungeeCord, and their derivatives as supported proxies.Read 8 Oct 2026 · minestom.net

Security consideration

The documentation warns that offline-mode UUIDs are trivially spoofable and should not be used to identify players.Read 8 Oct 2026 · minestom.net

Setup requirements

Minestom requires Java 25 or newer; Gradle users need version 9.1 or higher, and IntelliJ IDEA users need 2025.2 or higher.Read 8 Oct 2026 · minestom.net

Support and documentation

The project wiki links to Javadocs for the complete API reference and invites users to its Discord for help or development discussion.Read 8 Oct 2026 · minestom.net

Threading

Minestom uses a thread pool to manage chunks independently from instances.Read 8 Oct 2026 · minestom.net

What it is

Minestom is an open-source Java library for building custom Minecraft server software.Read 8 Oct 2026 · minestom.net

Where Specifiction places it

• Minecraft Server Software#17 of 257.2