AniMc API

Minecraft renders for bots, apps, and command integrations.

Use AniMc as a public image backend for Discord bots, websites, dashboards, slash commands, and automations. Username renders work over simple GET URLs, and upload renders work through a single POST endpoint with public CORS.

Public CORS

Mascot GIF Only

Quick Start https://animc.d4vrock.xyz/api/render/devrock14.png?style=mascot&frame=pixel

GET

PNG Render

/api/render/[username].png

Classic or mascot still renders with gradients, transparent export, frames, ornaments, capes, items, and pose controls.

GET

Mascot GIF

/api/render/[username].gif

Animated GIF output is mascot-only. Classic GIF is intentionally blocked so the API stays clean.

POST

Upload Render

/api/render

Send JSON or multipart form data with a username, a skin upload, and an optional background image.

GET

Legacy PNG

/api/pfp/[username].png

Backwards-compatible classic endpoint for older integrations.

Important

GIF output is mascot-only now. If you call /api/render/[username].gif?style=classic, the API returns a `400` so classic renders stay clean as PNGs instead of fake animated loops.

Parameters

Core

style `classic` | `mascot`

format POST only: `png` | `gif`

animation `none` | `idle`

size `64` to `1024`

hat `true` | `false`

Background

background `gradient` | `transparent` | `image`

gradient `84fab0-8fd3f4` style hex chain

backgroundImage POST data URL or uploaded file

image POST alias for `backgroundImage`

Style Extras

frame `none` | `pixel` | `glass` | `studio`

ornament `none` | `sparkles` | `halo` | `crown`

cape `none` | `classic` | `royal`

item `none` | `sword` | `wand` | `pickaxe`

itemX / itemY `-5` to `5` accessory position trim

ornamentX / ornamentY `-5` to `5` ornament position trim

Pose

scale `0.75` to `1.4`

rotate `-20` to `20`

x `-4` to `4`

y `-4` to `4`

Roadmap Status

Ornaments Live

Frames Live

Core Generator: Java & Upload support Live

Customization: Backgrounds, Gradients, Images Live

Mobile Support Live

3D Adjustments: rotate and position Partial

Layers: helmet / hat toggle Live

Cosmetics: capes or items Live

Examples

Classic transparent PNG https://animc.d4vrock.xyz/api/render/devrock14.png?style=classic&background=transparent&hat=false&size=512 Mascot styled PNG

https://animc.d4vrock.xyz/api/render/devrock14.png?style=mascot&gradient=ffb88c-de6262&frame=pixel&ornament=sparkles&cape=royal

Mascot GIF with cosmetics https://animc.d4vrock.xyz/api/render/devrock14.gif?style=mascot&animation=idle&size=512&frame=glass&item=sword

Discord Bot Example

const url = `https://animc.d4vrock.xyz/api/render/${ign}.gif?style=mascot&animation=idle&frame=glass`;
const response = await fetch(url);
const bytes = Buffer.from(await response.arrayBuffer());

const file = new AttachmentBuilder(bytes, {
  name: `${ign}.gif`
});

Upload Example

const form = new FormData();
form.append("format", "png");
form.append("style", "mascot");
form.append("background", "image");
form.append("frame", "studio");
form.append("ornament", "halo");
form.append("skin", skinFile);
form.append("backgroundImage", backgroundFile);

const response = await fetch("https://animc.d4vrock.xyz/api/render", {
  method: "POST",
  body: form
});