MCSKINGEN

Mit der öffentlichen Bibliothek entwickeln

Lies Original-Skins, Blocktexturen und Baupläne über eine versionierte API mit klar ausgewiesenen Quellen, Lizenzen und widerrufbaren Schlüsseln.

Freigegebene Werke mit Quellenangabe

Durchsuche Skins, Texturpakete und Baupläne, lies Lizenz- und Namensnennungshinweise und lade anschließend genau die generierten Dateien herunter. Private Projekte, Rohbilder, Prompts und Jobs sind nicht Teil dieser API.

OpenAPI-3.1-Vertrag herunterladen

API v1 · Vertrag 1.1.0 · Bereich library:read

Vorhersehbare Anfragekontingente

Jeder Schlüssel erlaubt 60 Anfragen pro Minute und 5000 pro UTC-Tag. Diese Anfragen verbrauchen keine Generierungsguthaben. Lies das verbleibende Kontingent in den Antwort-Headern ab; beachte Retry-After bei 429.

Nutze ETag und If-None-Match für das Caching. Bei der erneuten Prüfung werden der Schlüssel und der aktuelle Veröffentlichungsstatus überprüft, bevor 304 zurückgegeben wird. Zurückgezogene Inhalte geben 404 zurück; widerrufene oder abgelaufene Schlüssel geben 401 zurück.

Schreibgeschützten Schlüssel erstellen

Melde dich mit deinem Website-Konto an, um Integrationsschlüssel zu erstellen, einzusehen und zu widerrufen.

Abfragen, prüfen, herunterladen

Bewahre deinen Schlüssel in einer vertrauenswürdigen Serverkonfigurationsdatei auf. Sende ihn in einem Authorization-Header. Übernimm sourceUrl, Autor, Lizenz und übernommene Namensnennungen, wenn du ein Werk anzeigst oder weiterverbreitest. Nichtkommerzielle Lizenzen bleiben nichtkommerziell.

# 1. Freigegebene Skins suchen
curl 'https://mcskingen.com/api/v1/library/skins?limit=2&model=classic' \
  -H 'Authorization: Bearer YOUR_READ_ONLY_KEY'

# 2. Eine Veröffentlichung anhand ihrer zurückgegebenen ID lesen
curl 'https://mcskingen.com/api/v1/library/skins/PUBLICATION_ID' \
  -H 'Authorization: Bearer YOUR_READ_ONLY_KEY'

# 3. Eine der zurückgegebenen Ressourcen herunterladen
curl 'https://mcskingen.com/api/v1/assets/ASSET_ID' \
  -H 'Authorization: Bearer YOUR_READ_ONLY_KEY' \
  --output original-skin.png

Für Gebäudestrukturen verwende /library/buildings?category=houses. Voxel-JSON und Material-CSV sind von Spieldateien getrennt, die erst nach bestandenen Freigabeprüfungen angezeigt werden.

Für Block-Ressourcenpakete verwende /library/textures und die zurückgegebenen Download-URLs. Jede Datei behält ihre Zielspielversion bei; Dateiüberprüfungen bestätigen nicht den Import in den Spielclient.

Für eine weitere Seite sende den zurückgegebenen nextCursor als cursor mit unveränderten Filtern und limit. Ein null-Cursor kennzeichnet das Ende. Die Suche unterstützt literalen Text, Lizenzen und das Armmodell von Skins; unbekannte oder wiederholte Parameter geben 400 zurück.

Zugriffsgrenzen

MCP-Verbindung & Autorisierung →

Diese Version ermöglicht ausschließlich Lesezugriffe auf freigegebene öffentliche Bibliotheksinhalte. API-Schlüssel können keine Jobs erstellen, Angebote abrufen, ein Guthaben einsehen, Referenzen hochladen, Schlüssel verwalten oder Guthaben kaufen. Website-Sitzungen verwalten Schlüssel separat. MCP-Tools verwenden eine separate OAuth-Autorisierung über die Website.