Skip to content

docs(hytale): add Hytale server page - #130

Merged
dgibbs64 merged 2 commits into
masterfrom
docs/hytale
Oct 4, 2026
Merged

dgibbs64 merged 2 commits into
masterfrom
docs/hytale

Conversation

@dgibbs64

@dgibbs64 dgibbs64 commented Oct 4, 2026

Copy link
Copy Markdown
Member

Summary

New page for Hytale (hytserver), added in GameServerManagers/LinuxGSM#4928. Please merge after #4928.

Covers:

  • Requirements: a Hytale account that owns the game (needed even to download the server), Java 25, 4 GB of RAM.
  • The two one-time logins: the downloader at install, and the server on first start. Where each is saved, and that both are in backups.
  • Installing: step by step, including how LinuxGSM shows the server login URL and sends it as an alert, and how to log in again manually.
  • Docker: the login URLs appear in docker logs, and the credentials persist on the data volume.
  • Server settings in config.json, the patchline option, and ports (5520/udp).
  • Updates: unattended updates use the saved login; how an expired login behaves; and a note on Hytale's own hourly update checker.

Written from a full test of #4928 on Ubuntu 24.04 with a Hytale account: install, both logins, restart, details, monitor, check-update and stop.

@dgibbs64
dgibbs64 requested a balanced review from Copilot October 4, 2026 17:59
@dgibbs64
dgibbs64 merged commit a41428b into master Oct 4, 2026
5 checks passed
@dgibbs64
dgibbs64 deleted the docs/hytale branch October 4, 2026 18:02

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟡 Changes recommended

The page contains inaccurate cross-distribution Java package guidance and attributes an update warning to details, which does not perform that check.

Review effort: Balanced
Findings: 2 Low severity

Open (2)
What changed in this PR

Adds Hytale server documentation covering installation, authentication, configuration, Docker, ports, and updates.

Changes:

  • Adds the Hytale documentation page.
  • Adds Hytale to the documentation navigation.
File Description
SUMMARY.md Links the new Hytale page.
game-servers/​hytale.md Documents Hytale server administration.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread game-servers/hytale.md
## Requirements

* A **Hytale account that owns the game**. It's needed even to download the dedicated server, and for the server itself to run.
* Java 25 (`openjdk-25-jre`). LinuxGSM installs it as a dependency.
Comment thread game-servers/hytale.md
If the saved downloader login stops working, an unattended update fails within 5 minutes with a message, rather than waiting forever. Run `./hytserver update` in a terminal and approve the login again.

{% hint style="info" %}
The Hytale server also checks for updates itself, every hour. If it updates its own files, `./hytserver details` and `update` warn that the server files are newer than LinuxGSM's record, and the next `./hytserver update` corrects it.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants