Hytale Wrapper API
A simple, developer-friendly wrapper to fetch Hytale player data, generate 3D models, and retrieve avatars. Copy, paste, and go.
Base URL
https://gotale.net
Auth
Discord Login + API Key required for all /api requests.
Rate limits
Be kind — cache your responses where possible.
Playground
Try the wrapper endpoints in your browser or terminal.
GET /api/avatar/Timmi
GET /api/avatar/Timmi/profile
GET /api/3d/Timmi
GET /api/atlas/Timmi
GET /api/blockymodel/Timmi
All examples use the base URL above.
1) Get a Player Profile
Fetch the player object (username, id, skin parts). Useful for building profiles or passing the skin data into the render endpoint.
GET https://gotale.net/api/avatar/Timmi/profile
X-API-Key: gtl_...2) Generate a 3D Model
Send the username plus skin data, and receive a GLB model + atlas + avatar URLs.
GET https://gotale.net/api/3d/Timmi3) Use the Avatar
Direct image URL for profile cards, favicons, and social previews.
GET https://gotale.net/api/avatar/Timmi4) Get the Atlas Texture
Direct PNG atlas endpoint for texture workflows and downloads.
GET https://gotale.net/api/atlas/Timmi5) Get BlockyModel
Download-ready Blockbench model endpoint for editing and exports.
GET https://gotale.net/api/blockymodel/TimmiFAQ
Does this cache models?
Yes, identical requests can return cached GLB/atlas assets.
Do I need an API key?
Yes. Log in with Discord and create one key in the Developer Portal.
Can I use UUIDs?
Yes. Most endpoints accept username or UUID.
Is it CORS friendly?
Yes, you can call it from frontend apps.
Why this API?
The wrapper simplifies Hytale profile lookups, avatar access, and GLB generation into a few predictable endpoints. It is perfect for dashboards, bots, and custom profile viewers.