MineSkin Integration
Learn how to configure MineSkin API integration for faster skin uploads.
SkinsRestorer uses MineSkin to convert custom PNG files into valid Minecraft skins. While MineSkin works without an API key, getting one provides significant benefits.
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
- Visit mineskin.org/apikey
- Create an account or sign in
- Choose a plan that fits your needs
- Generate your API key
Use coupon code SKINSRESTORER10 for 10% off your first three months (valid on plans except Lite). We don't receive a commission—it's just a community perk.
Configuring your API key
Add your API key to config.yml:
api:
mineSkinApiKey: "your-api-key-here"Then reload the plugin:
/sr reloadSecret skins
When mineSkinSecretSkins is enabled, skins you generate won't appear in MineSkin's public gallery.
api:
mineSkinApiKey: "your-api-key-here"
mineSkinSecretSkins: trueThis is useful for:
- Custom server skins you don't want shared
- Event-specific skins
- Private branding
Rate limits and batching
SkinsRestorer includes built-in rate limit handling:
api:
mojangBatchWindowSeconds: 1This batches Mojang API requests within a time window to avoid hitting rate limits. The default of 1 second works well for most servers.
For high-traffic servers:
- Increase the batch window to 2-3 seconds
- Consider a higher-tier MineSkin plan
- Monitor your MineSkin usage dashboard
What MineSkin does
MineSkin provides a pool of Minecraft accounts that apply your custom skin PNG to generate valid, Mojang-signed skin data. This allows SkinsRestorer to use any PNG image as a skin.
MineSkin only generates skin textures. It cannot generate capes, as capes require specific Mojang account verification and cannot be created arbitrarily. See the Cape Support page for details.
Troubleshooting
"Rate limited" errors
- Your API key may have exceeded its limit
- Wait a few minutes and try again
- Consider upgrading your MineSkin plan
"Invalid API key" errors
- Verify the key is copied correctly
- Check that the key hasn't expired
- Regenerate the key on MineSkin's website
Slow skin generation
- Check your MineSkin dashboard for queue status
- Higher-tier plans get priority
- Server load affects generation speed
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.
How is this guide?
Last updated on