[main/INFO]: Forge mod loading, version 47.2.0
[main/INFO]: MinecraftForge v47.2.0 Initialized

[main/INFO]: Loading Minecraft 1.20.1 with Fabric Loader 0.15.0
[main/INFO]: Loading 4 mods

---

Cómo descargar un mod en Modrinth

1. Ve a modrinth.com/mods
2. Usa los filtros :
   • Cargadores: Forge o Fabric
   • Versiones: Tu versión de Minecraft
   • Entorno: Servidor (para mods solo de servidor)
3. Haz clic en el mod
4. Pestaña Versions → Descarga el .jar

---

⚠️ API de Fabric (Obligatorio para Fabric)

Si estás utilizando Fabric, debes instalar obligatoriamente la API de Fabric:

1. Descarga la API de Fabric en curseforge.com/minecraft/mc-mods/fabric-api
2. Elige la versión que corresponda a tu Minecraft
3. Coloca el archivo en la carpeta mods/

🚨 ¡Sin la API de Fabric, la mayoría de los mods de Fabric no funcionarán!

---

📤 Paso 3: Agregar Mods al Servidor

Método 1: A través del Gestor de Archivos OuiPanel

1. En OuiPanel, ve a Gestor de archivos
2. Navega hasta la carpeta mods
   • Si la carpeta no existe, créala
3. Haz clic en Subir (o arrastra y suelta)
4. Selecciona tus archivos .jar
5. Espera a que termine la carga.

⚠️ Límite: 100 Mo por archivo. Para archivos más grandes, utiliza el SFTP.

---

Método 2: A través de SFTP (Archivos voluminosos)

Para mods o modpacks voluminosos (> 100 Mo), utiliza el SFTP:

1. En OuiPanel, ve a Configuración → Acceso SFTP
2. Toma nota de la información de conexión:
   • Host
   • Puerto
   • Nombre de usuario
   • Contraseña
3. Descarga FileZilla o WinSCP
4. Inicia sesión con tus credenciales
5. Navega hasta la carpeta mods/
6. Transfiere tus archivos .jar

---

Método 3: A través del Gestor de Mods (Premium)

Si tienes una oferta Premium, puedes utilizar el Gestor de Mods integrado:

1. En OuiPanel, ve a Gestor de Mods
2. Busca el mod deseado
3. Haz clic en Instalar

💡 Este método descarga automáticamente la versión correcta del mod.

---

Método 4: Importar desde una URL

1. En el Gestor de archivos, navega hasta mods/
2. Haz clic en Importar URL
3. Pega el enlace directo al archivo .jar del mod
4. Haz clic en Descargar

---

🔄 Paso 4: Reiniciar el Servidor

Después de agregar tus mods:

1. Ve a la Consola
2. Haz clic en Detener para apagar correctamente el servidor
3. Espera a que se detenga por completo
4. Haz clic en Iniciar

---

Verificar la carga de los mods

En la consola, deberías ver cómo se cargan tus mods:

Forge :

[main/INFO]: Found mod file create-1.20.1-0.5.1.jar
[main/INFO]: Found mod file jei-1.20.1-forge-15.2.0.jar
[main/INFO]: Forge mod loading complete, 12 mods loaded

Fabric :

[main/INFO]: Loading 8 mods:
    - fabricloader 0.15.0
    - fabric-api 0.92.0
    - lithium 0.12.0
    - sodium 0.5.8

---

🎮 Mods Populares Recomendados

🔧 Mods de Optimización (Servidor)

Mod	Cargador	Descripción
Lithium	Fabric	Optimiza las actuaciones generales
Starlight	Fabric/Forge	Optimiza el cálculo de la luz
FerriteCore	Fabric/Forge	Reduce el uso de RAM
Chunky	Fabric/Forge	Pre-generación de chunks
Spark	Fabric/Forge	Perfilador de actuaciones

---

🏗️ Mods de Contenido (Populares)

Mod	Cargador	Descripción
Create	Forge/Fabric	Máquinas y automatización steampunk
Biomes O'Plenty	Forge/Fabric	Nuevos biomas
Just Enough Items (JEI)	Forge	Visualizador de recetas
Applied Energistics 2	Forge/Fabric	Almacenamiento digital
Tinkers' Construct	Forge	Fabricación de herramientas personalizadas
Mekanism	Forge	Tecnología y energía
Ice and Fire	Forge	Dragones y criaturas míticas

---

🎨 Mods Solo para el Servidor

Estos mods solo necesitan ser instalados en el servidor:

Mod	Cargador	Descripción
LuckPerms	Fabric/Forge	Gestión de permisos
WorldEdit	Fabric/Forge	Edición de terreno
Chunky	Fabric/Forge	Pre-generación de mundo
Simple Voice Chat	Fabric/Forge	Chat de voz in-game
BlueMap	Fabric/Forge	Mapa web 3D

---

🎒 Pack de Mods Performance (Fabric)

Para un servidor optimizado, instala estos mods juntos:

