FAQ

FAQ

  • Can servers sleep when nobody is playing?

    Yes, with spec.autoSleep on a Server. In Pause mode (the default, Minecraft 1.21.2 or later) the server stops ticking while it is empty. In Hibernate mode it is stopped completely and started again when a player connects through a Router. timeoutSeconds sets how long a server has to be empty first.

  • Do I need the Gateway API?

    No. The Gateway API integration is optional. If you use it, Kobblestone needs Gateway API v1.6.0 or later with TCPRoute support. Without it, use a Router or a LoadBalancer Service.

  • How do I sign in a Microsoft account for a bot?

    Create an Account. Kobblestone starts the Microsoft device code flow and shows the code and link in the Account’s status (kubectl get account <name> -o yaml). Open the link, enter the code, and the Account becomes Authorized. From then on the session is refreshed automatically, and Bots that reference the Account restart with the new session.

    For offline-mode servers you can skip the Account and set offlineUsername on the Bot instead.

  • How do players connect to my servers?

    Servers are only reachable inside the cluster by default. There are three ways to expose them:

    • Gateway API: attach the server to a TCP listener of your Gateway with spec.tcpRoute. Kobblestone manages the TCPRoute for you.
    • Router: expose a single Router and give each server a hostname with spec.route. Players are routed by the address they connect to.
    • LoadBalancer Service: set spec.service.type: LoadBalancer. Simple, but every server gets its own external IP. If that IP is reachable from the internet, disable RCON.
  • I found a bug or have an idea. Where do I go?

    Open an issue on GitHub. Bug reports with the resource manifest, the operator logs and the Kubernetes version help a lot. Pull requests are welcome too.

  • Is Kobblestone affiliated with Mojang or Microsoft?

    No. Kobblestone is an independent open source project and is not affiliated with, endorsed by or associated with Mojang Studios or Microsoft. Minecraft is a trademark of Mojang Synergies AB.

  • Is Kobblestone free?

    Yes. Kobblestone is open source under the Apache License 2.0. You only pay for the cluster you run it on.

  • Is Kobblestone ready for production?

    Not yet. Kobblestone is in an early alpha phase and highly experimental. All resources use the v1alpha1 API version. Some features and concepts are not fully implemented yet, and fields or behavior can change between releases, sometimes with manual migration steps (check the changelog before upgrading).

    It is a great fit for home labs, test clusters and experiments. If you run worlds you care about, keep independent backups.

  • What is Kobblestone?

    Kobblestone is a Kubernetes operator for running Minecraft server infrastructure. It adds custom resources such as Server, Network, Router, Backup and Bot to your cluster, and keeps the real workloads (StatefulSets, Services, Jobs, Secrets) in line with what you declared.

  • Where are backups stored?

    In a BackupRepo, which is either an S3-compatible bucket or a PersistentVolumeClaim. Running servers are backed up live, coordinated over RCON; stopped servers are backed up offline. Backups and restores of the same server are queued and run one after another, so they never get in each other’s way.

  • Which Minecraft server types are supported?

    Set spec.type on a Server to one of: Vanilla, Paper, Purpur, Folia, Pufferfish, Spigot, Bukkit, Fabric, Quilt, Forge, Magma, Ketting, Mohist, Catserver, SpongeVanilla, Crucible, Limbo or AutoCurseForge. The game version is set with spec.version.

    Servers run on the excellent itzg/minecraft-server image.