minecraft
Stack para servidores de Minecraft autoalojados en Raspberry Pi 5 (ARM64). Incluye Docker Compose, backups automáticos, gestión de plugins y mods, soporte multi-mundo, API REST y panel web React.
Ficha actualizada 23 sept 2026, 1:26 · upstream 23 sept 2026, 1:23 · release v1.5.0
Qué es minecraft
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este proyecto es una solución completa para alojar servidores de Minecraft en un Raspberry Pi 5. Se basa en Docker Compose con unidades systemd para iniciar el servidor al arrancar del sistema operativo. Incluye automatización de backups (con retención), gestión de plugins y mods (Paper, Spigot, Fabric, Forge), soporte multi-mundo con respaldo por mundo, una API REST y un panel web React con autenticación mediante OAuth. El proyecto está optimizado para el Raspberry Pi 5 ARM64, aunque también funciona en arquitectura x86_64.
- Alojar servidores de Minecraft en Raspberry Pi 5 (ARM64) sin necesidad de hardware dedicado
- Gestionar múltiples mundos con respaldo automático y offsite a S3/B2/R2
- Administración remota mediante API REST y panel web React para jugadores
- Monitoreo de rendimiento, logs y métricas del servidor en tiempo real
- Actualizaciones guiadas de versiones con validación de compatibilidad
- Gestión de whitelist, baneos y permisos de usuarios
- Optimizado para Raspberry Pi 5 (ARM64) mediante imágenes multi-arch Docker
- Backup automático programado con systemd timer y respaldo offsite a S3/B2/R2
- API REST completa con React admin panel que cubre control de servidor, jugadores, mundos, plugins, logs y API keys
- Sistema de autenticación OAuth para el panel web y gestión segura de permisos
- Verificación de versiones y compatibilidad antes de actualizar el servidor
- No se documentan variables de entorno (`.env`) en el README, lo que puede complicar la configuración personalizada
- El panel web React no incluye autenticación por contraseña integrada, requiriendo OAuth externo
- La documentación del API está disponible como OpenAPI spec pero no es un endpoint público directo
- No se documenta explícitamente el uso de tarjetas NVMe para mejorar rendimiento en entornos con limitaciones de RAM
- El proyecto depende de Docker Compose v2 y requiere instalación manual del plugin
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Instala Docker Compose v2 desde la configuración. Usa unidades systemd (`minecraft.service`, `minecraft-api.service`) que se ejecutan al iniciar el sistema. Para actualizar, usa `./scripts/manage.sh update [version]` o `make update`. El servidor corre en puerto 64 y la API en 25565. Se recomienda usar un disco NVMe para evitar cuellos de botella con el SSD por defecto del Raspberry Pi.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.