Documentation

4.1 What are nodes and clusters?

quinilo

28 Apr 2026 — 1 min read

Simplified, a node can be defined as an "instance of StreamlineCloud" or a "worker". To understand this, you have to understand that StreamlineCloud is split up into two main modules:

The Backend: Stores permanent data (like groups and configurations). It also works as a bridge to exchange data in real time (like informations about your online servers).
The Node(s): Manages your Minecraft servers.

By default, you only have one node. But here is the twist: you can connect as many nodes as you want to a backend. Multiple nodes that are connected to each other are called a Cluster. Here is an example of how a setup with multiple nodes could look like:

Why is this useful?

You could create one node that is responsible for one single game mode (like Node-2 in the example). This would allow you to maintain and update your game mode independently of the rest of your network. A crash would only affect a part of your network, players would be transferred to your lobby instead of being disconnected.

To sum it up, a node controls your Minecraft servers, multiple nodes that are connected together via the backend are a cluster.

5.3 Load Balancers

With load balancers you can spread your players across multiple proxy servers. The loadbalancers is the first instance the client communicates with. To see a list of your running load balancers just type loadbalancer list Creating a new load balancer loadbalancer create <name> <port> <targetGroup&

5.2 Fallback

Fallback control is an optional feature that automatically stops and starts fallback servers based on the network online count. Fallback servers are your "lobby" servers. You can change your fallback group in the config. Configuring fallback control Just open data/config.json and take a look at the

6.2 Plugins

Implementation Please make sure you have added our repo to your project! Gradle Implementing StreamlineCloudMC dependencies { implementation "net.streamlinecloud:streamlinecloud-mc:BETA-0.5" } Maven Implementing StreamlineCloudMC <dependencies> <dependency> <groupId>net.streamlinecloud</groupId> <artifactId>streamlinecloud-mc</artifactId> <version&

6.1 API Implementation

First you should add the StreamlineCloud repo to your project. Gradle Add the following code to your build.gradle / build.gradle.kts file. repositories { maven { url "https://streamlinecloud.github.io/repo/" } } Maven Add the following code to your pom.xml file. <repositories> <repository> <

Why is this useful?

Read more

5.3 Load Balancers

5.2 Fallback

6.2 Plugins

6.1 API Implementation