feat: use vialite auto latest subprocess runtime

robinbraemer · web-flow · commit c174b3153769 · 2026-06-23T18:19:48.000+02:00
diff --git a/README.md b/README.md
@@ -60,6 +60,26 @@ graph LR
     style E fill:#a0526d,stroke:#222,stroke-width:2px
 ```
 
+## Java Version Compatibility
+
+Gate can start **Via-powered backend protocol translation** through managed
+vialite, so Java clients can join backend servers running different Minecraft
+versions without running a separate Via sidecar.
+
+Enable managed Via in classic proxy mode with:
+
+```yaml
+config:
+  via:
+    enabled: true
+```
+
+Gate starts the native vialite subprocess, resolves the latest stable vialite
+release automatically, downloads the checksummed artifact into the local cache,
+and routes backend connections through it. Exact release pins, offline mode, and
+local artifact paths remain available for controlled deployments, but no manual
+version setting is required for the default path.
+
 ## Gate Lite Mode
 
 Gate has a Lite Mode which is a lightweight version of Gate that can expose
diff --git a/config.yml b/config.yml
@@ -95,20 +95,18 @@ config:
     # Can also be set via environment variable: GATE_BUNGEEGUARD_SECRET
     #bungeeGuardSecret: secret_here
   # Via backend protocol translation for Gate classic mode.
-  # This loads vialite in-process at startup and routes configured classic backend connections
+  # This starts vialite at startup and routes configured classic backend connections
   # through Via-compatible translation before Gate dials the backend.
   # Not used in lite mode. Changes require a Gate restart.
   via:
     enabled: false
-    # Options: embedded, subprocess
-    mode: embedded
+    # Options: subprocess, embedded. Subprocess uses released vialite artifacts and is the default.
+    mode: subprocess
     # Optional local bind for the native runtime's internal loopback listener.
     #bind: 127.0.0.1:0
     # Optional artifact overrides.
     #libraryPath: /opt/vialite/libvialite.so
     #binaryPath: /opt/vialite/vialite
-    #version: v0.1.0
-    #mirror: https://github.com/minekube/vialite/releases/download
     #offline: false
   # Proxy protocol (HA-Proxy) determines whether Gate should support proxy protocol for players.
   # Do not enable this if you don't know what it is.
diff --git a/go.mod b/go.mod
@@ -35,7 +35,7 @@ require (
 	go.minekube.com/common v0.3.0
 	go.minekube.com/connect v0.6.2
 	go.minekube.com/geyserlite v0.3.14
-	go.minekube.com/vialite v0.1.0
+	go.minekube.com/vialite v0.2.7
 	go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp v0.64.0
 	go.opentelemetry.io/otel v1.41.0
 	go.opentelemetry.io/otel/metric v1.41.0
diff --git a/go.sum b/go.sum
@@ -254,8 +254,8 @@ go.minekube.com/connect v0.6.2 h1:RajPc7YgqygcOviV2g4xetL3J0Wzi8b/lsYXUzIltxE=
 go.minekube.com/connect v0.6.2/go.mod h1:28k11I4RyzUfAL3AkOXt3atzjeOFAC8eqbCMwsYKAb0=
 go.minekube.com/geyserlite v0.3.14 h1:+cSN9o/b5jEOHeym/uXvt5MEoGnrYloJidrVe9K9pWo=
 go.minekube.com/geyserlite v0.3.14/go.mod h1:yy0/M0zSD6X3FoQMwtmf5Jn+7YFM7AZWamKw0E8fnOE=
-go.minekube.com/vialite v0.1.0 h1:RMnNeDcDKchIs+N5KqxOzCK9tgkrVPjgUgjU5ARdn5o=
-go.minekube.com/vialite v0.1.0/go.mod h1:W9L1l8/b/GsLmkw1BW4wijaaPj/zV3OdrtYJgWdkhxE=
+go.minekube.com/vialite v0.2.7 h1:G5OuIt0qN4xfowW2rahZhb8zzMark5nI6AqubVBn6gQ=
+go.minekube.com/vialite v0.2.7/go.mod h1:W9L1l8/b/GsLmkw1BW4wijaaPj/zV3OdrtYJgWdkhxE=
 go.opencensus.io v0.18.0/go.mod h1:vKdFvxhtzZ9onBp9VKHK8z/sRpBMnKAsufL7wlDrCOA=
 go.opentelemetry.io/auto/sdk v1.2.1 h1:jXsnJ4Lmnqd11kwkBV2LgLoFMZKizbCi5fNZ/ipaZ64=
 go.opentelemetry.io/auto/sdk v1.2.1/go.mod h1:KRTj+aOaElaLi+wW1kO/DZRXwkF4C5xPbEe3ZiIhN7Y=
diff --git a/pkg/configs/config.yml b/pkg/configs/config.yml
@@ -95,20 +95,18 @@ config:
     # Can also be set via environment variable: GATE_BUNGEEGUARD_SECRET
     #bungeeGuardSecret: secret_here
   # Via backend protocol translation for Gate classic mode.
-  # This loads vialite in-process at startup and routes configured classic backend connections
+  # This starts vialite at startup and routes configured classic backend connections
   # through Via-compatible translation before Gate dials the backend.
   # Not used in lite mode. Changes require a Gate restart.
   via:
     enabled: false
-    # Options: embedded, subprocess
-    mode: embedded
+    # Options: subprocess, embedded. Subprocess uses released vialite artifacts and is the default.
+    mode: subprocess
     # Optional local bind for the native runtime's internal loopback listener.
     #bind: 127.0.0.1:0
     # Optional artifact overrides.
     #libraryPath: /opt/vialite/libvialite.so
     #binaryPath: /opt/vialite/vialite
-    #version: v0.1.0
-    #mirror: https://github.com/minekube/vialite/releases/download
     #offline: false
   # Proxy protocol (HA-Proxy) determines whether Gate should support proxy protocol for players.
   # Do not enable this if you don't know what it is.
diff --git a/pkg/edition/java/proxy/vialite.go b/pkg/edition/java/proxy/vialite.go
@@ -1,11 +1,12 @@
-//go:build !musl && !windows
+//go:build !musl
 
 package proxy
 
 import (
 	"context"
 	"fmt"
 	"net"
+	"runtime"
 	"strings"
 	"sync"
 	"time"
@@ -159,7 +160,7 @@ func (r *viaManagedRunner) BackendDialAddress(name string) (string, error) {
 
 func (r *viaManagedRunner) options() (vialite.Options, error) {
 	opts := vialite.Options{
-		Mode:        viaMode(r.cfg.Via.Mode),
+		Mode:        viaMode(r.cfg.Via.Mode, runtime.GOOS, r.cfg.Via.LibraryPath),
 		Bind:        r.cfg.Via.Bind,
 		LibraryPath: r.cfg.Via.LibraryPath,
 		BinaryPath:  r.cfg.Via.BinaryPath,
@@ -178,12 +179,18 @@ func (r *viaManagedRunner) options() (vialite.Options, error) {
 	return opts, nil
 }
 
-func viaMode(mode string) vialite.Mode {
-	switch mode {
-	case "subprocess":
+func viaMode(mode, goos, libraryPath string) vialite.Mode {
+	if mode == "" {
 		return vialite.ModeSubprocess
-	default:
+	}
+	if goos == "windows" && libraryPath == "" && mode == "embedded" {
+		return vialite.ModeSubprocess
+	}
+	switch mode {
+	case "embedded":
 		return vialite.ModeEmbedded
+	default:
+		return vialite.ModeSubprocess
 	}
 }
 
diff --git a/pkg/edition/java/proxy/vialite_disabled.go b/pkg/edition/java/proxy/vialite_disabled.go
@@ -1,4 +1,4 @@
-//go:build musl || windows
+//go:build musl
 
 package proxy
 
diff --git a/pkg/edition/java/proxy/vialite_test.go b/pkg/edition/java/proxy/vialite_test.go
@@ -1,4 +1,4 @@
-//go:build !musl && !windows
+//go:build !musl
 
 package proxy
 
@@ -216,6 +216,31 @@ func TestViaManagedRunnerOptionsMapConfig(t *testing.T) {
 	}
 }
 
+func TestViaModeDefaults(t *testing.T) {
+	tests := []struct {
+		name        string
+		mode        string
+		goos        string
+		libraryPath string
+		want        vialite.Mode
+	}{
+		{name: "linux empty defaults subprocess", mode: "", goos: "linux", want: vialite.ModeSubprocess},
+		{name: "linux explicit embedded", mode: "embedded", goos: "linux", want: vialite.ModeEmbedded},
+		{name: "linux subprocess", mode: "subprocess", goos: "linux", want: vialite.ModeSubprocess},
+		{name: "windows empty defaults subprocess", mode: "", goos: "windows", want: vialite.ModeSubprocess},
+		{name: "windows explicit embedded uses subprocess", mode: "embedded", goos: "windows", want: vialite.ModeSubprocess},
+		{name: "windows custom library explicit embedded", mode: "embedded", goos: "windows", libraryPath: "C:\\vialite\\libvialite.dll", want: vialite.ModeEmbedded},
+		{name: "windows subprocess", mode: "subprocess", goos: "windows", want: vialite.ModeSubprocess},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			if got := viaMode(tt.mode, tt.goos, tt.libraryPath); got != tt.want {
+				t.Fatalf("viaMode(%q, %q, %q) = %v, want %v", tt.mode, tt.goos, tt.libraryPath, got, tt.want)
+			}
+		})
+	}
+}
+
 func TestViaManagedRunnerOptionsUseConfiguredServerNames(t *testing.T) {
 	cfg := &config.Config{
 		Servers: map[string]string{

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-//go:build musl \|\| windows`
	`1`	`+//go:build musl`
`2`	`2`
`3`	`3`	`package proxy`
`4`	`4`