Skip to content

2.0.13

Choose a tag to compare

@brianmiller brianmiller released this 21 Sep 01:38

Confirmed working on real hardware: a modded world synced, launched and loaded all its mods correctly on Omarchy (Arch + Hyprland). Not yet confirmed on SteamOS or Bazzite specifically — reports welcome.

New: Linux Flatpak

For SteamOS, Bazzite and other immutable gaming distros where a .deb or .rpm is awkward or impossible (phvalheim-server#86).

flatpak install --user ./phvalheim-client-2.0.13-x86_64.flatpak

On Hyprland, Sway, i3 and other bare window managers, also run this once and log out and back in — otherwise clicking a world link silently does nothing. GNOME and KDE don't need it:

mkdir -p ~/.config/environment.d && printf 'XDG_DATA_DIRS=/usr/local/share:/usr/share:/var/lib/flatpak/exports/share:%s/.local/share/flatpak/exports/share\n' "$HOME" > ~/.config/environment.d/flatpak.conf

That puts Flatpak's applications directory on your session's search path, so the phvalheim:// handler can be found. It is needed by every Flatpak you install, not this one in particular, and a Flatpak cannot do it for you — an app can't edit its own session's environment. Confirm after logging back in:

gio mime x-scheme-handler/phvalheim     # should print com.phvalheim.Client.desktop

To exercise the client without any desktop wiring, copy a world's launch link from the server web UI (right-click → Copy Link Address):

flatpak run com.phvalheim.Client '<paste the phvalheim:// link here>'

Notes

Synced worlds live in ~/.config/PhValheim, the same place the .deb and .rpm use, so switching package format keeps your worlds.

Works with a system Steam (what SteamOS and Bazzite ship). A Steam installed as a Flatpak (com.valvesoftware.Steam) is also supported, but that path is untested — details and what to report. Steam libraries under home, /run/media, /media and /mnt work out of the box — that covers Steam Deck SD cards. For anywhere else:

flatpak override --user --filesystem=/your/library/path com.phvalheim.Client

This package is not meaningfully sandboxed — launching Valheim means running host programs and reading your Steam library. docs/FLATPAK.md lists every permission and why it is there.

Also in 2.0.13

  • Vanilla world support — zero-mod worlds launch through Steam's own +connect. Valheim has no client-side password argument, so the password is printed for you to type.
  • Windows installer rebuilt from scratch. The .msi now builds headlessly on Linux via wixl; the Visual Studio Setup Project is retired. Fixes along the way: the installer wizard silently vanishing, missing and unstyled wizard text, error 2834 on Cancel, and an upgrade that deleted the executable.
  • macOS ships as a universal build for Apple Silicon and Intel, with Apple Silicon running Valheim under Rosetta 2 for full mod compatibility. The .pkg is replaced by macinstall.sh. Earlier builds shipped an Apple-Silicon-only URL handler, so phvalheim:// links did not work on Intel Macs; they do now.
  • No more crash when Steam's library list is missing — you get a message instead of a stack trace.

Platform notes

  • macOS: install or upgrade with

    curl -fsSL https://raw.githubusercontent.com/brianmiller/phvalheim-client/master/macinstall.sh | bash

    The build is universal — Apple Silicon and Intel. If you installed on macOS between this release going Latest and 2026-09-23 and your client still reports 2.0.12, you got a placeholder tarball that was standing in for a build we could not produce at the time; re-run the command above to get the real 2.0.13.

  • The .msi is signed with a self-signed certificate, so SmartScreen warns about an unknown publisher — More info → Run anyway.

  • Steam Deck Game Mode has no terminal, so a launch there shows no progress output.