Ir al contenido

Depurando el tráfico de red de Minecraft

Este documento describe cómo depurar el tráfico de red de Minecraft para inspeccionar cómo los paquetes son enviados.

Para empezar, tienes que desactivar la compresión y el encriptado. El límite de la compresión debe ser puesto a 1024. Puedes encontrar este ajuste en config/steel_config.json5, que es generado tras la primera ejecución del servidor.

Vas a necesitar:

  • Un servidor local de Minecraft
  • Wireshark ejecutándose de fondo con permisos de administración (o los permisos adecuados) captando el tráfico de localhost

Los paquetes captados pueden ser comparados con la documentación oficial del protocolo: https://minecraft.wiki/w/Java_Edition_protocol/Packets

Esto ayuda a entender los tipos de paquete y lo que describen.

Puedes iniciar Wireshark en cualquier momento para observar los paquetes, pero para una lectura más sencilla, es recomendado compilar y usar un Wireshark dissector plugin.

Repositorio: https://github.com/Nickid2018/MC_Dissector

Requisitos:

  • Wireshark 4.6 (recomendado)

Nuestra recomendación es que compiles este plugin por ti mismo empleando las instrucciones en el archivo ci.yaml del repositorio.

Para Linux:
Tras compilarlo, copia el archivo .so a:

Ventana de terminal
~/.local/lib/wireshark/plugins/<Wireshark Version>/epan

Para Windows:
Tras compilarlo, copia el archivo .dll a:

Ventana de terminal
plugins/<Wireshark Version>/epan

Ajusta la ruta de acuerdo a tu versión de Wireshark.

Clona el repositorio de datos del protocolo:

https://github.com/Nickid2018/MC_Protocol_Data

Inicia Wireshark (en Linux, para la captura de tu mismo dispositivo, tu usuario debe estar en el grupo wireshark).

Ahora navega hasta:

Preferencias → Protocols → Minecraft

Selecciona el protocolo y configura la ruta al clon de MC_Protocol_Data. Tras ello, reinicia Wireshark.

Para poder ver de forma correcta el tráfico de Minecraft, usa este filtro:

mcje

Al final, los paquetes aparecerán de una forma mucho más legible que la información de red en bruto, haciendo el depurado del protocolo mucho más sencillo.

Vistazo a Wireshark

Estos recursos pueden ayudarte a tener un entendimiento mayor: