Skip to content
@groundsgg

Grounds Network

Official GitHub organization for Grounds.gg – building the next generation platform for Minecraft minigames.

Grounds

A home between matches.

Website · Documentation · Get in touch

We're building Grounds, a Minecraft minigame network for close matches, new friendships, and the moments that make you stay for one more round.

More to discover

Between matches, a world of stone, copper, and quiet mysteries awaits. Meet up with friends, wander a little further, and see what catches your eye. Some things are best discovered along the way.

Your next match. Your own pace.

Our starting lineup centers on SurvivalGames, BedWars, and kit-based 1vs1. Team up, test your skills, or jump straight into your next match through the game selector.

Core game modes are accessible from the start. Whether you're here to compete, practice with friends, or explore at your own pace, there's room for you in Grounds.

Built behind the scenes

This organization brings together the games and the platform that supports them:

  • Games and worlds — minigames, shared gameplay APIs, scenes, NPCs, and resource packs for Paper and Minestom.
  • One connected network — player identity, friends, parties, chat, matchmaking, and moderation across servers and proxies.
  • Tools for the team — the Grounds CLI, Gradle integrations, Forge, and Portal take plugins and services from local development into managed test and deployment environments.
  • Infrastructure — Kubernetes, Agones, maintained containers, and shared services provide the foundation for running it all.

We're building the player experience and its tools together, so the technology serves the worlds and games we want to create.

Explore the repositories, read the developer docs, or say hello.

AI assistance

Parts of our code, documentation, and other content are created with the help of AI tools. The Grounds team remains responsible for what we build and publish.

Pinned Loading

  1. keycloak-minecraft-idp keycloak-minecraft-idp Public

    Keycloak identity provider for Microsoft/Xbox sign-in, Minecraft Java and Bedrock identity resolution, and stable account linking.

    Kotlin 3

  2. library-motd library-motd Public

    Framework-independent Minecraft Java server-list editor and preview, with inline editing, MiniMessage, DOM and React adapters.

    TypeScript 1

  3. docs docs Public

    Official Grounds documentation for the developer platform, Minecraft plugins, APIs, and integrations, built with Mintlify.

    MDX

  4. grounds-dev grounds-dev Public

    Local Grounds development environment with k3d Kubernetes, Agones, PostgreSQL, and Valkey, provisioned with Make.

    Shell 1

  5. containers containers Public

    Docker and OCI images for Grounds Minecraft servers, proxies, build runners, and platform services.

    Java 1

Repositories

Showing 10 of 57 repositories
  • minestom-lobby Public

    Grounds lobby server on Minestom, composed with the shared runtime and integrated network chat, reporting, and player navigation.

    groundsgg/minestom-lobby's past year of commit activity
    Kotlin 0 AGPL-3.0 0 1 2 Updated Nov 1, 2026
  • library-scene Public

    Platform-neutral JSON scene format for Grounds, with typed models, strict validation, canonical serialization, and test helpers.

    groundsgg/library-scene's past year of commit activity
    Kotlin 0 0 0 1 Updated Nov 1, 2026
  • containers Public

    Docker and OCI images for Grounds Minecraft servers, proxies, build runners, and platform services.

    groundsgg/containers's past year of commit activity
    Java 0 Apache-2.0 1 0 6 Updated Nov 1, 2026
  • resourcepacks Public

    Grounds PackSet product: deterministic Minecraft content and platform packs, immutable manifests, and shared JVM catalogs and clients.

    groundsgg/resourcepacks's past year of commit activity
    Kotlin 0 AGPL-3.0 0 0 1 Updated Nov 1, 2026
  • plugin-scene-editor Public

    Paper plugin for authoring and validating Grounds map scenes, NPCs, and lobby actions on build servers.

    groundsgg/plugin-scene-editor's past year of commit activity
    Kotlin 0 0 0 1 Updated Nov 1, 2026
  • api-reference Public

    Central API reference for Grounds services, built from versioned OpenAPI snapshots with Scalar and served by a Cloudflare Worker.

    groundsgg/api-reference's past year of commit activity
    TypeScript 0 MIT 0 0 7 Updated Nov 1, 2026
  • service-maps Public

    Grounds map registry for content-addressed versions, publishing, and environment pins, with R2 storage and CDN distribution.

    groundsgg/service-maps's past year of commit activity
    Kotlin 0 AGPL-3.0 0 0 5 Updated Nov 1, 2026
  • grounds-connect Public

    Fabric client mod for signing in to Grounds, browsing project servers, and joining developer environments from Minecraft.

    groundsgg/grounds-connect's past year of commit activity
    Java 0 Apache-2.0 0 0 5 Updated Nov 1, 2026
  • charts Public

    Reusable Helm charts for deploying Grounds services and infrastructure to Kubernetes, published as OCI artifacts.

    groundsgg/charts's past year of commit activity
    Shell 0 Apache-2.0 0 1 1 Updated Nov 1, 2026
  • .github Public

    Organization-level GitHub configuration: issue and PR templates, reusable workflows, and OpenAPI snapshot publishing for Grounds services.

    groundsgg/.github's past year of commit activity
    Python 0 0 1 0 Updated Nov 1, 2026