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: Add the latest AAAParticles mod

  1. Download the latest version of the AAAParticles mod
  2. Add it to your Homestead mods folder
  3. Launch the game

Option 2: Remove incompatible mods

Note: Removing Eldritch End will prevent you from joining servers that have this mod enabled.

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

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

Option 3: 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 4: 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

Intel Mac Crashes​

Issue​

The modpack crashes on Mac computers with Intel processors.

Cause​

The Eldritch End mod includes the aaaparticles mod which is only built for Apple Silicon (M1/M2/M3 chips). It is not compatible with Intel-based Macs.

Solution​

Navigate to your Homestead mods folder and remove:

  • eldritch_end (or similar filename)

After removing this mod, the pack should launch normally on Intel Macs.

Still crashing? Try also removing the spark mod. It has known incompatibilities with some Mac devices and removing it may resolve persistent crashes.

How to Check Your Mac's Processor​

  1. Click the Apple menu () in the top-left corner
  2. Select "About This Mac"
  3. Look for "Processor" or "Chip":
    • If it says "Intel", you have an Intel Mac
    • If it says "Apple M1", "Apple M2", or "Apple M3", you have Apple Silicon

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