Cómo desplegamos minecr4ft en K3s

Este artículo explica la arquitectura detrás de minecr4ft — qué tecnologías usamos y por qué.

Stack tecnológico

minecr4ft corre sobre un cluster de Kubernetes (K3s) en un VPS privado. Esto nos da:

• Alta disponibilidad — si un pod se cae, Kubernetes lo reinicia automáticamente
• Escalado — podemos añadir más nodos si hay más jugadores
• Storage persistente — los datos del mundo de Minecraft sobreviven entre reinicios
• Aislamiento — cada componente (vanilla, mods, web) corre en su propio namespace

Componentes

minecr4ft corre detrás de un tunnel de Cloudflare que conecta el VPS a internet sin abrir puertos públicos directamente.

nginx actúa como proxy reverso haciendo SSL termination y routing:

• minecr4ft.loust.pro → archivos estáticos del blog
• mods.minecr4ft.loust.pro → servidor de mods (Fabric)
• play.minecr4ft.loust.pro → web client (conecta al cluster K3s)

Dentro del cluster K3s corren dos sabores de Minecraft:

• Vanilla — Paper 1.21.4, el server clásico
• Mods — Fabric 1.21.4, con mods de rendimiento y gameplay

El mc-web-client es un servicio que acepta conexiones WebSocket desde el navegador y las tunela al servidor de Minecraft.

Minecraft web client — cómo funciona

El web client es posible gracias a zardoy/minecraft-web-client — conecta tu navegador directamente al servidor de Minecraft usando WebSockets y el protocolo de red de Minecraft.

1. Tu navegador establece conexión WebSocket con play.minecr4ft.loust.pro
2. nginx proxea esa conexión al servicio mc-web-client dentro del cluster K3s
3. El servicio usa net-browserify para crear un túnel TCP entre tu navegador y el servidor de Minecraft
4. El servidor de Minecraft valida tu cuenta con Microsoft (auth de Xbox Live)
5. Si es válido, entras al mundo

Bridge — el pegamento

El bridge (bridge.mjs) es un servicio Node.js que actúa como:

• Portal de registro — gestiona usuarios y sesiones (SQLite)
• Whitelist manager — agrega/quita usernames del server Minecraft via RCON
• API de status — expone el estado público del server

El bridge está fuera de K3s (systemd en el host) porque es más simple así para la etapa actual.

Sin telemetry

Todo es self-hosted. No hay Google Analytics, no hay tracking, no hay third-party scripts. Lo que juegas en minecr4ft se queda en minecr4ft.

¿Preguntas?

Discord · GitHub