Created
March 4, 2026 17:19
-
-
Save yuri-potatoq/64000fc847314d0a607e1c617d36ed72 to your computer and use it in GitHub Desktop.
Revisions
-
yuri-potatoq created this gist
Mar 4, 2026 .There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode charactersOriginal file line number Diff line number Diff line change @@ -0,0 +1,191 @@ # Hytale Launcher — Linux Native Install Guide > Covers **Arch / Manjaro**, **Ubuntu / Debian / Mint**, and **Fedora**. > No Flatpak. Just the native binary from Hytale's servers. --- ## 1. Download & Extract ```bash wget https://launcher.hytale.com/builds/release/linux/amd64/hytale-launcher-latest.zip unzip hytale-launcher-latest.zip -d hytale-launcher cd hytale-launcher chmod +x hytale-launcher ``` --- ## 2. Check What Is Already Missing (optional but recommended) ```bash ldd ./hytale-launcher | grep "not found" ``` Any library listed as `not found` needs to be installed. Use this to catch distro-specific gaps not covered below. --- ## 3. Base Packages Install these regardless of your GPU or desktop environment. ### Arch / Manjaro ```bash sudo pacman -S \ glib2 gtk3 webkit2gtk-4.1 glib-networking \ gsettings-desktop-schemas \ libdrm libxkbcommon \ libx11 libxcomposite libxdamage libxext libxfixes libxrandr libxshmfence \ pango cairo freetype2 fontconfig \ alsa-lib libpulse pipewire-pulse \ nss nspr openssl \ atk at-spi2-atk libcups expat dbus \ gcc-libs xdg-utils hicolor-icon-theme ``` ### Ubuntu 24.04+ / Debian 12+ / Mint 22+ ```bash sudo apt install \ libglib2.0-0 libgtk-3-0 libwebkit2gtk-4.1-0 glib-networking \ gsettings-desktop-schemas \ libdrm2 libxkbcommon0 \ libx11-6 libxcomposite1 libxdamage1 libxext6 libxfixes3 libxrandr2 libxshmfence1 \ libpango-1.0-0 libcairo2 libfreetype6 libfontconfig1 \ libasound2t64 libpulse0 \ libnss3 libnspr4 libssl3 \ libatk1.0-0 libatk-bridge2.0-0 libcups2 libexpat1 libdbus-1-3 \ libstdc++6 xdg-utils hicolor-icon-theme ``` > **Ubuntu 22.04 / Mint 21:** replace `libwebkit2gtk-4.1-0` with `libwebkit2gtk-4.0-0` and `libasound2t64` with `libasound2`. ### Fedora 40+ ```bash sudo dnf install \ glib2 gtk3 webkit2gtk4.1 glib-networking \ gsettings-desktop-schemas \ libdrm libxkbcommon \ libX11 libXcomposite libXdamage libXext libXfixes libXrandr libxshmfence \ pango cairo freetype fontconfig \ alsa-lib pulseaudio-libs pipewire-pulseaudio \ nss nspr openssl-libs \ atk at-spi2-atk cups-libs expat dbus-libs \ libstdc++ xdg-utils hicolor-icon-theme ``` --- ## 4. GPU Drivers Install the section matching your graphics card **in addition to** the base packages. ### NVIDIA | Distro | Command | |--------|---------| | **Arch** | `sudo pacman -S nvidia-utils libglvnd vulkan-icd-loader` | | **Ubuntu/Mint** | `sudo apt install nvidia-driver-570 libvulkan1 libgl1` *(adjust driver version)* | | **Fedora** | `sudo dnf install akmod-nvidia vulkan-loader` then reboot | > On Ubuntu/Mint, if you installed NVIDIA via the GUI driver manager, `libvulkan1` is usually the only missing piece. --- ### AMD (RDNA / GCN) | Distro | Command | |--------|---------| | **Arch** | `sudo pacman -S mesa vulkan-radeon libva-mesa-driver mesa-vdpau` | | **Ubuntu/Mint** | `sudo apt install mesa-vulkan-drivers libvulkan1 libgl1-mesa-dri` | | **Fedora** | `sudo dnf install mesa-vulkan-drivers mesa-dri-drivers vulkan-loader` | --- ### Intel (Iris / Arc) | Distro | Command | |--------|---------| | **Arch** | `sudo pacman -S mesa vulkan-intel intel-media-driver` | | **Ubuntu/Mint** | `sudo apt install mesa-vulkan-drivers libvulkan1 intel-media-va-driver libgl1-mesa-dri` | | **Fedora** | `sudo dnf install mesa-vulkan-drivers intel-media-driver vulkan-loader` | --- ## 5. Desktop Environment These packages ensure `xdg-open` can launch your browser for login, and that keyring/portal services work correctly. ### GNOME Most dependencies ship with a default GNOME install. You may just need: | Distro | Command | |--------|---------| | **Arch** | `sudo pacman -S xdg-desktop-portal xdg-desktop-portal-gnome gnome-keyring` | | **Ubuntu/Mint** | `sudo apt install xdg-desktop-portal xdg-desktop-portal-gnome gnome-keyring` | | **Fedora** | `sudo dnf install xdg-desktop-portal xdg-desktop-portal-gnome gnome-keyring` | --- ### KDE Plasma The launcher is GTK-based, so a few GTK bridge packages are needed: | Distro | Command | |--------|---------| | **Arch** | `sudo pacman -S xdg-desktop-portal xdg-desktop-portal-kde gtk3 libsecret` | | **Ubuntu/Mint** | `sudo apt install xdg-desktop-portal xdg-desktop-portal-kde libsecret-1-0` | | **Fedora** | `sudo dnf install xdg-desktop-portal xdg-desktop-portal-kde libsecret` | > KDE uses KWallet for credentials. Make sure KWallet is unlocked before launching. --- ### XFCE XFCE is minimal and usually missing several GTK services that the launcher expects: | Distro | Command | |--------|---------| | **Arch** | `sudo pacman -S xdg-desktop-portal xdg-desktop-portal-gtk gnome-keyring libsecret dconf` | | **Ubuntu/Mint** | `sudo apt install xdg-desktop-portal xdg-desktop-portal-gtk gnome-keyring libsecret-1-0 dconf-cli` | | **Fedora** | `sudo dnf install xdg-desktop-portal xdg-desktop-portal-gtk gnome-keyring libsecret dconf` | > On XFCE you may also need to start `gnome-keyring-daemon` manually if login doesn't open a browser: > ```bash > eval $(gnome-keyring-daemon --start) > export GNOME_KEYRING_CONTROL > ``` --- ## 6. Run ```bash cd hytale-launcher ./hytale-launcher ``` To install it system-wide: ```bash sudo mkdir -p /opt/hytale-launcher sudo cp -r . /opt/hytale-launcher/ sudo ln -s /opt/hytale-launcher/hytale-launcher /usr/local/bin/hytale-launcher ``` --- ## Troubleshooting | Symptom | Likely cause | Fix | |---------|-------------|-----| | `Unable to open default system browser` | `xdg-open` can't reach D-Bus | Install `xdg-desktop-portal` + your DE backend (section 5) | | Black / blank launcher window | Missing WebKit | Check `webkit2gtk` version matches your distro | | Launcher crashes on start | Missing Vulkan ICD | Install GPU Vulkan package (section 4), run `vulkaninfo` to verify | | No audio in-game | Wrong audio backend | Install both `alsa-lib` and `libpulse`; ensure PipeWire is running | | `libssl.so.3: not found` | Old OpenSSL | On Ubuntu 22.04, install `libssl3` from backports |