1.18.1 Lightweight and multi-threaded Minecraft server
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Go to file
Alexander c496ee3572
Update to JoinGamePacket and RespawnPacket (#1640)
* Add death location support to JoinGamePacket
1 day ago
.github use local gradle for javadoc action 2 weeks ago
build-logic Fix player position being wrong inside tests 1 year ago
code-generators Remove some `Collections` usage 7 months ago
demo Remove some `Collections` usage 7 months ago
gradle Add commit info from JitPack into Minestom's jar (#1272) 3 months ago
jcstress-tests Improve tag performance + concurrency tests (#1165) 9 months ago
jmh-benchmarks New command parser (#1235) 8 months ago
src Update to JoinGamePacket and RespawnPacket (#1640) 1 day ago
testing Fix event node child/map leak 5 months ago
.editorconfig Enabled compression by default, provide .editorconfig file 2 years ago
.gitignore Exclude world folder created by saving in the demo. (#1282) 8 months ago
LICENSE Added license 3 years ago
build.gradle.kts Add commit info from JitPack into Minestom's jar (#1272) 3 months ago
gradle.properties Build system update (#527) 1 year ago
gradlew Build system update (#527) 1 year ago
gradlew.bat Update Gradle & Kotlin version 2 years ago
jitpack.yml Remove `before_install` 1 year ago
minestom_checks.xml Upgrade gradle version to 7.0.2 2 years ago
settings.gradle.kts Make separate module for testing framework (#1428) 5 months ago


banner banner


license standard-readme compliant
javadocs wiki discord-banner

Minestom is an open-source library that enables developers to create their own Minecraft server software, without any code from Mojang.

The main difference between Mojang's vanilla server and a minestom-based server, is that ours does not contain any features by default! However, we have a complete API which is designed to allow you to make anything possible, with ease.

This is a developer API not meant to be used by end-users. Replacing Bukkit/Forge/Sponge with this will not work since we do not implement any of their APIs.

Table of contents


Minestom is not installed like Bukkit/Forge/Sponge. As Minestom is a Java library, it must be loaded the same way any other Java library may be loaded. This means you need to add Minestom as a dependency, add your code and compile by yourself.

For adding the required repositories and dependencies, check this out

The newest version can be found here:

Our own WIP implementation for Vanilla can be found here.


An example of how to use the Minestom library is available here. Alternatively you can check the official wiki or the javadocs.

Why Minestom?

Minecraft has evolved a lot since its release, most of the servers today do not take advantage of vanilla features and even have to struggle because of them. Our target audience is those who want to make a server that benefits little from vanilla features. e.g. creative, kitpvp. The goal is to offer more performance for those who need it. In other words, it makes sense to use Minestom when it takes less time to implement every missing vanilla feature you want than removing every vanilla feature that will slow you down.

Advantages and Disadvantages

Minestom isn't perfect, our choices make it much better for some cases, worse for some others.


  • Remove the overhead of vanilla features
  • Multi-threaded
  • Instance system (Collections of blocks and entities) which is much more scalable than worlds
  • Open-source
  • Modern API
  • No more legacy NMS


  • Does not work with Bukkit/Forge/Sponge plugins or mods
  • Does not work with older clients (using a proxy with ViaBackwards is possible)
  • Bad for those who want a vanilla experience
  • Longer to develop something playable
  • Multi-threaded environments need extra consideration


Even if we do not include anything by default in the game, we simplify the way you add them, here is a preview.


It is our major concept, worlds are great for survival with friends, but when it scales up it can become unmanageable. The best examples can be found in Skyblock or minigames, not being able to separate each part properly and being forced to save everything in files, not to say the overhead caused by unnecessary data contained in them. Instances are a lightweight solution to it, being able to have every chunk in memory only, copying and sending it to another player in no time, with custom serialization and much more...

Being able to create instances directly on the go is a must-have, we believe it can push many more projects forward.

Instances also come with performance benefits, unlike some others which will be fully single-threaded or maybe using one thread per world we are using a set number of threads (pool) to manage all chunks independently from instances, meaning using more CPU power.


Minestom by default does not know what is a chest, you will have to tell him that it opens an inventory. Every "special blocks" (which aren't only visual) need a specialized handler. After applying this handler, you have a block that can be placed anywhere simply. However, all blocks are visually there, they just won't have interaction by default.


The terms "passive" or "aggressive" monsters do not exist, nobody stops you from making a flying chicken rushing into any players coming too close, doing so with NMS is a real mess because of obfuscation and the large inheritance.


It is a field where Minecraft evolved a lot, inventories are now used a lot as client<->server interface with clickable items and callback, we support these interactions natively without the need of programming your solution.


Commands are the simplest way of communication between clients and server. Since 1.13 Minecraft has incorporated a new library denominated "Brigadier", we then integrated an API designed to use the full potential of args types.



See the contributing file! All WIP features are previewed as Draft PRs


This project is licensed under the Apache License Version 2.0.