Now in BETA · 1.0.0-beta.1

The Cloud System
Minecraft deserves.

KryoCloud is a lightweight, extensible cloud management system for Minecraft networks. Start services, manage groups, and extend everything through a clean plugin API — all from one node.

Get Started Read the Docs
kryocloud.jar
❄ KryoCloud ⋄ node
────────────────────────────────────────────────────────────
frost-tier minecraft cloud
✓ wrappers
✓ groups
✓ versions
✓ commands
✓ ready
❄ KryoCloud console ready
Service Lobby-1 is now PREPARING on wrapper-1
❄ 15:00:00 WARN TemurinInstaller Downloading Temurin Java 25 from adoptium.net
❄ 15:00:02 OK TemurinInstaller Installed Temurin Java 25 into .jdk/java-25
Service Lobby-1 is now STARTING on wrapper-1
❄ 15:00:05 OK InstanceManager Started Lobby-1 in screen on port 34749
Service Lobby-1 is now RUNNING on wrapper-1
▋
3 Service Types
6 Service States
10+ API Controllers
∞ Extensible via Plugins
Core Features

Everything your network needs.

Built from the ground up for Minecraft networks that need reliability, speed, and full control over their infrastructure.

Node & Wrapper Architecture

A central Node orchestrates your entire network. Wrappers spawn and control individual services across multiple machines. Run everything on one host or distribute across your infrastructure — same config, same API.

Node
Wrapper 1
Lobby · Survival
Wrapper 2
Proxy
Wrapper 3
Minigames

Smart Service Groups

Define groups with min/max service counts, memory limits, and auto-scale thresholds. KryoCloud automatically starts new services when usage exceeds your configured startNewPercent — no manual intervention required.

Usage
82% ↑ Spawning
Threshold at 80% — new service spawning

Auto Forwarding Setup

Velocity modern forwarding and BungeeCord legacy forwarding — both supported. Set to AUTO and KryoCloud detects your proxy software and configures the shared secret automatically across all services.

VelocityBungeeCordWaterfallFlamecord

Template System

Every service group is backed by a template. Persistent static services keep their directory across restarts; ephemeral services get a fresh copy every launch — the right model for proxies vs. minigame servers.

Service Lifecycle

Full state tracking from PREPARING through RUNNING to STOPPED. Your plugins react to every transition via typed events on the event bus — no polling needed.

Preparing → Starting → Running → Stopped

Version Management

Point to latest or pin a specific version — KryoCloud downloads and installs your server software automatically before first start. Paper, Velocity, BungeeCord and more — handled.

Software Support

Since no plugin is required on backend servers, anything compatible with Velocity or BungeeCord works out of the box. For standalone services, any Java software runs.

Plugin API

Simple. Powerful. Just works.

The KryoCloud Plugin API is designed to be the least friction possible between your idea and a working extension. One annotation, one interface, and you have access to the entire cloud.

  • Access services, groups, wrappers, templates & versions via typed controllers
  • Subscribe to typed cloud events — no reflection magic, no XML configs
  • Built-in scheduler, logger, messenger and data directory per plugin
  • Works both inside a cloud service and as a standalone cloud plugin
  • Async-first with CompletableFuture throughout the entire API
Maven eu.kryocloud:kryocloud-api:1.0.0-alpha.1 Docs →
Events 
// Subscribe to any cloud event
CloudAPI.events().subscribe(
    GroupScaledEvent.class,
    e -> notifyPlayers(e.group())
);
Services 
// Control services from anywhere
CloudAPI.services()
    .byGroup("Lobby")
    .thenAccept(list ->
        list.forEach(IService::stop)
    );
Identity 
// Know where you are
if (CloudAPI.runningInCloud()) {
    String groupName = CloudAPI.groupName();
    String serviceName = CloudAPI.serviceName();
}
Coming Soon

The ecosystem is just getting started.

We're building the full toolkit around KryoCloud. Here's what's on the roadmap.

In Development

Web Dashboard

A full-featured web interface to monitor services, manage groups, inspect logs and control your entire network — no terminal required.

12 Services
3 Groups
Online Node
Planned

Addon Loader

Install, update and manage KryoCloud plugins directly from the dashboard or CLI — no manual JAR dropping required. Dependency resolution included.

kryocloud-proxy-bridge v1.0.2
kryocloud-signs v0.9.1
kryocloud-notify ↑ 1.1.0

???

Something is brewing. Stay tuned.

Ready to freeze the chaos?

Get KryoCloud running in minutes. One command, your entire network under control.

$ curl -fsSL https://kryocloud.eu/install.sh | bash

Linux & macOS · Requires curl & bash

Read the Docs GitHub