gopax

Proxy TCP para Minecraft Java Edition escrito em Go. Intercepta e registra pacotes do protocolo Minecraft em tempo real com log colorido no terminal.

Requisitos

• Go 1.21+

Build & Run

Docker Compose (recomendado)

Sobe o proxy e um servidor PaperSpigot juntos:

docker compose up --build

O proxy ficará disponível na porta 25565 do host e encaminhará para o container minecraft.

Local

go build -o proxy ./cmd/proxy
./proxy

Por padrão, o proxy escuta em :25565 e encaminha para 127.0.0.1:25566.

Flags

Flag	Padrão	Descrição
-listen	:25565	Endereço de escuta do proxy
-backend	127.0.0.1:25566	Endereço do servidor Minecraft

Exemplo com flags customizadas:

./proxy -listen :25565 -backend 127.0.0.1:25566

Configuração do servidor Minecraft

O proxy escuta na porta padrão do Minecraft (25565) e encaminha para o servidor na porta 25566. Configure o server.properties do seu servidor:

server-port=25566

Em desenvolvimento: o proxy ainda não implementa autenticação online. Adicione também:

online-mode=false

Fluxo

Cliente → :25565 (proxy) → :25566 (servidor Minecraft)

Como funciona

• Intercepta todos os pacotes TCP nas duas direções (cliente→servidor e servidor→cliente)
• Faz log colorido de cada pacote: estado do protocolo, ID e tamanho
• Gerencia transições de estado do protocolo Minecraft: Handshaking → Status/Login → Configuration → Play
• Detecta e ativa compressão de pacotes automaticamente (Set Compression 0x03)