mc-gateway/examples/plugins/upstream-rewrite/README.md

Upstream Rewrite Plugin

This example registers upstream.connect/v1 in dialer mode. When match_host matches either the Minecraft hostname or the resolved upstream string, it dials the configured upstream and returns that connection. Non-matching connections return api.ErrPass.

Build and package:

(cd ../../.. && go run ./cmd/gateway plugin test examples/plugins/upstream-rewrite --profile manifest)
(cd ../../.. && go run ./cmd/gateway plugin build examples/plugins/upstream-rewrite --type both)

The binary package is written to dist/upstream-rewrite.mcgp; the source package is written to dist/upstream-rewrite-source.mcgp.

Build the source package through the gateway builder:

(cd ../../.. && go run ./cmd/gateway plugin build --from-source examples/plugins/upstream-rewrite/dist/upstream-rewrite-source.mcgp --out examples/plugins/upstream-rewrite/dist/upstream-rewrite-built.mcgp)

Example config JSON:

{
  "match_host": "play.example",
  "upstream": "127.0.0.1:25566"
}