The complete link structure of the MC-Craft API, explained simply: Items, Mobs, Capes, Heads,
Skins, Player, Server status, QR codes and Advancements – all through a single REST API.
Search across all categories. Can be combined with a category:
/items/{language}/{category}?q={query}.
https://api.mc-craft.com/items/en?q=diamond
GET/item/{language}/{id}
Exactly one item by its ID.
https://api.mc-craft.com/item/en/diamond
Don't know the ID? Search first with /items/en?q=diamond, then take the
"id" field from the response and put it after /item/en/.
Images, textures & sounds: fields like icon, texture[].file
and sounds[].file already contain full URLs (e.g. to
mc-craft.com/assets/img/...) and can be used directly by bots or websites.
Mobs
Works exactly like the items API: /mobs for lists, /mob (no s) for exactly one mob.
GET/mobs/{language}
All mobs in one language.
https://api.mc-craft.com/mobs/en
GET/mobs/{language}/{category}
Only mobs from one specific category.
https://api.mc-craft.com/mobs/en/hostile
bosshostilejockeysneutralpassiveplayerunused
GET/mobs/{language}?q={query}
Search across all categories, optionally combined with /mobs/{language}/{category}?q=....
https://api.mc-craft.com/mobs/en/hostile?q=zombie
GET/mob/{language}/{id}
Exactly one mob by its ID.
https://api.mc-craft.com/mob/en/zombie
For mobs too, icon, texture[].file and sounds[].file
return full, directly usable URLs.
Capes
Every known Minecraft cape (Mojang, con, physical, virtual, and more) with an image, description, and
category. Unlike Items/Mobs, there is no dedicated language path segment here – the
language is chosen via the lang= parameter, and there's no separate singular word.
70+ player-head items (MHF heads of creatures, blocks, and symbols) plus logo heads, including a
ready-to-use /give command right in the response. The head database has no language or
category paths, only search and single lookup.
Structure
Example
All heads
/heads
Search
/heads?q=zombie
A specific head
/heads/{id}
Don't know the ID? Search first (?q=...), then take the "id" field from the response and put it after /heads/.
Skins Database
MC-Craft's curated skin gallery (hand-made themed skins like Steampunk, not player uploads) – not to
be confused with a real player's actual skin via /player/{name}/skin further below.
Structure
Example
All skins
/skins
By language
/skins?lang=en
Search
/skins?q=steampunk&lang=en
A single skin
/skins/{id}?lang=en
Player
Public Mojang profile data for any Minecraft account (name, UUID) plus its current skin – look it up
by username or UUID, perfect for Discord bots or player profiles on your own website.
GET/player/{name-or-uuid}
Player data by name or UUID.
https://api.mc-craft.com/player/Notch
GET/player/{name}/skin
Returns the player's skin directly as an image (not JSON) – perfect for <img src="...">.
https://api.mc-craft.com/player/Notch/skin
Server
Live status for any Minecraft server – player count, MOTD, version, icon, and more – for both Java
and Bedrock servers. Great for showing your own server's status on a website or in a Discord bot.
GET/server/{java|bedrock}/{address}
Live status of a Minecraft server, for both editions. Replace (server) below with your
own server address.
https://api.mc-craft.com/server/java/(server)
https://api.mc-craft.com/server/bedrock/(server)
Address with a port? URL-encode the colon: example.com:25565 →
example.com%3A25565.
QR Code Generator
GET/qr?text={content}
Basic principle: text is the only required parameter, everything else is optional.
Parameters
Parameter
Values
Meaning
text
any text
QR code content (URL-encoded)
design
normal / frame
without image, or with a centered icon
size
~128–2048
image size in pixels
ec
LMQH
error correction, low → very high (H recommended with icons)
icon
see below
icon image, only with design=frame
iconScale
~0.12–0.24
icon size relative to the QR code
bg
hex color
background color
dark
hex color
QR module color
finderDark
hex color
color of the finder frames (corners)
finderCenter
hex color
color of the finder centers
Icon scheme (only with design=frame)
Scheme
Example
item:{item-id}
icon=item:diamond
mob:{mob-id}
icon=mob:zombie
mob:{mob-id}:body
icon=mob:zombie:body (full body instead of head)
heart:{filename}
icon=heart:full
dialog:{filename}
icon=dialog:{filename}
Hex colors need a URL-encoded #: #00ff99 → %2300ff99.
