Merge branch 'master' into master

Author: raphael-goetz

.examples/bedrock/docker-compose.yml

@@ -2,12 +2,13 @@ services:
   gate:
     image: ghcr.io/minekube/gate:latest
     restart: unless-stopped
+    working_dir: /data
     environment:
-      - GATE_CONFIG_PATH=/gate/gate.yml
+      - GATE_CONFIG=/config/gate.yml
     volumes:
-      - ./gate.yml:/gate/gate.yml
-      - gate-cache:/gate/.cache
-      - gate-data:/gate/data
+      - ./gate.yml:/config/gate.yml:ro
+      - gate-cache:/var/cache/gate
+      - gate-data:/data
     ports:
       - '25565:25565' # Java Edition
       - '19132:19132/udp' # Bedrock Edition

.github/testdata/managed-bedrock.yml

@@ -0,0 +1,11 @@
+config:
+  bind: 0.0.0.0:25565
+  onlineMode: false
+  servers:
+    backend: 127.0.0.1:25566
+  try:
+    - backend
+  bedrock:
+    enabled: true
+    floodgateKeyPath: /tmp/floodgate.pem
+    managed: true

.github/workflows/ci.yml

@@ -17,19 +17,18 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
 
       - name: Setup Go
-        uses: actions/setup-go@v5
+        uses: actions/setup-go@v6
         with:
           go-version-file: go.mod
 
+      - name: Install golangci-lint
+        run: go install github.com/golangci/golangci-lint/cmd/golangci-lint@v1.64.8
+
       - name: golangci-lint
-        uses: golangci/golangci-lint-action@v6
-        with:
-          version: latest
-          install-mode: goinstall
-          args: --timeout 3m0s
+        run: golangci-lint run --timeout 3m0s
   test:
     strategy:
       fail-fast: false
@@ -38,34 +37,43 @@ jobs:
     runs-on: ${{ matrix.platform }}
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
 
       - name: Setup Go with cache
-        uses: actions/setup-go@v5
+        uses: actions/setup-go@v6
         with:
           cache: true
           go-version-file: go.mod
 
       - name: Test
         run: make test
+
+      - name: Smoke test - Geyserlite Windows auto-download starts
+        if: matrix.platform == 'windows-latest'
+        run: go test ./pkg/edition/bedrock/geyser -tags=geyserlite_smoke -run TestLiteManagedRunnerWindowsAutoDownloadSmoke -count=1 -timeout 6m -v
   # Regression test for https://github.com/minekube/gate/issues/697:
   # The published images crashed with "exec /gate: no such file or directory"
   # because the gate binary is dynamically linked (the geyserlite dependency
   # pulls in github.com/ebitengine/purego, which imports libdl.so.2 via
   # //go:cgo_import_dynamic even with CGO_ENABLED=0) but the runtime base image
   # had no glibc dynamic loader. This job builds the actual images and runs the
-  # binary so a broken runtime base fails CI instead of shipping.
+  # binary and starts managed Bedrock on both architectures so broken runtime
+  # dependencies or cache paths fail CI instead of shipping.
   docker-smoke:
-    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        runner: [ubuntu-latest, ubuntu-24.04-arm]
+    runs-on: ${{ matrix.runner }}
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
 
       - name: Set up docker buildx
-        uses: docker/setup-buildx-action@v3
+        uses: docker/setup-buildx-action@v4
 
       - name: Build gate image (host arch, load)
-        uses: docker/build-push-action@v6
+        uses: docker/build-push-action@v7
         with:
           context: .
           file: ./Dockerfile
@@ -81,8 +89,27 @@ jobs:
           echo "$out"
           echo "$out" | grep -q "gate version smoke-test"
 
+      - name: Smoke test - managed Bedrock starts in read-only distroless image
+        run: |
+          cid=$(docker run -d --read-only --tmpfs /tmp \
+            -v "$PWD/.github/testdata/managed-bedrock.yml:/config.yml:ro" \
+            gate:smoke --config /config.yml)
+          trap 'docker logs "$cid" 2>&1 || true; docker rm -f "$cid" >/dev/null 2>&1 || true' EXIT
+
+          for _ in $(seq 1 180); do
+            logs=$(docker logs "$cid" 2>&1)
+            if grep -q "geyser integration started" <<<"$logs"; then
+              exit 0
+            fi
+            if [ "$(docker inspect -f '{{.State.Running}}' "$cid")" != "true" ]; then
+              exit 1
+            fi
+            sleep 1
+          done
+          exit 1
+
       - name: Build jre variant image (host arch, load)
-        uses: docker/build-push-action@v6
+        uses: docker/build-push-action@v7
         with:
           context: .
           file: ./Dockerfile
@@ -109,13 +136,13 @@ jobs:
       image_latest: ${{ steps.image-ref.outputs.image_latest }}
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
 
       - name: Set up docker buildx
-        uses: docker/setup-buildx-action@v3
+        uses: docker/setup-buildx-action@v4
 
       - name: Login to Container registry
-        uses: docker/login-action@v3
+        uses: docker/login-action@v4
         with:
           registry: ${{ env.REGISTRY }}
           username: ${{ github.actor }}
@@ -157,7 +184,7 @@ jobs:
           echo "Version: ${VERSION}" >> $GITHUB_STEP_SUMMARY
 
       - name: Build and push docker image
-        uses: docker/build-push-action@v6
+        uses: docker/build-push-action@v7
         with:
           context: .
           file: ./Dockerfile
@@ -174,7 +201,7 @@ jobs:
             ${{ steps.image-ref.outputs.image_version }}
 
       - name: Build and push docker image (jre variant)
-        uses: docker/build-push-action@v6
+        uses: docker/build-push-action@v7
         with:
           context: .
           file: ./Dockerfile
