Skip to content

Minecraft Sources (Pelican panel plugin)

Adds a Plugin Manager page (Mod Manager on modded servers) to Minecraft servers on the Pelican panel, with two tabs:

  • Installed: every jar in plugins/ (or mods/), with where it comes from, its version, the newest release for this server, and Update and Delete buttons. A jar is recognised by what this page installed (a .minecraft-sources.json file in the folder), by its exact file on Modrinth (SHA-1) or CurseForge (fingerprint), or, as a guess shown as “(by name)”, by its plugin.yml name on Hangar or SpigotMC. Jars that are on no site (our own ShottyCore, for example) show as “Not on any site”. New jars are read by a background job; the tab refreshes itself until they are done.
  • Add: one search over Modrinth, Hangar, SpigotMC and CurseForge (whichever have something for this server), asked at the same time. A project on several sites shows once with all of them, and Install takes it from the first of Modrinth, Hangar, CurseForge, SpigotMC that has a download for this server. SpigotMC only serves free resources it hosts itself; CurseForge needs an API key and some authors there don’t allow downloads outside CurseForge.

The page shows on servers whose egg has the minecraft tag and a loader tag (paper, velocity, fabric, …), to users who may read the server’s files; installing needs file create, deleting file delete. Installs and updates take effect at the server’s next restart.

  • CurseForge API key: Admin > Plugins > Minecraft Sources > Settings (MINECRAFT_SOURCES_CURSEFORGE_KEY), a free key from https://console.curseforge.com.
  • MINECRAFT_SOURCES_CACHE_MINUTES (default 360): how long answers from the sites are kept.

php tests/SupportTest.php checks the fingerprint, version and jar helpers.