Un panel de servidor, un launcher portable y un laboratorio de pruebas para que un grupo de amigos pueda entrar a un Minecraft con mods sin tocar router, sin romper su .minecraft y sin saber de Java, Forge ni carpetas raras.

Este proyecto nació de una necesidad muy real: jugar con amigos que solo quieren pulsar un botón y entrar. No querían instalar VPNs, no querían abrir puertos, no querían borrar su .minecraft y no querían pelearse con mods incompatibles. Así que ScoobCoding convirtió todo ese caos en una experiencia empaquetada: servidor controlado desde macOS, túnel público, cliente portable para Windows y pruebas reproducibles.

Montar un servidor modded suele fallar por pequeñas cosas: una versión distinta de Forge, un mod que falta, una carpeta mal puesta, Java equivocado, RAM mal asignada, IP cambiante, puertos cerrados o amigos que no tienen ninguna gana de depurar un log. Este repo intenta resolver ese problema desde el producto, no desde el tutorial eterno.

• Para el host: panel macOS con botones claros para iniciar local, iniciar público, ver IP, abrir configs y validar.
• Para los amigos: launcher Windows portable; escriben nombre, elige RAM segura, prepara su carpeta aislada y abre Minecraft.
• Para mantenimiento: documentación, scripts y laboratorio para que otra persona o IA pueda entender qué se hizo y cómo seguir.

Server Panel	Portable Launcher

Primera apertura	Opciones de cliente

La historia del proyecto también está documentada como una pieza visual: de la duda inicial al servidor funcional, el launcher portable, las pruebas y el cierre listo para GitHub.

server/       Scripts, configs ejemplo y validación del servidor Forge.
client/       Código fuente del launcher portable Windows.
mac-panel/    Código Swift del panel macOS.
lab/          Laboratorio de validación y pruebas automatizadas.
docs/         Arquitectura, setup, seguridad, errores reales y showcase visual.
tools/        Utilidades auxiliares para mantenimiento.

flowchart LR
  Host["Mac host\nMinecraft Server Panel"] --> Forge["Forge server\n1.20.1 + mods"]
  Host --> Playit["Public tunnel\nno router ports"]
  Playit --> Friends["Friends outside LAN"]
  Friends --> Launcher["Windows portable launcher"]
  Launcher --> Isolated["ScoobCodingClient/conf\nisolated .minecraft"]
  Isolated --> Game["Minecraft client\npreconfigured server"]
  Lab["QA lab"] --> Host
  Lab --> Launcher
  Lab --> Forge

1. El host prepara Forge y mods en el servidor.
2. El panel macOS valida configs, mods, Playit y arranque.
3. El túnel público da una dirección estable para los amigos.
4. El launcher Windows crea ScoobCodingClient/conf junto al .exe.
5. El launcher detecta RAM/GPU, prepara Minecraft y añade el servidor ScoobCoding.
6. El jugador pulsa jugar y entra sin tocar su instalación personal.

• Un botón antes que diez instrucciones.
• Carpeta aislada antes que tocar la .minecraft real.
• Validación antes que promesas.
• Configs ejemplo antes que secretos reales.
• Documentación para humanos y para futuras IAs mantenedoras.

• Launcher portable probado en portátil Windows con GPU integrada AMD Ryzen.
• Launcher portable probado en portátil Windows con GPU dedicada RTX.
• Túnel público probado desde redes diferentes.
• Servidor Forge validado con arranque, puerto, mods, parada limpia y reinicio.
• Whitelist desactivada por decisión del operador.
• Dificultad ajustada a easy y mobs de Ice and Fire suavizados para una experiencia menos abusiva.

Por seguridad y licencias, este repo no publica directamente:

• mundos reales;
• claves Playit;
• logs privados;
• rutas personales;
• .minecraft privada;
• mods .jar redistribuidos sin revisar licencia;
• ejecutables finales o payloads pesados.

Los binarios y modpacks deben publicarse como release solo cuando las licencias y permisos estén claros.

• Historia del proyecto
• Arquitectura
• Setup
• Errores reales y soluciones
• Guía para mantenedores IA
• QA y límites honestos
• Seguridad
• Showcase visual
• Launch post

git clone https://github.com/ScoobCoding/scoobcoding-minecraft-ops.git
cd scoobcoding-minecraft-ops

Después sigue docs/SETUP.md. Este repo documenta y contiene el código base, pero no incluye los mods propietarios ni credenciales privadas.

ScoobCoding no intenta vender magia. Intenta eliminar fricción. Si algo puede romperse por una carpeta, una versión o un botón confuso, se convierte en una comprobación, una interfaz o una guía. Esa es la diferencia entre “te explico cómo montarlo” y “te doy una experiencia que tus amigos pueden usar”.