Plugins
FiveLaunch supports two ways to handle FiveM.app/plugins per client. This matters because some popular injectors/config systems assume plugins live at a specific physical path.
How FiveLaunch manages plugins
Section titled “How FiveLaunch manages plugins”Mode 1: junction (linked folder)
Section titled “Mode 1: junction (linked folder)”FiveM.app/pluginsbecomes a junction to the client’s plugins folder.- Fast and simple.
- Some plugins (especially ReShade-related tooling) will resolve the “real” path and may read/write into the client folder directly.
Mode 2: sync (copy/sync mode)
Section titled “Mode 2: sync (copy/sync mode)”FiveM.app/pluginsstays a real folder.- FiveLaunch copies the client’s plugins into
FiveM.app/pluginsat launch. - While the game is running, it only syncs a small set of “safe” config files back to the client.
- When the game exits, it finalizes sync of safe files.
If you’re troubleshooting weird plugin behavior, try switching the client’s pluginsMode to sync.
Plugins that commonly fail (and why)
Section titled “Plugins that commonly fail (and why)”ReShade
Section titled “ReShade”ReShade is the #1 case where the mode matters.
What can go wrong
- Config paths break: ReShade can store paths like
PresetPath,EffectSearchPaths,TextureSearchPathsinReShade.ini. If those paths were written assumingFiveM.app/pluginsis the real location, junction mode can make it resolve to the client folder instead. - “It’s installed but doesn’t load”: If ReShade/addons locate resources relative to a physical path, resolving into the client folder can confuse them.
- File sync expectations: Some setups expect that config/preset files update “next to FiveM.exe” or inside
FiveM.app/plugins. Junction mode can make those edits land somewhere unexpected.
Best fix
- Use
pluginsMode: sync(copy/sync mode) so ReShade sees files physically insideFiveM.app/plugins.
Where to find diagnostics
When plugins are enabled, FiveLaunch writes ReShade-related debug output per client:
%APPDATA%\FiveLaunch\clients\<clientId>\settings\reshade\diagnostics.log
This is the first thing to attach to an issue.
ReShade addons (e.g. shader packs / helper DLLs)
Section titled “ReShade addons (e.g. shader packs / helper DLLs)”Addons that:
- resolve paths aggressively (
realpath), - assume a specific working directory,
- or read/write additional
.ini/.logfiles at runtime,
are more likely to behave in sync mode.
ENB is not a typical “FiveM plugin folder” tool; it generally hooks the game’s graphics DLL chain and expects to live alongside the target executable.
Common reasons ENB fails in FiveM
- Wrong injection target: FiveM’s launch flow and wrapper executables can differ from a vanilla GTA install.
- Hooking conflicts: Other overlays/injectors can prevent ENB from attaching.
- File placement expectations: ENB usually expects files in the game root, not
FiveM.app/plugins.
Recommendation
- Treat ENB as “best effort” on FiveM. If you attempt it anyway, keep a clean backup and test with
pluginsMode: syncfor any plugin-folder components.
Quick troubleshooting checklist
Section titled “Quick troubleshooting checklist”- Close FiveM and GTA V.
- Switch the client’s
pluginsModetosync. - Launch once to let FiveLaunch seed
FiveM.app/plugins. - Verify ReShade loads and that your preset paths still make sense.
- If still broken, attach
diagnostics.logfrom the per-clientsettings/reshadefolder to a GitHub issue.