[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

---

How to Download a Mod on Modrinth

1. Go to modrinth.com/mods
2. Use the filters:
   • Loaders: Forge or Fabric
   • Versions: Your Minecraft version
   • Environment: Server (for server mods only)
3. Click on the mod
4. Tab Versions → Download the .jar

---

⚠️ Fabric API (Required for Fabric)

If you are using Fabric, you must install Fabric API :

1. Download Fabric API from curseforge.com/minecraft/mc-mods/fabric-api
2. Choose the version corresponding to your Minecraft
3. Place the file in the mods/ folder

🚨 Without Fabric API, most Fabric mods will not work!

---

📤 Step 3: Adding Mods to the Server

Method 1: Using OuiPanel File Manager

1. In OuiPanel, go to File Manager
2. Navigate to the mods folder
   • If the folder does not exist, create it
3. Click on Upload (or drag and drop)
4. Select your .jar files
5. Wait for the upload to complete.

⚠️ Limit: 100 MB per file. For larger files, use SFTP.

---

Method 2: Using SFTP (Large Files)

For large mods or modpacks (> 100 MB), use SFTP:

1. In OuiPanel, go to Configuration → SFTP Access
2. Take note of the connection information:
   • Host
   • Port
   • Username
   • Password
3. Download FileZilla or WinSCP
4. Connect using your credentials
5. Navigate to the mods/ folder
6. Transfer your .jar files

---

Method 3: Using Mods Manager (Premium)

If you have a Premium offer, you can use the built-in Mods Manager:

1. In OuiPanel, go to Mods Manager
2. Search for the desired mod
3. Click on Install

💡 This method automatically downloads the correct version of the mod.

---

Method 4: Import from URL

1. In the File Manager, navigate to mods/
2. Click on Import URL
3. Paste the direct link to the mod's .jar file
4. Click Download

---

🔄 Step 4: Restart the Server

After adding your mods:

1. Go to the Console
2. Click on Stop to properly stop the server
3. Wait for the complete shutdown
4. Click on Start

---

Check Mod Loading

In the console, you should see your mods loading:

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

---

🎮 Recommended Popular Mods

🔧 Optimization Mods (Server)

Mod	Loader	Description
Lithium	Fabric	Optimizes general performance
Starlight	Fabric/Forge	Optimizes light calculation
FerriteCore	Fabric/Forge	Reduces RAM usage
Chunky	Fabric/Forge	Chunk pre-generation
Spark	Fabric/Forge	Performance profiler

---

🏗️ Content Mods (Popular)

Mod	Loader	Description
Create	Forge/Fabric	Steampunk machines and automation
Biomes O'Plenty	Forge/Fabric	New biomes
Just Enough Items (JEI)	Forge	Recipe visualizer
Applied Energistics 2	Forge/Fabric	Digital storage
Tinkers' Construct	Forge	Custom tool crafting
Mekanism	Forge	Technology and energy
Ice and Fire	Forge	Dragons and mythical creatures

---

🎨 Server-Side Only Mods

These mods only need to be installed on the server:

Mod	Loader	Description
LuckPerms	Fabric/Forge	Permission management
WorldEdit	Fabric/Forge	Terrain editing
Chunky	Fabric/Forge	World pre-generation
Simple Voice Chat	Fabric/Forge	In-game voice chat
BlueMap	Fabric/Forge	3D web map

---

🎒 Performance Mods Pack (Fabric)

For an optimized server, install these mods together:

mods/
├── fabric-api-0.92.0+1.20.1.jar     (Required)
├── lithium-mc1.20.1-0.11.2.jar      (General performance)
├── starlight-1.1.2+fabric.jar       (Light)
├── ferritecore-6.0.0-fabric.jar     (RAM)
├── krypton-0.2.3.jar                (Network)
└── chunky-1.3.92.jar                (Pre-generation)

---

📁 Mods Folder Structure

Here is how your folder should look after installation:

/
├── 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/                           (Mods configurations - auto-generated)
├── world/
├── server.properties
└── forge-1.20.1-47.2.0.jar          (or fabric-server-launch.jar)

---

⚠️ Client/Server Compatibility

Types of Mods

Type	Installation	Examples
Server Only	Server only	LuckPerms, Chunky, WorldEdit
Client Only	Client only	Optifine, Shaders, Minimaps
Both	Server AND clients	Create, JEI, Applied Energistics

🚨 Important: If a mod needs to be installed on the client side, all players must have it!

---

Checking if a Mod Requires Client-Side

On CurseForge or Modrinth, check for the indication:

• Server = Server only
• Client = Client only
• Both / Server & Client = Both required

---

🔧 Troubleshooting

The server won't start

Error	Cause	Solution
java.lang.NoClassDefFoundError	Missing dependency	Install the 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 conflicts

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

---

Finding 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's ✅

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

---

Don'ts ❌

Practice	Risk
Install too many mods at once	Difficult to debug
Mix Forge and Fabric	Incompatible
Download from unofficial sites	Malware risks
Ignore prerequisites	Crashes
Neglect 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 .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 requirements

QUICK TROUBLESHOOTING:
├── Crash on startup → Check versions
├── Mod not loading → Check dependencies
├── Conflict → Remove 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