Cómo resolver "mod incompatible" o crashes al cargar mods

1. Dónde encontrar la información del crash

Cuando el servidor falla al iniciar, Minecraft suele generar dos tipos de archivo útiles:

• logs/latest.log — registro completo de lo que pasó hasta el fallo.
• crash-reports/crash-*.txt — informe detallado del error, normalmente más fácil de leer.

Accede a estos archivos desde la pestaña Archivos del panel.

2. Verificando la versión de Forge/Fabric/NeoForge

La causa más común de crash es la incompatibilidad de versión:

• Comprueba que el mod se hizo para la misma versión de Minecraft instalada en el servidor (ej.: un mod para 1.20.1 en un servidor 1.21 no funciona).
• Comprueba que el mod es para el loader correcto: un mod de Fabric no funciona en un servidor Forge, y viceversa.

3. Dependencias faltantes

Muchos mods dependen de bibliotecas extra para funcionar. Las más comunes son:

• Fabric API (obligatoria para la mayoría de los mods de Fabric).
• Forge Config API Port, Architectury API, Cloth Config (usadas por varios mods multiplataforma).

En el crash-report, busca mensajes como:

  Mod X requires Y, which is missing

Eso indica exactamente qué dependencia hay que instalar en la carpeta mods.

4. Mods del cliente ejecutándose en el servidor

Algunos mods son solo para el cliente (ej.: mods de interfaz, shaders, minimapas) y no deben ponerse en el servidor; esto suele causar un crash inmediato al iniciar.

5. Encontrando qué mod causa el problema

En el crash-report, busca la sección "Affected Mods" o el stacktrace, que normalmente muestra el nombre del mod culpable al inicio del error.

Si no está claro, usa el método de bisección:

1. Quita la mitad de los mods de la carpeta mods (muévelos a otra carpeta, no los borres).
2. Reinicia el servidor.
3. Si el error desaparece, el mod problemático está en el grupo que quitaste; repite dividiendo ese grupo a la mitad.
4. Si el error continúa, el problema está en el grupo que quedó; repite el proceso.

6. Conflicto entre mods

Dos mods pueden entrar en conflicto cuando modifican lo mismo del juego (ej.: dos mods que cambian la generación del mundo). En ese caso:

• Verifica si existe una versión de compatibilidad entre ellos (muchos mods populares lanzan "compat patches").
• Consulta la página del mod en CurseForge/Modrinth por avisos de incompatibilidad conocidos.

7. Soluciones más comunes

• Actualizar el mod a la versión más reciente compatible con el servidor.
• Instalar la dependencia que falta.
• Quitar los mods del cliente de la carpeta del servidor.
• Reinstalar Forge/Fabric si los archivos del loader están dañados.