mc-gateway/examples/plugins/mc-auth-proxy/README.md

MC Auth Proxy Plugin

This example registers upstream.connect/v1 in protocol-proxy mode. It receives the complete Minecraft byte stream from the gateway, reads the handshake and login start packets, then returns a login disconnect response unless fixture_accept is enabled.

The example is intentionally small: gateway core does not parse authentication results, identity mapping, forwarding, or play packets. Those responsibilities belong inside a protocol-proxy plugin.

Build and package:

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

The binary package is written to dist/mc-auth-proxy.mcgp; the source package is written to dist/mc-auth-proxy-source.mcgp.

Build the source package through the gateway builder:

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

Example config JSON:

{
  "match_host": "play.example",
  "fixture_accept": false,
  "disconnect_message": "Authentication fixture rejected the login"
}