Minecraft Plugins Documentation
Browse, install, and manage Minecraft server plugins from SpigotMC, CurseForge, Modrinth, Hangar, GeyserMC, and manual uploads directly in the Pelican Panel.
About Minecraft Plugins
Minecraft Plugins is a Pelican Panel plugin by Eranio that allows server administrators to browse, install, update, and manage Minecraft server plugins directly from the panel — supporting 5 providers plus manual uploads, with automatic version detection, dependency resolution, update tracking, and JAR metadata extraction.
Supported Providers
| Provider | Search | Direct Download | Dependencies | Version Filter | API Key Required |
|---|---|---|---|---|---|
| SpigotMC | Full-text | Checked (HEAD request) | No | Yes | No |
| CurseForge | Full-text | Yes (usually) | Yes (recursive) | Yes | Yes (free) |
| Modrinth | Full-text | Yes | Yes | Yes | No |
| PaperMC/Hangar | Full-text | Yes | Yes | No (version-agnostic) | No |
| GeyserMC | 6 projects | Yes (special) | No | No (version-agnostic) | No |
| Manual Upload | — | Via SFTP/File Manager | — | — | — |
Key Features
- 5 Provider Support — SpigotMC (Spiget API), CurseForge, Modrinth, PaperMC/Hangar, GeyserMC
- Manual Upload Detection — Auto-detects plugins uploaded via SFTP and registers them
- Automatic MC Version Detection — 11 detection methods (same as Game Mods plugin)
- One-Click Installation — Select version, click install, done
- Dependency Resolution — CurseForge (recursive) and Modrinth (required dependencies)
- Enable/Disable — Toggle plugins without deleting (rename with
-baksuffix) - Update Tracking — 24-hour cached update checks with console widget alerts
- Auto-Replace — Old versions automatically removed on update (configurable)
- JAR Metadata — Extracts
plugin.ymlfrom JARs for display names - ZIP Export — Download all installed plugins as a JWT-signed ZIP (30 min expiry)
- Version-Agnostic Providers — GeyserMC and PaperMC/Hangar don't filter by MC version
- Search Retry — If search with version filter fails, automatically retries without version filter
Data Storage
| Data | Location |
|---|---|
| Installed plugins | minecraft_installed_plugins database table |
| Plugin files | /plugins/ directory on server |
| Cache | File-based with MP_ prefix |
Requirements
- Pelican Panel 1.0.0 or newer
- PHP 8.1, 8.2, or 8.3
- The
pluginsfeature on your Egg - CurseForge API key (only for CurseForge — free at console.curseforge.com)
storage/andbootstrap/cache/writable (permissions0755)
API Reference
SpigotMC / Spiget API
https://api.spiget.org/v2
Spiget REST API for SpigotMC resources — search, details, versions, and download checks.
CurseForge API
https://api.curseforge.com/v1
CurseForge Bukkit Plugins API (classId=5) — search, file listing, and download.
Modrinth API
https://api.modrinth.com/v2
Modrinth plugin search with server-side facets (paper, spigot, bukkit).
PaperMC / Hangar API
https://hangar.papermc.io/api/v1
Hangar plugin repository — search projects and list platform-specific versions.
GeyserMC API
https://download.geysermc.org/v2
GeyserMC download API — 6 projects with platform-specific builds.
Guides
Installation & Setup
# Installation & Setup Complete step-by-step guide to installing the Minecraf...
Configuration
# Configuration Complete reference for all settings, environment variables, c...
Plugin Browser
# Plugin Browser Complete guide to the Plugin Browser — searching, browsing,...
Managing Plugins
# Managing Plugins Complete guide to the Installed tab — viewing, filtering,...