@@ -196,18 +223,18 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
         with:
           fetch-depth: 0
 
       - name: Setup Go
-        uses: actions/setup-go@v5
+        uses: actions/setup-go@v6
         with:
           cache: true
           go-version-file: go.mod
 
       - name: Run GoReleaser
-        uses: goreleaser/goreleaser-action@v6
+        uses: goreleaser/goreleaser-action@v7
         with:
           version: latest
           args: release --clean

.web/docs/developers/api/go/integration-options.md

@@ -6,7 +6,7 @@ description: "Learn different ways to integrate Gate Minecraft proxy with Go app
 <div class="integration-options">
   <a href="https://github.com/minekube/gate-plugin-template" class="option-card" target="_blank">
     <div class="option-content">
-      <h3>🔌 Native Go Plugin</h3>
+      <h3>Native Go Plugin</h3>
       <ul>
         <li>Create your own Go module and import Gate APIs</li>
         <li>Compile like a normal Go program</li>
@@ -22,7 +22,7 @@ description: "Learn different ways to integrate Gate Minecraft proxy with Go app
 
   <a href="/developers/api/" class="option-card">
     <div class="option-content">
-      <h3>🌐 HTTP API Client</h3>
+      <h3>HTTP API Client</h3>
       <ul>
         <li>Language-agnostic interface</li>
         <li>Perfect for out-of-process execution</li>

.web/docs/developers/api/index.md

@@ -31,27 +31,27 @@ The HTTP API enables you to build and deploy functionality independently from yo
 
 <div class="vp-features">
   <div class="vp-feature">
-    <div class="title">🚀 Independent Updates</div>
+    <div class="title">Independent Updates</div>
     <div class="details">Ship updates without restarting Gate or disconnecting players</div>
   </div>
   <div class="vp-feature">
-    <div class="title">🌐 Cross-Language Support</div>
+    <div class="title">Cross-Language Support</div>
     <div class="details">Access Gate's core functionality from any programming language</div>
   </div>
   <div class="vp-feature">
-    <div class="title">🔌 Plugin Development</div>
+    <div class="title">Plugin Development</div>
     <div class="details">Build extensions and plugins in your preferred language</div>
   </div>
   <div class="vp-feature">
-    <div class="title">🤖 Automation</div>
+    <div class="title">Automation</div>
     <div class="details">Automate server registration and management tasks</div>
   </div>
   <div class="vp-feature">
-    <div class="title">🎮 Custom Tools</div>
+    <div class="title">Custom Tools</div>
     <div class="details">Create administrative interfaces and management tools</div>
   </div>
   <div class="vp-feature">
-    <div class="title">🔄 Integration</div>
+    <div class="title">Integration</div>
     <div class="details">Connect Gate with external systems and services</div>
   </div>
 </div>

.web/docs/developers/api/java/pom.xml

@@ -33,28 +33,28 @@
         <dependency>
             <groupId>build.buf.gen</groupId>
             <artifactId>minekube_gate_protocolbuffers_java</artifactId>
-            <version>29.5.0.1.20241118150055.50fffb007499</version>
+            <version>29.5.0.2.20241118150055.50fffb007499</version>
         </dependency>
         <dependency>
             <groupId>build.buf.gen</groupId>
             <artifactId>minekube_gate_grpc_java</artifactId>
-            <version>1.78.0.1.20241118150055.50fffb007499</version>
+            <version>1.81.0.1.20241118150055.50fffb007499</version>
         </dependency>
         <!-- gRPC dependencies -->
         <dependency>
             <groupId>io.grpc</groupId>
             <artifactId>grpc-netty-shaded</artifactId>
-            <version>1.78.0</version>
+            <version>1.81.0</version>
         </dependency>
         <dependency>
             <groupId>io.grpc</groupId>
             <artifactId>grpc-protobuf</artifactId>
-            <version>1.78.0</version>
+            <version>1.81.0</version>
         </dependency>
         <dependency>
             <groupId>io.grpc</groupId>
             <artifactId>grpc-stub</artifactId>
-            <version>1.78.0</version>
+            <version>1.81.0</version>
         </dependency>
         <!-- Protobuf dependencies -->
         <dependency>

.web/docs/developers/api/kotlin/build.gradle.kts

@@ -11,7 +11,7 @@ repositories {
     }
 }
 
-val grpcVersion = "1.78.0"
+val grpcVersion = "1.81.0"
 val grpcKotlinVersion = "1.5.0"
 val connectVersion = "0.7.1"
 val protobufVersion = "4.33.4"

.web/docs/developers/index.md

@@ -12,11 +12,11 @@ _If you want to learn how to extend Gate with your own code, you are in the righ
 ## Starter Template
 
 The starter template is designed to help you get started with your own Gate powered project.
-Fork it! 🚀 - [minekube/gate-plugin-template](https://github.com/minekube/gate-plugin-template)
+Fork it: [minekube/gate-plugin-template](https://github.com/minekube/gate-plugin-template)
 
 ## Any Language
 
-Go to the [API](/developers/api/) 🌐 section to learn how to use Gate's API from any programming language.
+Go to the [API](/developers/api/) section to learn how to use Gate's API from any programming language.
 
 ## Integration Options
 

.web/docs/developers/sound.md

@@ -86,7 +86,7 @@ Sound sources determine which volume slider in the client controls the sound:
 | Player actions      | `sound.SourcePlayer`        |
 | Ambient sounds      | `sound.SourceAmbient`       |
 | Voice chat          | `sound.SourceVoice`         |
-| Interface sounds    | `sound.SourceUI` ⚠️ 1.21.5+ |
+| Interface sounds    | `sound.SourceUI` (1.21.5+) |
 
 ### Parsing Sound Sources