Plugins

The search endpoint forwards your query to https://api.modrinth.com/v2/search with a loader facet pre-applied. Allowed loaders: paper, spigot, bukkit, purpur, fabric, forge.

GET /api/plugins/search?q=essentials&loader=paper

Modrinth projects publish many versions per Minecraft release. Use GET /api/plugins/:projectId/versions?loader=paper to list them, and pass the chosen version_id to install.

POST /api/servers/:id/plugins/install
{ "versionId": "abc123def" }

The server fetches the version metadata, picks the primary .jar file, and streams it into <dataPath>/plugins/<filename>.jar. The server is not restarted automatically; the response includes a hint to do so.

Files larger than 100 MB are rejected. Paper plugins are typically well under 1 MB; the cap mostly catches mod packs masquerading as plugins.

This is not a plugin manager. There is no dependency resolution, no version pinning, no upgrade path. If a plugin needs another plugin, install both. If a plugin breaks on a JVM restart, you are still on the hook for diagnosing why. The aim is to make the boring case (search, click, install) one click instead of an SSH session.