Build a network in an afternoon.

HiveScale is the backend for multiplayer game networks: matchmaking, cross-server player data, a server registry and network-wide punishments, all behind one API key. It ships as a single Java SDK that works the same on Hytale and Minecraft. A minigame SDK is in design and marked "Soon" below.

Build this with it

Several servers sharing one set of players
A lobby that routes into minigames
Profiles, currencies and bans that follow players

Reach for something else if

You run a single survival server with no network
You want raw SQL or a database connection of your own
Your players never cross between servers

Matchmaking

Route a player to a lobby or a fresh minigame instance. Capacity-aware, so you never send anyone to a full box.

// Find a server with room and send the player there.
hive.matchmaking()
    .findServer(uuid, name, "lobby")
    .thenAccept(result -> {
      if (result.isSuccess())
        hive.transfer().transfer(uuid, result.getMatchedServer().getServerId(), null);
    });

Matchmaking reference

Player data

Profiles, stats and currencies that follow players across every server. No database to run, no sync to write.

// Their SkyWars data loads the moment they join, anywhere.
hive.player()
    .fetchPlayerData(player.uuid(), player.name(), "skywars", GameType.HYTALE)
    .thenAccept(this::restore);

Player data reference

Punishments

Network-wide bans, mutes and kicks that survive reconnects and server hops. Issue once, enforced everywhere.

// Ban once. Every server kicks them and refuses the reconnect.
hive.punishments().createPunishment(
    target.uuid(), target.name(), PunishmentType.BAN,
    "Cheating", null, false, mod.uuid(), mod.name());

Punishments reference

What's in the box

Six building blocks, one handle. Start anywhere.

Quickstart

Matchmaking

findServer, queues and capacity-aware routing across your network.

Player data

Profiles, per-game namespaces, currencies, stats and leaderboards.

Server registry

Heartbeats, presence and transfers between boxes.

Punishments

Network-wide bans, mutes and kicks that survive reconnects.

Minigame SDK

Match & party genres, the hive-game.json manifest, and the engine ports.

Add the SDK

Add the coordinate to your build.gradle.kts, set HIVE_API_KEY once, and any server you start joins your network.

build.gradle.kts

repositories {
  maven { url = uri("https://maven.beehivesys.net/public") }
}

dependencies {
  compileOnly("net.beehivesys.hive:hive-minecraft:1.3.2")
}

Published and anonymously readable, no credentials needed. Current versions: maven-metadata.xml.

Looking for something specific? ask us, we answer fast.