Arch Linux User Repository

Just a few notes:

• This is not a flatpak, it uses the native version provided here

• useful folders:

~/.local/share/Hytale/ << Hytale Storage Location

~/.local/share/Hytale/install/release/package/launcher/ << the location the "current" verion is installed aswell as where new self-updated version are installed.

• the "current" folder is the launcher you will be using.

• This is self-updating, it will initially install it into your /opt folder then when you run the launcher a script checks if a folder has been generated and then moves the binary to that folder if it has not been gen'd. afterwords it is up to the launcher to keep itself up to date. folder: see #2 above.

• Uninstalling this removes almost everything except for the Hytale folder, This folder contain's game related data, such as the EULA, account data, launcher logs, licenses, and potentially game data, so delete at you're own risk (see #2 above)

• If you are having issue's try deleting this folder:

~/.local/share/Hytale/install/release/package/launcher/

it should not contain any game data (but maybe check just in case) after deleting update/run the 'hytale-launcher' it may fix the issue.

LAUNCH DAY DISACLAIMER: I only have a short amount of time to fix any issue's in the morning tomorrow, Meaning I may not be able to get anything fixed before I have to leave. I will attempt to fix any critical issues, but expect to not be able to run hytale, until #1 other users post solutions, #2 I get off of work and can start problem solving.

JAVA: The Hytale Game uses Java 25, I have added it as a OPTIONAL Dependency because the launcher does not require it. I have also added many notices to let you know that it needs to be installed for the game to launch. The wrapper script adds Java 25 to the PATH if it is available.

@PandaDEV I am at work, so I am unable to help much right now.

I honestly am not to familiar with audio setups (I always just set it and forget it)

Also some more info word be useful: - Desktop Env. - pulseaudio / pipewire - do you this if your route audio through a different device (headphones?)

Possibly some useful links: https://wiki.archlinux.org/title/PulseAudio/Troubleshooting https://wiki.archlinux.org/title/PipeWire#Troubleshooting

Im unable to get audio working the game says in the logs that no audio output device could be found. Im on niri if that is relevant.

$ hytale-launcher  
[OK] System clock is synchronized.
[OK] IPv6 is enabled and has a global address.
2026/01/15 13:53:24 INFO selected hytale storage directory path=/home/pandadev/.local/share/Hytale
time=2026-01-15T13:53:24.318+01:00 level=INFO msg="starting hytale-launcher" version=2026.01.14-cabac20 branch=release
Overriding existing handler for signal 10. Set JSC_SIGNAL_FOR_GC if you want WebKit to use a different signal
time=2026-01-15T13:53:24.361+01:00 level=INFO msg="setting current profile to bbec57b2-89a6-4350-bf71-5bedfcc563c3"
time=2026-01-15T13:53:24.361+01:00 level=INFO msg="restoring previously selected channel" channel=release
time=2026-01-15T13:53:24.361+01:00 level=INFO msg="setting channel" channel=release current=<nil>
time=2026-01-15T13:53:24.361+01:00 level=INFO msg="app initialized"
time=2026-01-15T13:53:24.736+01:00 level=INFO msg="setting network mode" mode=online
time=2026-01-15T13:53:25.381+01:00 level=INFO msg="setting current profile to bbec57b2-89a6-4350-bf71-5bedfcc563c3"
time=2026-01-15T13:53:25.579+01:00 level=INFO msg="update check complete" updates_found=0 force=false channel=release
time=2026-01-15T13:53:26.480+01:00 level=INFO msg="requesting game session for authenticated launch" uuid=bbec57b2-89a6-4350-bf71-5bedfcc563c3
time=2026-01-15T13:53:26.627+01:00 level=INFO msg="starting game process" game_package=game binary=/home/pandadev/.local/share/Hytale/install/release/package/game/latest/Client/HytaleClient args="[--app-dir /home/pandadev/.local/share/Hytale/install/release/package/game/latest --user-dir /home/pandadev/.local/share/Hytale/UserData --java-exec /home/pandadev/.local/share/Hytale/install/release/package/jre/latest/bin/java --auth-mode authenticated --uuid bbec57b2-89a6-4350-bf71-5bedfcc563c3 --name PandaDEV --identity-token *** --session-token ***]" client_dir=/home/pandadev/.local/share/Hytale/install/release/package/game/latest/Client
Set log path to /home/pandadev/.local/share/Hytale/UserData/Logs/2026-01-15_13-53-26_client.log
2026-01-15 13:53:26.7450|INFO|HytaleClient.Application.Program|HytaleClient v2026.01.13-50e69c385 (Linux x64 Release - Unix 6.18.4.1 - .NET 10.0.2) 
2026-01-15 13:53:26.7450|INFO|HytaleClient.Application.Program|Revision: 50e69c385653343d6bf1ad0103333f96dd93f54b, Environment: release (hytale.com), Patchline: release 
2026-01-15 13:53:26.7673|INFO|HytaleClient.Application.Program|Initial window size 1280x1377 
2026-01-15 13:53:26.8301|INFO|HytaleClient.Application.Program|Video memory max: 12582912
Video memory total available: 12582912
Video memory current available: 10657856
Video memory eviction count: 0
Video memory evicted: 0

2026-01-15 13:53:26.8301|INFO|HytaleClient.Application.Program|
System informations
 OpenGL driver: 3.3.0 NVIDIA 590.48.01
 GPU Renderer: NVIDIA GeForce RTX 3060/PCIe/SSE2
 GPU Memory Total: 12288 MB
 GPU Memory Available: 10408 MB

2026-01-15 13:53:27.0137|INFO|HytaleClient.Application.Program|Built 75 GPU programs successfully. 
2026-01-15 13:53:27.0437|INFO|HytaleClient.Application.Program|Failed to use device: , falling back to default. 
2026-01-15 13:53:27.0437|WARN|HytaleClient.Application.Program|No audio output devices found. The game will run without audio.

• bump: 2026.01.13-b6c7e88

• I have removed the debug script (I don't think it is required anymore)

• removed the optional java depends.

• I have added warnings to notify the user if time is out of sync or IPV6 is disabled. these require systemd and iproute2 optionally. I don't think it would be a good idea to force other packages and auto set these for the end-user (too intrusive)

timedatectl status

• System clock synchronized: no
• NTP service: inactive

sudo timedatectl set-ntp true

My clock was out of sync. the above command fixed it.

If you have ipv6 disabled, you'll get this error when trying to load a world:

Caused by: io.netty.channel.unix.Errors$NativeIoException: newSocketDgram(..) failed with error(-97): Address family not supported by protocol

Not sure if this is something we can fix at the package level though

It seems like they are having authentication error's from the server all over the place. source: twitter dev's

I am having such a error. I will try again later. :}

for now I have updated the package to the latest version and made the script no longer add java 25 to the path.

it seems the launcher downloads and uses its own java environment in ~/.local/share/Hytale/install/release/package/jre, i uninstalled openjdk and it still works fine.

Running hytale-launcher --debug will now print bunch of system/debug info, with the ability to upload to 0x0.st. hopefully this helps for tomorrows madness.

Instructions:

1. open a terminal.

2. start hytale with hytale-launcher --debug

3. start the game... maybe.

4. crash the game/ or have a issue.

5. CLOSE the launcher.

6. a bunch of debug info should print in the terminal.

7. REVIEW IT

8. After Reviewing it, you may upload it, or copy it to something else (pastebin?).

@yobson: Thanks, I was a little sceptical of touching the JAVA_HOME/PATH. I see I was overthinking. I did not set JAVA_HOME still because it was not specified in the wiki.

could it be a good idea to just set JAVA_HOME to java 25 in the hytale-launcher.sh, if it's installed, so user's do not need to manually set their default java to 25 by exporting JAVA_HOME themselves or using archlinux-java? u could check that archlinux-java status output includes java-25 or just checking that /usr/lib/jvm/java-25-openjdk/bin/java exists. or do it by appending to PATH instead, since that's what arch wiki recommends https://wiki.archlinux.org/title/Java#Launching_an_application_with_the_non-default_Java_version