Build a network in an afternoon.

HiveScale is the backend for multiplayer game networks: matchmaking, cross-server player data, a server registry, network-wide punishments and a minigame SDK, all behind one API key. It ships as a single Java SDK that works the same on Hytale and Minecraft. Here's the shape of it; the full reference is rolling out alongside the Hytale beta.

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(player.uuid(), player.name(), "lobby")
    .thenAccept(result -> {
      if (result.isSuccess()) hive.transfer(player, result.matchedServer());
    });

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

Drop the Maven coordinate into your pom.xml, set HIVE_API_KEY once, and any server you start joins your network.

pom.xml

<dependency>
  <groupId>dev.hivescale</groupId>
  <artifactId>hive-sdk</artifactId>
  <version>1.0.0</version>
</dependency>

The SDK artifact publishes alongside the Hytale beta. Want it sooner? Ask us for early access.

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