Launcher problems

HMCL FileSystemException: Operation Not Permitted on macOS or Linux

What the log looks like

java\.nio\.file\.FileSystemException:[\s\S]{1,300}?sun\.nio\.fs\.UnixException\.translateToIOException[\s\S]{1,800}?org\.jackhuang\.hmcl\.util\.io\.FileUtils

How to fix it

  1. Move the HMCL `.jar` file and your `.minecraft` folder out of macOS protected directories (`Downloads`, `Desktop`, or `Documents`) into a standard folder inside your user home directory, such as `~/Games/HMCL/`.
  2. If you are on macOS and want to keep HMCL in its current folder, open System Settings > Privacy & Security > Files and Folders (or Full Disk Access) and grant folder access permissions to `java` / `Terminal`.
  3. If HMCL still refuses to open on startup, enable hidden files (`Cmd + Shift + .` on macOS or `Ctrl + H` on Linux) in the HMCL folder and delete or rename `.hmcl.json` so the launcher can generate a fresh configuration file.
  4. On Linux, check your HMCL game directory path for accidental backslashes (`\`) and move `.minecraft` onto a native Linux filesystem (such as `ext4` or `btrfs`) instead of an NTFS partition.
LoadersVanilla, Forge, Neoforge, Fabric, Quilt
SeverityBreaks something
CategoryLauncher problems

Check your own log

Related errors

Launcher problemsATLauncher Startup Crash: ChunkyException NullPointerException in makeStyleSheetClose any running ATLauncher or Java processes in Task Manager.Launcher problemsClassNotFoundException: net.fabricmc.loader.impl.launch.knot.KnotClientConnect to the internet and launch the profile once in online mode so your launcher can download any missing FLauncher problemsClassNotFoundException: net.minecraft.client.main.MainThe version jar in .minecraft/versions is missing or emptyLauncher problemsFabric Crash: Could Not Create Directory (iris-reserved)Switch away from the broken standalone Iris profile by installing standard Fabric Loader for your Minecraft veLauncher problemsFabric: Minecraft game provider couldn't locate the game!Run the vanilla (unmodded) profile for that exact Minecraft version once in your launcher so it downloads a clLauncher problemsForge Crashes on Startup: Missing TByteObjectHashMap (trove4j Library)Use the official Minecraft Launcher or an established third-party launcher (such as Prism Launcher or MultiMC)