Skip to content
mythicislandPublic

About

Lightweight, extensible and scalable matchmaking for Minecraft

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Queue

A lightweight and extensible matchmaking queue for Minecraft networks running on SimpleCloud.

Note

Queue is currently in beta and there is no real documentation yet. It works, but I can't recommend it for production networks yet.

Features

  • Queue types: Configure each gamemode in YAML.
  • Matchmaking: Match players with similar values like rating and widen the search the longer they wait.
  • Teams: Split every match into balanced teams.
  • Multiple players per ticket: Queue several players together and search in multiple queue types at once.
  • Server allocation: Find a server for every match through SimpleCloud and start new ones when needed.
  • High availability: Run several instances on Kubernetes, if one goes down another one takes over.
  • Monitoring: Export metrics to any OpenTelemetry collector.
  • Ticket expiry: Remove tickets after a maximum wait time or too many failed matches.
  • Backfill: Fill running matches with players from the queue, e.g. to replace players who left.
  • Wait time estimates: Show players how long they will probably wait.
  • Filters: Only let tickets into a queue type that match fixed values, e.g. a region or client version.

Requirements

  • A SimpleCloud network
  • NATS with JetStream enabled
  • Docker

Getting started

The easiest way is the compose file in deployment. It starts the queue and NATS:

cd deployment
docker compose up -d

About

Lightweight, extensible and scalable matchmaking for Minecraft

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages