Partner Servers

Bring your PvP server into EloTiers

Receive players from the EloTiers mod queue, host ranked and unranked duels and FFA arenas, and feed the global leaderboards. Free, with no exclusivity.

What is the partner program?

EloTiers is a Minecraft PvP ranking ecosystem with a free Fabric mod. The mod adds a matchmaking menu: players pick a kit, queue for ranked or unranked duels and are connected to a server automatically. Elo, tier lists and match history are tracked for every kit.

Partner servers are the servers that host these matches. Players on your server and players using the mod queue are matched together, and the result counts for both.

Why join

Players from the whole community

Players using the EloTiers mod queue in the in-game menu and are sent to your server as soon as a match is found.

Ranked results feed the leaderboards

Ranked results from your server count towards the global Elo and tier lists, so your arenas become part of the ranking.

FFA arenas in the menu

Your FFA arenas appear as a button in the queue menu with a live player count per kit. The mod runs your join commands for the player.

Listed on EloTiers

Your server shows up in the mod menu and on the server list with its name and address.

You stay in control

Your kits, your arenas, your rules. EloTiers does not host or manage your server.

Free, no strings attached

No fees and no exclusivity. Leave whenever you want.

How it works

1. Apply

Contact us on Discord. We create your server entry and give you a partner dashboard with API keys.

2. Connect

Your server calls the partner API: report queued players, receive matches, send results. The SDK shows how.

3. Test with us

We run a few test matches together so you see the full flow before real players arrive.

4. Go live

Your server is enabled and players start arriving from the queue.

What it takes on your side

The integration is a handful of HTTP calls with an API key from your partner dashboard. Everything is JSON, there is an OpenAPI description and an example SDK for Node, Python and Java.

  • GET /api/v2/partner/bootstrapFirst call and heartbeat. Returns signing keys, kit rules and limits.
  • PUT /api/v2/partner/queue/snapshotSend your queued players every 15 seconds.
  • GET /api/v2/partner/matches?wait=20Long poll for signed match deliveries.
  • POST /api/v2/partner/resultReport the winner of every match.
  • POST /api/v2/partner/ffaOptional. Report FFA player counts per kit about every 15 seconds.

Match deliveries carry a payload and an Ed25519 signature, so your server can verify that a player really was matched. Optionally you set up a command or plugin so players land in the right kit.

API documentationExample SDKCurrent partner servers

Frequently asked questions

Does it cost anything?

No. Joining the partner program is free and there is no exclusivity. You can leave at any time.

Do I have to change my server software?

You need a small piece of code that talks to the partner API. An example SDK for Node, Python and Java is included, and the API is plain HTTP and JSON, so any language works.

Who decides the rules on my server?

You do. EloTiers only sends players and match details. Your arenas, your rules, your staff and your economy stay yours.

How are matches verified?

Every match delivery is signed with Ed25519. Your server can check the signature with the public keys from the API before it lets anyone in.

How do I apply?

Open a ticket or write to us in the EloTiers Discord server. We set up your server entry and API key, and you can test everything together with us before you go live.