Building a Multi-Server Minecraft Network with SimpleCloud

Managing multiple Minecraft servers is a pain. Whether you're running a small faction server with a lobby or a full network with ten game modes, juggling separate instances eats time and resources. SimpleCloud is a lightweight platform that handles this job so you don't have to.

What SimpleCloud Does

SimpleCloud is a Minecraft server orchestration platform. In human terms: it's a central hub that lets you create, manage, and control multiple Minecraft server instances from one place, run across one machine or spread over several. Instead of SSHing into boxes and running servers individually, you get a dashboard - and a companion CLI called sc - where you can spin servers up and down, configure them, and monitor what's happening.

It supports Paper and Velocity out of the box, so you're not locked into one ecosystem, and it exposes an API for custom integrations if your setup needs more. The project is open source and Apache-2.0 licensed, so there's no vendor lock-in or mystery licensing.

Official site and docs live at simplecloud.app - worth bookmarking, since that's where setup wizards and invite links actually come from.

Worth flagging up front: this is a full rewrite of the original SimpleCloud project. If you used the old manager/wrapper setup from a couple of years back, the install process, dashboard, and module names below have all changed.

Who Needs This

If you're running a single survival server for friends, skip this section.

But if you're trying to operate a network - maybe a lobby server that splits players into minigames, or a hub with different game modes on separate instances - SimpleCloud cuts your management overhead way down. Server owners love it because they don't have to SSH into multiple boxes or write bash scripts to handle basic operations. You want to restart a server? One command. Spin up a new instance? Done. Monitor player counts across your network? It's all there.

Another angle: competition. Networks with good infrastructure feel snappier to players. Faster restarts, better load balancing, fewer downtime incidents - it adds up. If you're trying to compete with established servers, having your ops dialed in is a real advantage.

Getting Started

Installation now happens through a single install script that sets up the sc CLI:

curl -fsSL https://get.simplecloud.app | bash
sc --version

That installs the CLI, not a running server yet. The rest of the setup happens through the SimpleCloud Dashboard: sign in, create a network (or join one with an invite code), then add your first serverhost - you pick the OS, give it a name, and set how much memory SimpleCloud is allowed to use. The dashboard hands you a one-off setup command containing a temporary login code; run it on the machine and wait for the terminal to print "Setup complete". Don't share that code or paste it into a script - it's single-use and tied to that machine.

Requirements are narrower than they used to be: a Linux or macOS machine with curl and an internet connection (Windows isn't supported for running SimpleCloud itself), Java 21 or newer, and sudo access on Linux so the installer can pull dependencies. Each additional serverhost you add gets its own setup command from the dashboard.

Once a serverhost is connected, the day-to-day commands run through the CLI - a few of the ones you'll actually use:

sc group create          # create a server group
sc group start lobby     # start servers in a group
sc server list            # see what's running
sc server logs lobby 1 --follow
sc attach serverhost      # jump into a server console
sc upgrade                # update SimpleCloud itself

sc --help gets you the full command list, and sc context list / sc context use <name> switch between networks if you're managing more than one.

The Building Blocks

SimpleCloud's architecture is a handful of pieces: the Dashboard (browser-based management), the Controller (coordinates the network), Serverhosts (the machines that actually run your Minecraft servers), and the CLI for doing all of it from a terminal instead.

On top of that, you choose between two ways of running a server. Server groups are replaceable servers built from shared settings and files - the right choice for proxies and game modes that need to scale up and down. Persistent servers keep their own world data and configuration and are meant to stay running long-term, which is what you want for something like an SMP.

The plugin ecosystem covers the same ground the old module system did: Server Connection and Proxy Essentials handle networking, Cloud Command gives you cross-server admin commands, Notify and Prefixes handle player-facing polish, Signs put live server status boards in your lobby, and there's NPC and PlaceholderAPI support for cosmetic touches like spawning NPCs or dropping player counts into chat messages.

The Real Gotchas

Setup is easy, but there are a few things that'll trip you up.

One: Windows isn't supported for the machines actually running SimpleCloud. If your hosting is Windows-only, you're stuck on a VM or WSL for now.

Two: Java 21 is the floor, not a suggestion. If your Minecraft server jars are still pinned to an older Java version, sort that out before you connect a serverhost - mismatched runtimes are the fastest way to a confusing failure.

Three: that one-time login code the dashboard gives you for each setup command is exactly that - one-time. Don't save it in a script or a README for "next time." Every new serverhost needs a fresh command generated from the dashboard.

Four: if you're migrating from manual server management (or from the old SimpleCloud 2), don't expect plug-and-play compatibility. You'll need to bring your server properties, world data, and plugins across yourself. It's not painful, just not automatic.

Alternatives Worth Knowing

If SimpleCloud doesn't fit, there are other options. Kubernetes is overkill for small networks but scales to huge infrastructure - most people don't need it. Paper has some good docs on network setup if you want to do it manually. CloudNet is another cloud platform with a bigger community, though it's more complex to set up.

SimpleCloud's selling point is that it's simple. It does what you need without the complexity of Kubernetes or the overhead of full-blown enterprise solutions. For mid-size networks (5-20 servers), it's often the sweet spot.

You can use SimpleCloud to manage the backend of a pretty sophisticated network. If you want your hub server to have custom cosmetics, you'd handle that with plugins and maybe a text generator for formatted announcements. And if you're selling cosmetics (like skins or cosmetic items), the plugin ecosystem plays nice with SimpleCloud.