SimpleCloud Droplets

A droplet is our interpretation of a microservice, that can extend the functionality of your SimpleCloud setup. They can be used to run custom code, interact with external services, or even to create a custom API.

Understanding droplets

Droplets are a powerful way to extend the functionality of your SimpleCloud setup, without having to write a full-blown application. A droplet (micro-service) is focused on doing one thing, and doing it well. This makes it easy to maintain for us, and easy to scale for you.

This means the important parts of SimpleCloud v3 are now decoupled and can theoretically be replaced by a custom droplet, or even not used at all. For example, if you don't need the CloudPlayer, because you have your own player or don't need a player at all, you can simply not include our player-droplet and you're ready to go.

Installing a droplet

If you have our CLI installed, you can install a droplet with the following command:

# Install a droplet
simplecloud install droplet <droplet-name­>

To see a list of all available droplets, you can use the following command, or view the list of official droplets below:

# List all available droplets
simplecloud get droplets

Droplets vs v2 modules

Droplets are not intended to replace v2 modules. While some droplets may share similarities with existing v2 modules, our goal is not to replicate them. Instead, considering that most of the old modules can function as plugins for Velocity, BungeeCord, Spigot, etc., we have decided to periodically convert all old modules into new and simplified plugins.

Creating droplets

A droplet is simply just a microservice, you can create your own droplets. It's completely up to you how you create your droplets, but we have a small internal Tech-Stack that we use for our droplets.

Here is a list of our Tech-Stack:

• Kotlin
• ProtoBuf
• gRPC
• RabbitMQ
• Redis
• SQLite or PostgreSQL
• JOOQ

Additionally, we use Docker to containerize our droplets.

We don't use all of these technologies in every droplet, but we use them in most of our droplets. You can find the exact Tech-Stack of a droplet in the documentation of the specific droplet.

Official droplets

We have created a few official droplets, that can be used to extend the functionality of your SimpleCloud setup. You can find a list of all official droplets below.

• Server Host Droplet
• Server Host Docker Droplet
• Player Droplet
• Resource Pack Droplet