Support

If something breaks, you’ll get help faster if you include the right details.

1) Before you do anything

• Close FiveM and GTA V (file locks cause a lot of “it won’t switch” issues).
• If you’re testing something risky, make a backup first: Backups

2) Make sure you’re up to date

FiveLaunch updates itself in place. When a new build is available, an Update available badge appears (and the footer version label opens the updater too). Click it to download and restart. Many issues are already fixed in a newer version.

The very first install is manual (older builds predate the in-app updater); every update after that is one click.

While a game is running, the tray icon shows a live Playing <client> status with the elapsed minutes, so you can confirm which client actually launched.

3) Common questions (start here)

• Install/setup: Quick Start
• Client profile toggles: Clients
• ReShade / plugin weirdness: Plugins
• App settings and paths: Settings
• GTA settings reference: GTA settings XML
• CitizenFX.ini reference: CitizenFX.ini
• Folder expectations: Folder structure

4) Where logs are

When reporting issues, attach the relevant logs if you can.

• ReShade diagnostics (per client, if plugins are enabled):
  • %APPDATA%\\FiveLaunch\\clients\\<clientId>\\settings\\reshade\\diagnostics.log

If you’re not sure which client ID you’re using, include screenshots of the client settings screen.

5) Report a bug / request a feature

• Open a GitHub issue:
  • https://github.com/oyuh/fivelaunch/issues/new/choose
• Browse existing issues (maybe it’s already tracked):
  • https://github.com/oyuh/fivelaunch/issues

6) What to include in an issue

• What you expected to happen
• What actually happened
• Your FiveLaunch version (from the footer / updater)
• Your client toggles (mods, plugins, pluginsMode, gtaSettings, citizenFxIni, citizen, pure mode)
• Your FiveM install path (default vs custom)
• Logs (or at least the relevant excerpt)

More: GitHub Workflow