Skip to main content

Linux & Mac Issues

This page covers known issues specific to Linux and macOS users running the Homestead modpack.

Linux with AMD Radeon GPU​

Issue​

The modpack fails to launch or crashes immediately on Linux systems with AMD Radeon graphics cards.

Cause​

The CurseForge launcher uses an outdated version of LWJGL (Lightweight Java Game Library), which has compatibility issues with Mesa drivers used by AMD Radeon GPUs on Linux.

Solution​

Use Prism Launcher instead of CurseForge

The fix is simple: switch to Prism Launcher. Prism Launcher uses an updated version of LWJGL that works correctly with Linux AMD systems, allowing Homestead to boot up completely fine.

  1. Download and install Prism Launcher
  2. Import or download the Homestead modpack through Prism Launcher
  3. Launch the game - it should work without any modifications

That's it! No need to remove mods, update drivers, or add JVM arguments. The issue is entirely caused by CurseForge's outdated LWJGL, and Prism Launcher resolves this automatically.

Still not working with Prism Launcher?​

If you're still experiencing issues after switching to Prism Launcher, try these additional troubleshooting steps:

Option 1: Remove incompatible mods

Navigate to your Homestead mods folder and remove the following mods:

  • necronomicon (or similar filename)
  • spark (or similar filename)

Option 2: Update Mesa drivers

Update your Mesa drivers to version 25.0.3 or later:

For Ubuntu/Debian:

sudo add-apt-repository ppa:kisak/kisak-mesa
sudo apt update
sudo apt upgrade

For Fedora:

sudo dnf upgrade mesa*

For Arch Linux:

sudo pacman -Syu mesa

Warning: Always back up your system before updating graphics drivers.

Option 3: Add JVM arguments

Add these JVM arguments to your launcher:

-Dfml.earlyprogresswindow=false -Dorg.lwjgl.opengl.libname=libGL.so -Dsodium.forceCompatProfile=true -Diris.compatibility=true

Still Having Issues?​

If you've tried these solutions and are still experiencing problems:

  1. Join our Discord community for support
  2. Check the GitHub Issues page
  3. Make sure you're running the latest version of Homestead