Installing Plugins & Mods

Customizing your server with plugins or mods allows you to change gameplay, add new items, or protect your builds. This guide covers installation for both.

Installing Plugins (Paper/Purpur)

Plugins run entirely on the server. Players do not need to install anything on their end.

Step 1: Download the Plugin

Download the .jar file from a reputable source like SpigotMC or Modrinth. Ensure the plugin version matches your server version.

Step 2: Upload to Server

1. Go to the Files tab in your panel.
2. Open the plugins folder.
3. Click Upload and select your downloaded .jar file.

Step 3: Restart

Restart your server to load the new plugin. Check the console for a startup message confirming it loaded successfully.

Installing Mods (Forge/Fabric)

Mods change the game code and usually render new blocks or items. Players must install the exact same mods on their computer to join.

Step 1: Download Mods

Get mods from CurseForge or Modrinth.

Crucial Check: The mod must match your specific Mod Loader (Forge vs Fabric) and Minecraft Version (e.g., 1.20.1).

Step 2: Upload to Server

1. Go to the Files tab.
2. Open the mods folder (created automatically after you start a Forge/Fabric server once).
3. Upload the mod .jar files here.

Step 3: Client Installation

Remember to send the mod files to your players. They need to install the same Forge/Fabric loader and put the mods in their local %appdata%/.minecraft/mods folder.

Common Issues

• Server Crashing? Usually caused by mismatched versions or missing dependencies (e.g., a mod needs a library mod to work). Check the Console for error logs.
• Plugins not showing? Ensure you put them in the plugins folder, not the root directory.
• "Mismatched Mod Channel List": This error means the player has different mods than the server.

Recommended Essentials

• Plugins: EssentialsX (Core commands), Gryphon (Anti-cheat), WorldEdit (Building).
• Fabric Mods: Lithium (Performance), Ledger (Logging).