Knowledgebase

If your server mods or plugins aren’t working, show errors, or just do nothing, you’re not alone. ⚠️ This guide will help you identify common causes and get everything running smoothly again. ✔️

⛏️ Step 1: Check the Minecraft Version

Most mods and plugins only work with the version they were made for. If the versions don’t match, they may not load at all.

• ➡️ Go to Configuration > Advanced in the panel
• ✔️ Make sure your server version (e.g. 1.20.1) matches the version the mod/plugin supports

⛏️ Step 2: Confirm You’re Using the Right Server Type

Mods and plugins require different server types:

• ✔️ Mods → Need Forge or Fabric
• ✔️ Plugins → Need Spigot or Paper
• ❌ Vanilla servers do not support either

➡️ Check your server type under Configuration > Advanced

⏰ Step 3: Check Console or Logs for Errors

Open the Console tab or view the latest.log file in the logs folder. Look for:

• ❌ Missing mod or mod not found
• ❌ Unsupported API version
• ❌ Invalid plugin.yml

✔️ These messages will help you pinpoint what went wrong.

⚔️ Step 4: Make Sure Dependencies Are Installed

Many plugins and mods require additional libraries or frameworks. Examples:

• ✔️ LuckPerms may need Vault
• ✔️ Some Forge mods require GeckoLib or Cloth Config
• ✔️ PlaceholderAPI is often needed for plugin placeholders

➡️ Check the plugin/mod page for dependency requirements.

⛏️ Step 5: Check File Location

Double-check that your mods or plugins are placed in the correct folder:

• ✔️ mods folder for Forge/Fabric mods
• ✔️ plugins folder for Spigot/Paper plugins

❌ Putting a plugin in the mods folder, or vice versa, will not work.

➕ Step 6: Try One at a Time

If your server crashes or fails to load mods/plugins properly, try removing everything and testing them one by one. This helps isolate the issue.

✔️ Start with just one mod or plugin, then add more gradually.

✅ Still Not Working?

If you're still stuck:

• ➡️ Double-check the download source — use official sites like CurseForge or SpigotMC
• ➡️ Make sure you didn’t unzip the file — most mods/plugins should be .jar
• ➡️ Contact support and share any relevant error messages from your logs

We’re here to help if you need assistance. ✅