mods/
├── fabric-api-0.92.0+1.20.1.jar     (Obligatorio)
├── lithium-mc1.20.1-0.11.2.jar      (Rendimiento general)
├── starlight-1.1.2+fabric.jar       (Luz)
├── ferritecore-6.0.0-fabric.jar     (RAM)
├── krypton-0.2.3.jar                (Red)
└── chunky-1.3.92.jar                (Pre-generación)

---

📁 Estructura del Directorio Mods

Así es como debería lucir tu directorio después de la instalación:

/
├── mods/
│   ├── fabric-api-0.92.0+1.20.1.jar
│   ├── lithium-mc1.20.1-0.11.2.jar
│   ├── create-1.20.1-0.5.1.jar
│   └── jei-1.20.1-forge-15.2.0.jar
├── config/                           (Configuraciones de los mods - auto-generadas)
├── world/
├── server.properties
└── forge-1.20.1-47.2.0.jar          (o fabric-server-launch.jar)

---

⚠️ Compatibilidad Cliente/Servidor

Tipos de mods

Tipo	Instalación	Ejemplos
Solo Servidor	Solo en el servidor	LuckPerms, Chunky, WorldEdit
Solo Cliente	Solo en el cliente	Optifine, Shaders, Minimaps
Ambos	Servidor y clientes	Create, JEI, Applied Energistics

🚨 Importante: ¡Si un mod debe ser instalado en el cliente, todos los jugadores deben tenerlo!

---

Verificar si un mod es necesario en el cliente

En CurseForge o Modrinth, verifica la indicación:

• Servidor = Solo servidor
• Cliente = Solo cliente
• Ambos / Servidor y Cliente = Ambos requeridos

---

🔧 Solución de Problemas

El servidor no se inicia

Error	Cause	Solution
java.lang.NoClassDefFoundError	Missing dependency	Install required mods (e.g. Fabric API)
Mod X requires Minecraft 1.20.1	Incompatible version	Download the correct mod version
Duplicate mod ID	Same mod duplicated	Remove the duplicate in mods/
OutOfMemoryError	Not enough RAM	Increase RAM or reduce mods

---

Error "Forge/Fabric mismatch"

Error: Mod X requires Forge, but Fabric is installed

Solution: You have installed a mod for the wrong loader. Download the correct version (Forge or Fabric).

---

Mod Conflict

If the server crashes after adding a mod:

1. Stop the server
2. Remove the last added mod from the mods/ folder
3. Restart the server
4. If it works, the mod was incompatible
5. Look for an alternative version or a similar mod

---

Identifying the Cause of a Crash

1. Go to the Console in OuiPanel
2. Look for lines containing ERROR or FATAL
3. Identify the mentioned mod
4. Possible solutions:
   • Update the mod
   • Check dependencies
   • Remove the incompatible mod

---

Known Incompatible Mods

Mod A	Mod B	Issue
Optifine	Sodium	Performing the same task (client)
Some mods	Mohist	Hybrid incompatibility
Old mods	New versions	Changed APIs

---

💡 Best Practices

Do ✅

Practice	Reason
Backup before adding mods	Ability to revert back
Test mods one by one	Identify issues easily
Check versions	Avoid incompatibilities
Read mod pages	Understand dependencies
Regularly update	Bug fixes and security

---

Avoid ❌

Practice	Risk
Installing too many mods at once	Difficult to debug
Mixing Forge and Fabric	Incompatible
Downloading from unofficial sites	Malware
Ignoring prerequisites	Crashes
Neglecting RAM	Slow server or crashes

---

📊 Recommended RAM

Number of mods	Minimum RAM	Recommended RAM
1-10 mods	2 GB	3-4 GB
10-30 mods	4 GB	6 GB
30-50 mods	6 GB	8 GB
50-100 mods	8 GB	10-12 GB
Large modpack	10 GB+	12-16 GB

---

📝 Summary

INSTALLING MODS ON OUIPANEL:

1. INSTALL THE MOD LOADER
   ├── OuiPanel → Version Manager
   ├── Choose Forge or Fabric
   ├── Select Minecraft version
   └── Click Install

2. DOWNLOAD MODS
   ├── CurseForge or Modrinth
   ├── Filter by version AND mod loader
   ├── Download .jar files
   └── ⚠️ Fabric API required for Fabric!

3. UPLOAD MODS
   ├── OuiPanel → File Manager
   ├── Navigate to /mods/
   ├── Upload the .jar files
   └── (or use SFTP for large files)

4. RESTART
   ├── Console → Stop
   ├── Wait for complete shutdown
   └── Start

COMPATIBILITY RULES:
├── Minecraft Version = Mod Version
├── Mod Loader = Mod Type (Forge ≠ Fabric)
├── Fabric API = Mandatory for Fabric
└── Client/Server = Check the requirements

QUICK TROUBLESHOOTING:
├── Crash on startup → Check versions
├── Mod not loading → Check dependencies
├── Conflict → Remove the last added mod
└── OutOfMemory → Increase RAM

---

📚 Useful Resources

Resource	URL
CurseForge	curseforge.com/minecraft/mc-mods
Modrinth	modrinth.com/mods
Forge	files.minecraftforge.net
Fabric	fabricmc.net
Fabric Wiki	fabricmc.net/wiki