Skip to main content

CloudNet Release v3.4.0 - Earthquake!

ยท 5 min read
Linus F. (Sarsum)

We are proudly presenting a new release version of CloudNet v3!
It has been a while since we released the 3.3 update. Quite a long time, the last release was on 05/16/2020, since then quite a lot has changed in the system.

  • More than 1220 classes have been edited and added in over 450 commits.
  • 19 people were involved in the update, so not only the team members contributed, but also the community.


  • Java 16 and Minecraft 1.17 are now supported!
  • Many synchronization issues of the cluster have been fixed.
  • Performance improvements in many places and all bugs that are known to date have been fixed.
  • IPv6 is now supported everywhere.
  • A possibility to set the default JVM flags for all services has been added in the node configuration file.
  • The time until a service will be force stopped can now be defined in the node config.
  • All tasks can now be started with a separate JVM command, for example to use Java 8 for lobbies and Java 16 for proxies.
  • All tasks can now have a specific permission needed to enter it.
  • Services are no longer managed by all nodes, one node takes over the leader role in the cluster (so-called "head node") and ensures that services are started/stopped.
  • All messages are now also available in the French language.
  • More functionalities have been added to the LabyMod module.

You can find a more detailed changelog here.


For this update, it is recommended to update replacing the launcher.jar with the one from the 3.4.0 build from our download server. Using auto-update would still work (if you have set it to true in the launcher.cnl file), but the LabyMod Module would not be updated properly.

Please be aware that Nodes running on v3.3 are not able to connect to v3.4 nodes! Therefore, you need to update all your nodes at the same time.

New SpigotMC design

There has been a complete design overhaul of our SpigotMC page!
Please have a look at it and share your thoughts with us. We hope you like it.

Notice for Snapshot users

If you are using the Snapshot of CloudNet v3 for the improved stability of the 3.4 version, you should consider disabling snapshots! (You can do that by turning use-snapshots to false in the launcher.cnl file.)
We will continue working on CloudNet v3 in the development branch, so you would risk getting potentially unstable or broken builds.


A small word about the API is important, too.
Many of the API methods that were in 3.3 for a long time (some since 3.0) have been replaced and marked as deprecated. Please read the documentation! We added information about the replacement for every new deprecated method, nothing was removed without prior notice (deprecation) before. Methods that were annotated as ScheduledForRemoval for 3.4 were removed.

The dependency information can be found here.

About the cluster issues

We were not able to test the CloudSystem in a large scale with more than three nodes and a couple of hundred players before.
A user has reached out to us having troubles with multiple servers having the same id (such as "Lobby-1" on different nodes or even the same).
Before the version 3.4, we tried to let the nodes decide themselves if they needed to start a new server. Unfortunately, this did not work well, and we identified it to be the cause of the issues.
Therefore, we implemented a Head-Node system. Once the nodes connect to each other, they exchange their time of boot and use this to determine the current Head-Node.
If the Head-Node disconnects, every other Node knows which one will be the next Head-Node, and the Cluster will just continue where it was before.

After fixing the cluster issues, we heard of a few large networks not having any further problems.
To give an idea: We know that CloudNet worked well with 6 nodes in the cluster and more than 600 players connected at the same time!

A very special thank you to the networks which worked closely with us to resolve the issues and test the fixes!


We hope you will enjoy this big update!

Please remember, CloudNet is provided as-is - we are not responsible for data loss or corruption. You are encouraged to back up your files before any updates!