Der komplette Link-Aufbau der MC-Craft API, einfach erklärt: Items, Mobs, Capes, Heads,
Skins, Player, Server-Status, QR-Codes und Advancements – alles über eine einzige REST-API.
Suche über alle Kategorien hinweg. Kann mit einer Kategorie kombiniert werden:
/items/{sprache}/{kategorie}?q={suchwort}.
https://api.mc-craft.com/items/de?q=diamant
GET/item/{sprache}/{id}
Genau ein Item über seine ID.
https://api.mc-craft.com/item/de/diamond
ID unbekannt? Erst mit /items/de?q=diamant suchen, dann das Feld
"id" aus der Antwort hinter /item/de/ setzen.
Bilder, Texturen & Sounds: Felder wie icon, texture[].file
und sounds[].file enthalten bereits vollständige URLs (z. B. zu
mc-craft.com/assets/img/...) und können direkt von Bots oder Webseiten verwendet werden.
Mobs
Funktioniert genauso wie die Items-API: /mobs für Listen, /mob (ohne s) für genau einen Mob.
GET/mobs/{sprache}
Alle Mobs einer Sprache.
https://api.mc-craft.com/mobs/de
GET/mobs/{sprache}/{kategorie}
Nur Mobs einer bestimmten Kategorie.
https://api.mc-craft.com/mobs/de/hostile
bosshostilejockeysneutralpassiveplayerunused
GET/mobs/{sprache}?q={suchwort}
Suche über alle Kategorien, optional kombinierbar mit /mobs/{sprache}/{kategorie}?q=....
https://api.mc-craft.com/mobs/de/hostile?q=zombie
GET/mob/{sprache}/{id}
Genau ein Mob über seine ID.
https://api.mc-craft.com/mob/de/zombie
Auch bei Mobs liefern icon, texture[].file und sounds[].file
vollständige, direkt nutzbare URLs.
Capes
Alle bekannten Minecraft-Capes (Mojang, Cons, physische, virtuelle u. v. m.) mit Bild, Beschreibung
und Kategorie. Anders als bei Items/Mobs gibt es hier kein eigenes Sprach-Pfadsegment –
die Sprache wird über den Parameter lang= gewählt, und es gibt kein separates Singular-Wort.
Über 70 spielbare Spielerköpfe (MHF-Köpfe von Kreaturen, Blöcken und Symbolen) sowie Logo-Köpfe, inklusive
fertigem /give-Befehl in der Antwort. Die Head-Datenbank hat keine Sprach- oder Kategorie-Pfade,
nur Suche und Einzelabruf.
Aufbau
Beispiel
Alle Heads
/heads
Suchen
/heads?q=zombie
Ein bestimmter Head
/heads/{id}
ID unbekannt? Erst suchen (?q=...), dann das Feld "id" aus der Antwort hinter /heads/ setzen.
Skins-Datenbank
Die kuratierte Skin-Galerie von MC-Craft (handgemachte Themen-Skins wie Steampunk, nicht Spieler-Uploads) –
nicht zu verwechseln mit dem echten Spieler-Skin über /player/{name}/skin weiter unten.
Aufbau
Beispiel
Alle Skins
/skins
Nach Sprache
/skins?lang=de
Suchen
/skins?q=steampunk&lang=de
Ein einzelner Skin
/skins/{id}?lang=de
Player
Öffentliche Mojang-Profildaten zu jedem Minecraft-Account (Name, UUID) sowie dessen aktueller Skin –
per Spielername oder UUID abrufbar, ideal für Discord-Bots oder Spielerprofile auf deiner Webseite.
GET/player/{name-oder-uuid}
Spielerdaten über Namen oder UUID.
https://api.mc-craft.com/player/Notch
GET/player/{name}/skin
Liefert den Skin des Spielers direkt als Bild (nicht als JSON) – ideal für <img src="...">.
https://api.mc-craft.com/player/Notch/skin
Server
Live-Status eines beliebigen Minecraft-Servers – Spieleranzahl, MOTD, Version, Icon und mehr – für
sowohl Java- als auch Bedrock-Server. Ideal, um den Status eines eigenen Servers auf einer Webseite
oder in einem Discord-Bot anzuzeigen.
GET/server/{java|bedrock}/{adresse}
Live-Status eines Minecraft-Servers, für beide Editionen. Ersetze (server) unten durch die
eigene Server-Adresse.
https://api.mc-craft.com/server/java/(server)
https://api.mc-craft.com/server/bedrock/(server)
Adresse mit Port? Doppelpunkt URL-kodieren: example.com:25565 →
example.com%3A25565.
QR-Code-Generator
GET/qr?text={inhalt}
Grundprinzip: text ist der einzige Pflicht-Parameter, alles andere ist optional.
Parameter
Parameter
Werte
Bedeutung
text
beliebiger Text
Inhalt des QR-Codes (URL-kodiert)
design
normal / frame
ohne Bild bzw. mit Icon in der Mitte
size
~128–2048
Bildgröße in Pixel
ec
LMQH
Fehlerkorrektur, niedrig → sehr hoch (H bei Icons empfohlen)
icon
siehe unten
Icon-Bild, nur mit design=frame
iconScale
~0.12–0.24
Größe des Icons relativ zum QR-Code
bg
Hex-Farbe
Hintergrundfarbe
dark
Hex-Farbe
QR-Modulfarbe
finderDark
Hex-Farbe
Farbe der Finder-Rahmen (Ecken)
finderCenter
Hex-Farbe
Farbe der Finder-Mitte
Icon-Schema (nur mit design=frame)
Schema
Beispiel
item:{item-id}
icon=item:diamond
mob:{mob-id}
icon=mob:zombie
mob:{mob-id}:body
icon=mob:zombie:body (ganzer Körper statt Kopf)
heart:{dateiname}
icon=heart:full
dialog:{dateiname}
icon=dialog:{dateiname}
Hex-Farben brauchen ein URL-kodiertes #: #00ff99 → %2300ff99.
