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.
- 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.
- A SimpleCloud network
- NATS with JetStream enabled
- Docker
The easiest way is the compose file in deployment. It starts the queue and NATS:
cd deployment
docker compose up -d