Welcome to Minestom
Minestom is an open-source library that enables developers to create their own Minecraft server software from scratch, without any code from Mojang. Unlike traditional server implementations, Minestom provides a complete API with no features by default - giving you full control to build exactly what you need.Installation
Add Minestom to your project with Gradle or Maven
Quickstart
Build your first Minestom server in minutes
Core Concepts
Learn about instances, threading, and events
API Reference
Explore the complete API documentation
Why Minestom?
Minecraft servers have evolved significantly, but most don’t take advantage of modern performance techniques. Minestom is designed for developers who want to build servers that benefit little from vanilla features - like creative servers, minigames, or KitPvP.Multi-threaded
Full multi-threading support for maximum performance
Instance System
Lightweight, scalable world management
Modern API
Clean, type-safe API with no legacy NMS
Zero Overhead
No vanilla features slowing you down
Event-Driven
Powerful event system for extensibility
1.21 Protocol
Full support for Minecraft 1.21.11
Key Features
Multi-threaded Architecture
Unlike traditional servers that run on a single thread, Minestom uses a thread pool to manage all chunks independently across instances. This means better CPU utilization and higher performance under load.Instance-Based Worlds
Instances are lightweight collections of blocks and entities that can be created on the fly, copied instantly, and serialized however you want. Perfect for minigames, skyblock, or any scenario where you need dynamic world management.Modern Event System
A flexible, type-safe event system powered byEventNode that supports filtering, conditions, and hierarchical event handling. No more dealing with obfuscated NMS or brittle reflection.
Built-in Command System
First-class support for Minecraft’s Brigadier command system with full argument parsing, tab completion, and command graph generation.What Minestom Is Not
Minestom is designed for developers who want to build custom server implementations from the ground up. If you’re looking for a vanilla-like experience or want to use existing plugins, Minestom is not the right choice.Use Cases
Minestom excels when:- Building custom minigame servers where vanilla mechanics aren’t needed
- Creating creative or building servers with custom tools
- Developing lobby systems or hub servers
- Implementing custom game modes that don’t rely on vanilla features
- Prototyping new Minecraft-based experiences
- You want a vanilla survival experience
- You need compatibility with Bukkit/Spigot plugins
- You’re looking for something that works out-of-the-box without coding
Community & Resources
GitHub Repository
View source code and contribute
Discord Community
Join the Minestom community
Wiki
Additional tutorials and guides
Javadocs
Complete API documentation
Next Steps
Ready to get started? Follow our installation guide to add Minestom to your project, then check out the quickstart to build your first server.Install Minestom
Set up your development environment
Build Your First Server
Create a working server in 5 minutes