SkinAPI Documentation

CreeperNation SkinAPI supports GeyserMC Bedrock skins. This API provides the ability to redirect to either Java or Bedrock, depending on your needs.


Basic Usage

The CreeperNation API has 5 main parts of any endpoint.


Type

Type of avatar to redirect, Possible options are avatar, head, body, player, raw, and combo. Default is avatar. You can see how they look here /skin/:identifier?type=<type> or like this: /<type>/:identifier

Identifier

The key of the player, this can be a UUID (the API will detect floodgate ones) or a username.

Size

The size of the image to redirect, default is 150, you can add it to any endpoint using query parameter size (?size=<size> at the end of the url).

Direction

Flips the body and head, default is right, you can add it to any endpoint using query parameter direction (?direction=<left/right> at the end of the url).

Download

Downloads the skin (when loaded in a browser), only works when you use the raw type, and you can add it to your query parameters: ?download=true.

Prefix

This is your floodgate prefix (. by default), if you want to use usernames the api will detect floodgate players if they begin with the prefix, you can add it using ?prefix=<prefix> or if you use other query parameters &prefix=<prefix>.

Bedrock

Only do this when the player's name is 100% a Bedrock username and the player has joined an GeyserMC instance before, you can add this using /bedrock right after the identifier. This will make the API ignore everything and assume this is a bedrock player.


Player Skin Head
Avatar
Player 3d skin Head
Head
Player skin 3D Body
Body
player skin body
Player
player skin combo
Combo
player skin raw
Raw

Plugin Configuration

Don't forget you can replace the text in red with any <TYPE>

DiscordSRV

In your config.yml, scroll down to AvatarUrl, set it to this:

AvatarUrl: https://api.creepernation.net/avatar/{uuid}

DiscordSRVUtils

There are multiple message files containing avatar URLs. At the time of writing this, they are:
level.json, afk.json, no-longer-afk.json


Level.json

replace the avatar url (in thumbnail url)

https://api.creepernation.net/avatar/[stats.uuid]


Afk.json

replace the avatar url (in author icon url)

https://api.creepernation.net/avatar/[player.uniqueId]


No-Longer-Afk.json

replace the avatar url (in author icon url)

https://api.creepernation.net/avatar/[player.uniqueId]

UltraStaffChatPro

In Messages.yml/Config.yml, there are multiple crafatar links replace each one with:

https://api.creepernation.net/avatar/{uuid}

Pl3xMap

In your config.yml, scroll down to heads-url, and set it to this:

heads-url: https://api.creepernation.net/head/{uuid}

Dynmap

In your configuration.txt, scroll down to skin-url, and set it to this:

skin-url: https://api.creepernation.net/raw/{uuid}

BlueMapFloodgate

In your config.yml, scroll down to customAPI, and set it to this:

customAPI: https://api.creepernation.net/raw/{UUID}


Rory Pics

RORY