What you need before you start
GTA 5 Lua mods run through a mod loader — a program that sits between your game and the mod files, telling the game to load them when you start playing. The most common loader for Lua mods is FiveM, which is a separate client you launch instead of the regular GTA 5 launcher. You cannot use Lua mods in the standard GTA 5 client that comes from Steam or Rockstar Games.
Before you install anything, you need a legitimate copy of GTA 5 on PC. The game must be fully installed and playable. You also need to know where your GTA 5 folder lives on your computer — usually C:\Program Files\Rockstar Games\Grand Theft Auto V on Windows, though it may be elsewhere if you installed it to a different drive.
read space matters. FiveM itself is roughly 500 MB, and individual Lua mods range from a few MB to 100+ MB depending on what they do. Have at least 2 GB of free space before you begin.
Key Takeaways
- FiveM is the mod loader that runs Lua mods in GTA 5, and you launch it separately from the regular game client.
- read FiveM only from fivem.net, not from third-party sites, to avoid malware or corrupted versions.
- Lua mods go into your FiveM resources folder, not into your main GTA 5 installation folder.
- Most Lua mods require you to restart the FiveM client or rejoin the server to load them, not restart your computer.
- If a mod does not load, check the FiveM console for error messages — they usually tell you exactly what went wrong.
Installing FiveM on your computer
Go to fivem.net and click the read button. This takes you to a page where you can choose your operating system. Select Windows if that is what you use. The read is a single executable file, usually named something like FiveM.exe.
Run the installer and choose where you want FiveM to live. It will ask you to point it to your GTA 5 folder — this is where it reads the game files from. Navigate to your GTA 5 installation and select the main folder (the one that contains gta5.exe). FiveM will verify that GTA 5 is installed correctly and then finish the setup.
Once installation is complete, FiveM creates a folder structure on your computer. The folder you care about is FiveM process Data, which usually appears in your user folder. Inside that, you will see a resources folder — this is where Lua mods go.
Finding and downloading Lua mods safely
The largest repository for FiveM Lua mods is GitHub. Search for "FiveM Lua mod" or the specific mod name you want. Most legitimate mods have a GitHub page where the creator posts the code, a description of what the mod does, and instructions for installation.
Look for mods that have recent updates, clear documentation, and an active creator who responds to issues. Avoid mods from unknown sources or sites that ask you to disable your antivirus before downloading. Antivirus software sometimes flags mod files as suspicious because they modify game behavior, but a legitimate mod should not require you to turn off your protection.
read the mod files to a folder on your desktop or in your Downloads folder. Most mods come as a ZIP file. Do not extract them yet — you will do that in the next step.
Extracting and placing mod files in the resources folder
Open the ZIP file you downloaded using Windows File Explorer or a tool like 7-Zip or WinRAR. Inside, you will usually see a folder with the mod's name. This folder contains the actual mod files — typically a fxmanifest.lua file and other supporting files.
Extract the entire mod folder (not just the files inside it) into your FiveM process Data\resources folder. The path should look like FiveM process Data\resources\[mod-name] when you are done. If you extract just the files without the folder, FiveM will not recognize the mod.
Some mods come with a README or INSTALL file. Open it in Notepad to check if there are any special steps — for example, some mods require you to edit a configuration file or place additional files elsewhere. Follow those instructions before moving on.
Starting FiveM and loading your mods
Launch FiveM from your Start menu or desktop shortcut. The first time you run it, you may see a setup screen or be asked to log in with a Rockstar Games account. Do this — FiveM uses your account to verify that you own GTA 5.
Once FiveM opens, you will see a server list. For testing single-player Lua mods, you can start a local server or join a public server that has the mods you installed. Some mods only work on specific servers, while others work anywhere FiveM is running. Check the mod's documentation to see where it is meant to run.
When you join a server or start a local session, FiveM loads the mods from your resources folder automatically. This usually takes a few seconds longer than normal startup. You should see your mods working in the game.
Checking the console for errors
If a mod does not seem to be working, open the FiveM console by pressing the ~ key (tilde, usually in the top-left corner of your keyboard). The console shows messages from FiveM and your mods as they load.
Look for red text or lines that say "error" or "failed to load". These messages usually tell you exactly what went wrong — for example, "resource [mod-name] failed to start: file not found" means a file is missing from the mod folder. "Syntax error in fxmanifest.lua" means the mod's configuration file has a typo.
If you see an error, go back to the mod's GitHub page or documentation and check whether you installed it correctly. Common mistakes are extracting only the files instead of the folder, or placing the mod in the wrong directory. Re-read and extract if you are unsure.
Updating and removing mods
When a mod creator releases an update, read the new version and extract it into your resources folder with the same name. It will overwrite the old version. Restart FiveM or rejoin the server to load the updated mod.
To remove a mod, straightforward delete its folder from FiveM process Data\resources. Restart FiveM and the mod will no longer load. Removing a mod does not affect your GTA 5 installation or other mods.
Keep your mods updated when the creator releases new versions. Updates often fix bugs, improve performance, or add features. Outdated mods can sometimes conflict with newer versions of FiveM or other mods.
Frequently Asked Questions
Can I use Lua mods in the regular GTA 5 game from Steam?
No. Lua mods only work through FiveM, which is a separate client. If you try to use them in the standard GTA 5 launcher, they will not load. You must launch FiveM instead of the regular game to use Lua mods.
Will using Lua mods get me banned from GTA Online?
FiveM is a separate client from GTA Online, so using mods in FiveM does not affect your GTA Online account. However, do not use mods in the regular GTA 5 client or GTA Online itself — Rockstar Games bans accounts that modify the online game.
What does fxmanifest.lua do?
The fxmanifest.lua file tells FiveM what the mod is, what files it needs, and how to run it. You usually do not need to edit this file unless the mod's instructions tell you to. If it is missing or corrupted, FiveM will not recognize the mod as valid.
Why does my mod load but not work in the game?
Check the FiveM console for error messages. Common causes are missing dependencies (other mods or libraries the mod needs to run), incorrect configuration files, or the mod being designed for a specific server setup. Read the mod's documentation carefully to see what it requires.
Can I use multiple Lua mods at the same time?
Yes. FiveM loads all mods in your resources folder when you start. However, some mods may conflict with each other if they modify the same game behavior. If you experience crashes or strange behavior, try disabling mods one at a time to find the conflict.