Problem
After a game update or a fresh installation, a Hytale server may fail to launch, displaying an oauth2: "invalid_grant" error in the server console logs. This error typically occurs when the server attempts to fetch the game manifest from https://account-data.hytale.com/game-assets/version/release.json, indicating an an issue with authentication or outdated/corrupted game files. The server will subsequently be marked as crashed by the Pterodactyl Daemon.
Error Snippet:
2026/02/06 20:34:02 error fetching manifest: could not get signed URL for manifest: could not get signed URL: Get "https://account-data.hytale.com/game-assets/version/release.json": oauth2: "invalid_grant" "The provided authorization grant (e.g., authorization code, resource owner credentials) or refresh token is invalid, expired, revoked, does not match the redirection URI used in the authorization request, or was issued to another client. The refresh token is malformed or not valid."
Solution
To resolve this issue, a clean reinstall of the Hytale server files is required. This process will refresh the game's core files while preserving your world data.
Steps to Reinstall Hytale Server Files:
- Access Server Panel: Log in to your server hosting panel (e.g., Pterodactyl Panel).
- Navigate to Files: Go to the Files tab for your Hytale server.
- Delete Game Files: Carefully delete ALL items listed in the files directory, EXCEPT for the folder named
universe. Theuniversefolder contains your world files and must be preserved. - Initiate Reinstall: Go to the Settings tab.
- Confirm Reinstall: Locate and click the Reinstall button, then confirm the action. This will download and set up fresh game files.
- Start Server: Once the reinstall process is complete, navigate back to the Console or Power tab and start your server.
Your Hytale server should now launch successfully without the invalid_grant error.
