v1.0.0

Minecraft Plugins Documentation

Browse, install, and manage Minecraft server plugins from SpigotMC, CurseForge, Modrinth, Hangar, GeyserMC, and manual uploads directly in the Pelican Panel.

13
Endpoints
5
Handler
REST
Architecture
JSON
Format

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 -bak suffix)
  • Update Tracking — 24-hour cached update checks with console widget alerts
  • Auto-Replace — Old versions automatically removed on update (configurable)
  • JAR Metadata — Extracts plugin.yml from 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 plugins feature on your Egg
  • CurseForge API key (only for CurseForge — free at console.curseforge.com)
  • storage/ and bootstrap/cache/ writable (permissions 0755)

API Reference

Guides