MineSkin Integration

SkinsRestorer uses MineSkin to convert custom PNG files into valid Minecraft skins.

MineSkin works without an API key. An API key provides higher limits and more features.

Why use a MineSkin API key?

Feature	Without API Key	With API Key
Request limit	Low	Higher (depends on plan)
Request speed	Slower	Faster
Secret skins	No	Yes
Priority queue	No	Yes

Getting an API key

Open mineskin.org/apikey.
Create an account or sign in.
Select a plan.
Create an API key.

Code SKINSRESTORER10 gives you 10% off the first three months of plans above Lite. SkinsRestorer does not receive a commission.

Configuring your API key

Add your API key to config.yml:

api:
  mineSkinApiKey: "your-api-key-here"

Then reload SkinsRestorer:

/sr reload

Secret skins

If mineSkinSecretSkins is enabled, MineSkin does not show generated skins in its public gallery.

api:
  mineSkinApiKey: "your-api-key-here"
  mineSkinSecretSkins: true

Use this option for:

Custom server skins that must stay private
Event-specific skins
Private branding

Rate limits and batching

SkinsRestorer can group Mojang API requests. This reduces rate-limit errors.

api:
  mojangBatchWindowSeconds: 1

The value sets the request window in seconds. The default value of one second works for most servers.

For a server with heavy traffic:

Increase the request window to two or three seconds.
Use a MineSkin plan with higher limits.
Monitor the MineSkin usage dashboard.

What MineSkin does

MineSkin applies your PNG to an account in its Minecraft account pool. Mojang then creates signed skin data for SkinsRestorer.

MineSkin creates only skin textures. It cannot create capes because Mojang assigns capes to specific accounts. Read Cape Support for more information.

Troubleshooting

`Rate limited`

The API key can be above its request limit.
Wait a few minutes, then try again.
For higher limits, select a different MineSkin plan.

`Invalid API key`

Make sure that you copied the complete key.
Make sure that the key did not expire.
Create a new key on the MineSkin website.

Slow skin generation

Read the queue status on the MineSkin dashboard.
Plans with higher limits get priority.
High server load can make generation slower.

MineSkin plans comparison

Plan	Best for
Free (no key)	Testing, very low volume
Lite	Small servers, basic features
Standard	Medium servers, higher limits
Pro	Large networks, high volume

Visit mineskin.org/apikey for current pricing and features.

MineSkin Integration

On this page