Plugin Setup Guide
How to install and configure plugins on your Minecraft server.
1. Choose the Right Server Software
Most plugins require Spigot or Paper. Paper is recommended for best performance and widest plugin compatibility. Bukkit plugins generally work on Spigot and Paper. Velocity plugins only work on Velocity proxy servers.
2. Download the Plugin JAR
Download plugins only from trusted sources: SpigotMC.org, Modrinth, Hangar (PaperMC), the plugin's official GitHub repository, or Bukkit.org. Never download plugins from unverified sites as they may contain malware.
3. Upload to the Plugins Folder
Place the downloaded .jar file into your server's /plugins/ directory. If you are using a hosting panel, use the file manager or SFTP to upload. Do not extract the JAR file.
4. Restart the Server
Restart your server completely (stop then start). While some plugins support /reload, a full restart is recommended for initial installation to avoid issues.
5. Configure the Plugin
After the first run, the plugin creates a configuration folder inside /plugins/PluginName/. Edit config.yml and other files to customize behavior. Check the plugin's documentation for available options.
6. Set Permissions
Use a permissions plugin like LuckPerms to control who can use each command. Most plugins list their permission nodes in their documentation. Grant permissions to groups rather than individual players.
7. Check for Dependencies
Some plugins require other plugins to function. Common dependencies include Vault (for economy), ProtocolLib (for packet manipulation) and PlaceholderAPI (for placeholders). Install all dependencies before the plugin that needs them.
Tips
- Always back up your server before installing new plugins.
- Test new plugins on a development server first.
- Keep plugins updated to their latest versions for security and bug fixes.
- Remove unused plugins to reduce memory usage and potential conflicts.
- Check server console logs for errors after installing a plugin.
- Read the plugin's documentation page before asking for support.
- Use /timings or spark to identify plugins causing lag.