FAQ

WARNING

Before you try anything here, make sure your launcher is up to date.
Most of the time that should fix any issues you're having.

Where are the files?

• You can open the instance's .minecraft folder by selecting it and pressing the Files button. But if that's not enough:


• On Windows, launcher files are at
  

  C:/Users/YOUR_USERNAME/AppData/Roaming/QuantumLauncher/

  You probably won't see the AppData folder.
  Press Windows + R and paste this path, and hit enter.
• On Linux, the launcher files are at
  

  ~/.config/QuantumLauncher/

  (~ refers to your home directory).
• On Mac, the launcher files are at
  

  ~/Library/Application Support/QuantumLauncher/



• Instances are located at
  

  QuantumLauncher/instances/YOUR_INSTANCE/

• .minecraft folder is located at
  

  YOUR_INSTANCE/.minecraft/

How do I install mods?

• Select your instance and click on the "Mods" button, then install a loader (if you haven't already) by clicking on "Install Fabric" (recommended), "Install Forge", or the other loaders.
• After that, click on "Download mods" and browse through the store to find mods you want to install.
• You can also install mods manually. Click on "Go to Mods Folder" button and paste the mods in there.

macOS: "QuantumLauncher is damaged" / "cannot be opened" / "eject disk image"

As a temporary workaround, run this in the terminal:



xattr -rc /Applications/quantum-launcher.app

Apple being a greedy company, demands a "Developer Id" fee from me, that I can't afford. If I don't pay, they intentionally block my app which is what you see right now. Running this terminal command bypasses the blocking.

How do I install shaders?

• Select your instance and click on the "Mods" button, then click on "Install Fabric", select the latest version and install it.
• Then select your instance and go to "Mods" and click on "Download mods".
  Download Iris, Sodium, Fabric API, and Mod Menu
• Download the shader you want to use from the internet. In the main menu, click on "Files".
  Go to the "shaderpacks" folder (create one if it isn't there) and paste the shader zip or folder you downloaded.
• You should be ready to go! Select the shader in the video settings in Minecraft.
• Note: You can also do this with Optifine, but it's less recommended. Instead of installing Fabric and those mods, just install Optifine.

How do I change skins?

• Use the customskinloader mod. Go to "Mods" and if you haven't already, install Fabric or Forge.
• Then click on "Download mods" and search for "CustomSkinLoader" and install it.
• After that, you can configure CustomSkinLoader in-game. It's recommended that you create an ElyBy Account and pair it with this mod.

How do I change the icon/create a shortcut of the launcher on Linux?

• Create a quantumlauncher.desktop file. Type in the following thing:
  

  [Desktop Entry]
  Encoding=UTF-8
  Version=1.5
  Type=Application
  Terminal=false
  Name=QuantumLauncher
  Comment=A simple, powerful Minecraft launcher
  Categories=Game;
  Exec=/path/to/quantum_launcher
  PrefersNonDefaultGPU=true
  Icon=/path/to/icon.ico

• Add the path to the quantum_launcher executable to the Exec field.
• If you want an icon, download one from here and add it's path to the Icon field, otherwise remove that line.
• If you want to see the debug output of the launcher, change Terminal to true.
• Now move this file to ~/.local/share/applications/
  (note: ~ means your home directory)
  (also, if you don't see the .local folder, press ctrl H in your file explorer to show hidden files)
• If the launcher doesn't show up in your menu, try any of these until it works:
  
  
  • Restarting the desktop environment or logging out of your computer and logging back in.
  • Running the command:
    

    chmod +x ~/.local/share/applications/quantumlauncher.desktop

    (replace with the path to the desktop file)
  • Running the command:
    

    desktop-file-validate ~/.local/share/applications/quantumlauncher.desktop

    (replace with the path to the desktop file)
  • Running the command:
    

    update-desktop-database ~/.local/share/applications

    (replace with the folder containing the desktop file)

"Connection timed out: No further information"

• Try allowing Minecraft through firewall. Here's a video on how to do it. And if you're playing Minecraft on a private server also try telling the host to do the same.
• Make sure you have a stable internet connection.
• If you are using a VPN, try disabling it. If you are using a firewall, make sure the launcher is allowed to connect to the internet. If you are using a proxy, make sure the launcher is configured to use it.

Invalid Session

• This means that the server needs a paid Minecraft account. If you know the host, you can tell them to open server.properties file and set online-mode to false.
• (WARNING: Doing this will make the server vulnerable to hackers, maybe consider adding some kind of login mod and whitelist to the server too)

Mod ___ ___ requires version ___ or later of (some mod), which is missing

• Install whatever mod is said at the end, whatever it may be. Go to Mods->Download Mods then search the name and install it.

Storing the game on another drive (windows)

• Press Windows and R keys, type %appdata% A file explorer window will come.
• In here, find the QuantumLauncher folder and move it to the other drive (cut and paste).
• Then open command prompt or terminal and type
  

  mklink /D "%APPDATA%\Roaming\QuantumLauncher" "E:\Path\To\Link"

  where E:\Path\To\Link is changed to wherever your folder is on the other drive

Out of stack space / unable to create new native thread

• This can happen when using Vulkan renderer mods (such as VulkanMod) together with NVIDIA proprietary drivers.
• Add the following Java argument to your instance:
  

  -Dorg.lwjgl.system.stackSize=256

• This reduces the native thread stack size, preventing the launcher from running out of native stack space.

Launcher won't open / LLVM error on Windows

• If the launcher does nothing when opened, gets stuck at Starting up the launcher..., or shows an LLVM error (eg: error: Invalid record (Producer: 'LLVM3.8.0' Reader: 'LLVM 3.8.0')), try forcing the OpenGL backend.
• Create qldir.txt inside your QuantumLauncher/ folder with the following contents:
  

  .
  i_opengl

GLFW error 65548 on Wayland (Minecraft 1.18.2)

• If Minecraft crashes with GLFW error 65548: Wayland: The platform does not support setting the window icon, force the game to use X11 instead of Wayland.
• Add the following environment variable to your instance:
  

  XDG_SESSION_TYPE=x11

• This runs the game through XWayland, avoiding the Wayland GLFW limitation.

(linux): microsoft account error: keyring error: Platform secure storage failure: DBus error: The name is not activatable

• Try installing gnome-keyring and libsecret (the package name might vary based on distro, try searching it)
  Then try
  

  eval $(/usr/bin/gnome-keyring-daemon --start)

• Note: you might need to run this command after every startup of your computer.
  Consider adding it to startup commands, or creating a script that runs this before the launcher.