Getting started with Hytale

This guide walks you through setting up your Hytale server on ServerPrism, from ordering and initial deployment to configuring your server and inviting players.

Ordering on ServerPrism

1. Select a plan: For Hytale, we recommend starting with at least 4 GB RAM. If you plan to host many players or complex custom content, consider 8 GB to 16 GB RAM for optimal performance.
2. Choose a region: Select the data center closest to you and your players for the best connection quality.
3. Deploy: On the order page, select the 'Hytale' runtime. Your server will begin deploying immediately after purchase.

First boot

After ordering, your Hytale server will automatically start for the first time. During this initial boot, the server downloads necessary game files and generates the world. This process can take several minutes.

You can monitor the progress through the Console tab in your ServerPrism panel (https://serverprism.com/dashboard). The server is ready when you see messages indicating successful world generation and that the server is listening for connections.

Connecting / inviting players

Once your Hytale server is running, players can connect using its IP address and port.

1. Find your server address: Your server's IP address and port are displayed on the Overview tab of your ServerPrism panel. The default Hytale port is not yet officially confirmed, but typically game servers use a default like 25565 or 28015. Refer to your panel for the exact assigned port.
2. Share with players: Provide the IP address and port (e.g., 192.0.2.1:25565) to your friends.
3. In-game: Players will typically use a 'Direct Connect' option within the Hytale game client to enter the server address and join.

You can also attach a free subdomain to your server from your ServerPrism customer dashboard, making it easier for players to remember your server address.

Configuration basics

Most server settings are managed through configuration files located in your server's directory. You can access these files using the File Manager in your ServerPrism panel or via SFTP.

The primary configuration file is expected to be named something like server.json or server.cfg (official name pending Hytale's release). Key settings you'll want to adjust include:

• Server Name: The name displayed in server lists.
• Max Players: The maximum number of players allowed on your server.
• Password: Set a password if you want to restrict access.
• Game Mode: (e.g., Survival, Creative, Adventure).
• World Seed: To generate a specific world.

To edit configuration files:

1. Navigate to the File Manager tab in your ServerPrism panel.
2. Browse to the main server directory (often ~/server or ~/game).
3. Locate the relevant configuration file (e.g., server.json).
4. Click on the file to open it in the editor.
5. Make your changes and Save Content.
6. Restart your server from the Console tab for changes to take effect.

Some common settings might also be available as Startup Variables on the Startup tab of your panel. Using these variables is often easier as they persist across file reinstalls and are validated by the panel.

Common issues

• Server not starting: Check the Console tab for error messages. Common causes include incorrect configuration file syntax or missing game files (which should be handled by ServerPrism's one-click install).
• Players can't connect: Ensure you are providing the correct IP address and port. Verify the server is fully started and not password-protected (or that players have the correct password). Check the firewall status in the Console; ServerPrism automatically configures ports, but sometimes external network issues can interfere.
• Lag or performance issues: This often indicates insufficient RAM. You can upgrade your server plan from your ServerPrism customer dashboard to allocate more RAM. Also, check the console for any specific warnings about high CPU or memory usage.

Next steps

Once your basic server is running, you can explore further customization:

• Mods and Plugins: Hytale is expected to have extensive modding support. Look for community-created mods and follow their installation instructions, typically involving placing files in specific server directories.
• World Management: Learn about commands to manage your world, reset chunks, or backup your server data.
• ServerPrism Features: Explore advanced features like scheduling tasks, creating backups, and managing subusers from your panel.

If you encounter any issues not covered here, feel free to open a support ticket at https://serverprism.com/tickets. Please include your server ID and any relevant console logs for faster assistance.