mcfix
Sistema PHP/SQLite para automatizar reportes y reparaciones en servidores Minecraft. Conecta al servidor, verifica problemas (whitelist, bans, plugins) y ejecuta correcciones sin intervención manual. Cero dependencias externas, ideal para paneles como Pterodactyl o BT.
Ficha actualizada 24 sept 2026, 22:45 · upstream 24 sept 2026, 22:02 · release sin release detectada
Qué es mcfix
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
mcfix es una herramienta de automatización diseñada para gestionar incidencias en servidores Minecraft. Permite a los usuarios reportar problemas mediante un enlace público, donde el sistema conecta directamente al servidor para diagnosticar y aplicar reparaciones automáticas como añadir a la whitelist, desbanear jugadores o reiniciar instancias. La arquitectura se basa en PHP estándar con SQLite, eliminando la necesidad de Composer o Node.js, lo que facilita una instalación 'upload and run'.
El sistema opera mediante un agente ligero desplegado en el servidor de Minecraft (solo Linux) o a través de APIs de paneles como Pterodactyl y BT. Utiliza RCON para ejecutar comandos del juego y SSH para gestión de archivos, asegurando que las acciones críticas se realicen sin abrir puertos entrantes en la máquina del servidor. Incluye análisis de logs de clientes para detectar errores de mods o falta de memoria.
Destaca por su enfoque de seguridad 'zero-trust' en el frontend (sin sesión persistente) y su capacidad de auto-reparación verificada. Ofrece notificaciones vía email, Telegram, Discord, etc., y permite auditoría completa mediante logs detallados en un panel administrativo independiente.
- Diagnóstico automático de errores de conexión (whitelist/ban)
- Reinicio forzado de servidor tras caída o TPS bajo
- Análisis de crashes de cliente (mods faltantes/Java)
- Gestión de plugins mediante reload/restart sin acceso SSH directo
- Notificación de incidencias a admins y jugadores
- Arquitectura zero-dependency (PHP nativo + SQLite)
- Agente ligero en servidor MC (solo Linux) sin puertos entrantes
- Soporte multi-panel (Pterodactyl, BT, MCSManager)
- Análisis de logs de cliente para errores de mods/Java
- Seguridad: frontend sin sesión persistente y CSRF protegido
- El agente requiere sistema operativo Linux en el servidor MC
- No soporta servidores antiguos (vulnerabilidad histórica <1.10.1)
- Requiere acceso RCON o API del panel para ejecución de comandos
- Base de datos SQLite no ideal para clusters masivos
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.
Desplegar PHP 7.4+ con SQLite. Configurar Nginx apuntando a /public. Instalar agente en MC (solo Linux) o usar RCON/API del panel. Usar bin/mcfix.php cron para mantenimiento. Verificar permisos y extensiones (pdo_sqlite, mbstring).
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.