Mods & Plugins

Mods und Plugins von CurseForge und Modrinth suchen und installieren.

Requires mods (Premium oder Addon) or Premium plan

Mods suchen

GET/servers/:id/mods

Mods/Plugins von CurseForge oder Modrinth suchen.

Query-Parameter

Name	Type	Required	Description
`provider`	string	No	curseforge oder modrinth (Standard: curseforge)
`type`	string	No	mods oder plugins (Standard: mods)
`search`	string	No	Suchbegriff
`gameVersion`	string	No	Spielversion filtern
`modLoader`	number	No	Mod-Loader ID (nur CurseForge)
`page`	number	No	Seite (Standard: 0)
`pageSize`	number	No	Einträge pro Seite, max 50 (Standard: 20)

curl "https://www.mado-hosting.com/api/v1/servers/srv_abc123/mods?provider=modrinth&type=plugins&search=essentials&pageSize=10" \
  -H "Authorization: Bearer rsk_your_key"

Mod installieren

POST/servers/:id/mods

Mod oder Plugin auf dem Server installieren.

Body-Parameter

Name	Type	Required	Description
`provider`	string	Yes	modrinth or curseforge
`modId`	string \| number	Yes	Mod-ID vom Provider
`fileId`	string \| number	Yes	Datei-ID des Releases
`type`	string	No	mods oder plugins (Standard: mods)

curl -X POST "https://www.mado-hosting.com/api/v1/servers/srv_abc123/mods" \
  -H "Authorization: Bearer rsk_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "modrinth",
    "modId": "abc123",
    "fileId": "ver_456",
    "type": "plugins"
  }'

Fehlercodes

HTTP	Code	Beschreibung
403	`ADDON_REQUIRED`	Mods-Addon oder Premium benötigt
403	`DISTRIBUTION_RESTRICTED`	Mod erlaubt keinen 3rd-Party Download
404	`NOT_FOUND`	Mod oder Datei nicht gefunden
500	`UPLOAD_FAILED`	Upload zum Server fehlgeschlagen