Hytale Server Setup: Login, Config, Mods & Backups

You manage the Hytale server from VXPanel. Work through first start, ownership authentication, configuration, mods, and backups in the order below.

Choosing a server? Compare the managed Hytale hosting plan for file access, included backups and host responsibilities.

Before players join

Check authentication in Step 2, then join using the address and port assigned in VXPanel. A running process alone does not confirm that players can connect.

1. 📧 Accessing Your Control Panel

Check your email inbox for a “Server Created” notification. This contains your Panel URL, Username, and Password.

Open the Panel URL from the email.
Log in with your credentials.
Click on your server name to open your dashboard.

Hytale requires server authentication before it accepts player connections. Use the Hytale account that owns your game license. The publisher’s authentication guide documents the device login and credential-storage commands below.

Open the Console tab.
Click the green Start button in the top right.
Watch the console. If the installer requests a login to download server files, follow its current link and code. The screenshots show an example flow; your server may already have completed this stage.

Server console paused during startup, displaying the Hytale authentication prompt with a login URL and device code

Open the Hytale verification page shown in the console and enter the code. For the server device flow, the address is https://accounts.hytale.com/device. Sign in with your Hytale account and approve the request for your server.

Hytale account login page in the browser asking for the device verification code

Browser prompt asking you to approve the server’s sign-in request for your Hytale account

Browser confirmation screen showing a verified device code

Wait for the console to confirm success before continuing. Keep device codes and sign-in links out of public screenshots.

Server console confirming authentication succeeded and continuing the startup sequence

Once the server console accepts commands, run /auth status. If it reports that server authentication is required, start the device flow below. File-download authentication and the running server’s authentication are separate steps; do not repeat a completed login without checking its status.

Server console showing the second authentication prompt after startup

Run this command in the console: /auth login device

Complete the new request in your browser, then check /auth status again. Use the expiry shown by the active prompt. If it expires, run /auth login device to request a new code.
Run /auth persistence to check credential storage. If it uses Memory, credentials are lost when that process stops. Use the supported encrypted store to retain them across restarts: /auth persistence Encrypted

Server console output after running the auth persistence command, confirming the token is stored encrypted

Confirm that the command succeeds. If encrypted storage fails, send the error to VYKIX support. Saving credentials does not prevent revocation or authentication-service failures; follow a new login prompt if one appears.

3. 🖥️ The Console & Power Controls

The main dashboard is your command center.

Power Controls: Use Start, Restart, and Stop to manage the server. Use Stop before file changes so the server can save world data. Reserve Kill for a process that will not stop and follow support guidance.
The Console: The black screen shows server activity in real-time. You can type admin commands into the text bar at the bottom.
Connection Info: Copy your Server IP and assigned Port from VXPanel. Players need that exact address, including a non-default port.

Hytale port and runtime requirements

Hytale uses QUIC over UDP. The publisher’s default port is 5520, but a managed server can have a different assigned port. Use VXPanel’s value; do not replace it with the default.

For self-hosting, the official Hytale Server Manual lists Java 25 and at least 4 GB of memory. That minimum is not a player-capacity recommendation. Measure CPU and memory use with your world, mods, view distance and active players. VYKIX manages the host runtime on managed hosting; you manage it on a root-access VPS or dedicated server.

4. ⚙️ Hytale Server Config: Editing config.json

Use the File Manager to edit configuration. Server settings live in config.json; world settings have their own config.json under universe/worlds/. Back up the world and configuration before changing either.

Stop the server and wait for it to finish saving, then click the Files tab on the left sidebar.
You will see a list of all server files (e.g. config.json).

VXPanel file manager listing the Hytale server’s files, including config.json

Edit the setting in the correct file and preserve valid JSON. Changing a seed does not replace an existing world with a new one.
Start the server, check the console for errors, and join to verify the change.

5. 📂 Managing Files & Plugins

You have full access to your server’s files to add mods, plugins, or custom scripts.

Hytale server mods belong in mods/ as the .jar or .zip package supplied by the author. Check the mod’s supported Hytale build and required dependencies before upload. Back up, stop the server, upload the package, then start and read the loading messages. If a mod does not appear, check its path and console error before replacing world files.

Web Upload (Small files)

Go to File Manager -> Upload. Drag and drop configs or single plugins here.

SFTP (Large files)

For uploading large worlds or modpacks, use a client like FileZilla.

Go to the Settings tab to see your SFTP Host and Username.
Use your panel password to log in via your SFTP client.

6. 🛡️ Creating Backups

Always run a backup before installing new scripts or updates.

Click the Backups tab on the left.
Click Create Backup.
Name it something memorable (e.g., “Before Update v1.0”).
Wait for the backup to finish and keep a downloaded copy outside the server. Before using Restore from the … menu, stop the server and save its current state. A restore replaces files and can remove progress made since the backup.

If you see an “Auth Failed” or “Invalid Token” error during Step 2, try these fixes:

Expired device code: Follow the expiry shown in the console. Run /auth login device for a new server-login code rather than restarting a running server just to refresh the prompt.
Wrong signed-in account: Sign out of the Hytale account page, or use a private browser window to choose the account that owns the license.
Authentication still fails: Check /auth status and save the error text. Avoid repeated restarts; ask support to check the failed request.

👋 Need Help?

If you get stuck or your server crashes without warning, ask VYKIX on Discord.

Include the error, server name and time it occurred. Remove passwords, device codes, tokens and sign-in URLs containing codes before sharing console output.