Complete Guide to FiveM Script Installation: From Download to Running (2026)
Step-by-step guide to installing FiveM scripts correctly — understanding fxmanifest.lua, resource structure, dependency management, SQL imports, and troubleshooting common installation errors.
What Is a FiveM Resource?
In FiveM, every script, mod, or addon is packaged as a resource — a folder containing code files, assets, and a manifest. Resources are the building blocks of your server. Everything from your framework (ESX, QBCore) to individual features (jobs, inventory, phone) is a resource.
Understanding how resources work is the foundation of FiveM server management. In 2026, with servers running 50–200+ resources, getting installation right the first time saves hours of debugging.
Understanding fxmanifest.lua
Every resource must have a fxmanifest.lua file at its root. This file tells FiveM what the resource contains and how to load it:
fx_version 'cerulean'
game 'gta5'
name 'my-resource'
description 'A description of what this resource does'
version '1.0.0'
author 'Author Name'
-- Server-side scripts
server_scripts {
'@oxmysql/lib/MySQL.lua', -- database dependency
'server/main.lua',
'server/events.lua',
}
-- Client-side scripts
client_scripts {
'client/main.lua',
'client/ui.lua',
}
-- Shared scripts (loaded on both server and client)
shared_scripts {
'config.lua',
'shared/utils.lua',
}
-- Files accessible by the client (NUI, images, etc.)
files {
'html/index.html',
'html/style.css',
'html/script.js',
}
-- UI page (if resource has NUI)
ui_page 'html/index.html'
-- Dependencies (must be loaded before this resource)
dependencies {
'qb-core',
'ox_lib',
}
Key fields:
| Field | Purpose | Required |
|---|---|---|
fx_version | API version | Yes |
game | Target game | Yes |
server_scripts | Lua files running on server | If has server code |
client_scripts | Lua files running on client | If has client code |
shared_scripts | Lua files running on both | If has shared code |
dependencies | Resources that must load first | If has deps |
files | Assets accessible to client | If has NUI/assets |
ui_page | NUI HTML entry point | If has NUI |
Step-by-Step Installation Process
Step 1: Download the Resource
Resources come from various sources:
- GitHub — Free resources, framework code
- Tebex stores — Premium scripts like those from Alone Studios
- Forum posts — Community scripts (exercise caution with quality)
After purchase or download, you will typically receive a .zip file.
Step 2: Extract and Inspect
Extract the archive and check the folder structure. A properly packaged resource looks like:
resource-name/
fxmanifest.lua
config.lua
client/
main.lua
server/
main.lua
sql/
install.sql
README.md
If the extracted folder contains another folder inside (double-nested), move the inner folder to your resources directory.
Step 3: Place in Your Resources Folder
Move the resource folder into your server's resources/ directory. Most servers use category folders for organization:
resources/
[core]/
qb-core/
ox_lib/
oxmysql/
[scripts]/
advanced-jobs-creator/
your-new-resource/
[vehicles]/
vehicle-addon-1/
Important: The folder name inside resources/ must match the resource name expected by other scripts. Don't rename folders unless you know what you are doing.
Step 4: Import SQL Files
Many resources include SQL files that create database tables. Look for files ending in .sql in the resource folder:
- Open your database management tool (phpMyAdmin, HeidiSQL, DBeaver)
- Select your server's database
- Open and run each
.sqlfile - Verify the tables were created:
SHOW TABLES;
Alternative (command line):
mysql -u root -p your_database < resources/[scripts]/resource-name/sql/install.sql
Step 5: Install Dependencies
Check the resource's fxmanifest.lua (or README) for dependencies. Common ones include:
| Dependency | What It Provides |
|---|---|
qb-core or es_extended | Framework features |
ox_lib | Utility library (notifications, input, targeting) |
oxmysql | Database connectivity |
ox_inventory | Inventory system |
ox_target or qb-target | 3D interaction targeting |
Install any missing dependencies before proceeding.
Step 6: Configure the Resource
Open config.lua (or config/ directory) and adjust settings:
- Framework selection (ESX, QBCore, QBOX, or auto-detect)
- Feature toggles
- Items, prices, and labels
- Permission settings
- Locale/language
Some premium scripts like Jobs Creator handle all configuration through an in-game interface, eliminating the need to edit config files entirely.
Step 7: Add to server.cfg
Add ensure resource-name to your server.cfg. Resource load order matters:
# 1. Database (must be first)
ensure oxmysql
2. Framework
ensure qb-core
3. Utility libraries
ensure ox_lib
4. Inventory
ensure ox_inventory
5. Scripts (dependencies loaded above)
ensure advanced-jobs-creator
ensure your-new-resource
Step 8: Restart and Test
Restart your server through txAdmin (or the console) and check:
- The resource appears in the server console without errors
- In-game functionality works as expected
- No other resources broke due to conflicts
Common Installation Errors and Fixes
"Resource not found"
Couldn't find resource your-resource in any resource directory
Causes: Wrong folder name, resource not in a scanned directory, double-nested folder.
Fix: Ensure the folder name matches the ensure name exactly. The folder must be directly inside resources/ or inside a category folder like [scripts]/. Check for nested folders: resources/[scripts]/resource-name/resource-name/fxmanifest.lua — the inner duplicate must be removed.
"Could not find dependency"
Could not find dependency ox_lib for resource your-resource
Fix: Install the missing dependency and ensure it loads before this resource in server.cfg.
SQL Import Failures
Symptoms: Script starts but shows "table doesn't exist" errors.
Fix:
- Check that you ran the SQL file against the correct database
- Look for multiple SQL files (some resources have separate files for different features)
- Verify MySQL user permissions include CREATE TABLE
Wrong Framework Version
Symptoms: attempt to index a nil value or function not found errors.
Fix: Check the script's minimum framework version. Update your framework if needed, or contact the script developer for a compatible version.
Best Practices for Managing Resources
| Practice | Why |
|---|---|
| Organize by category folder | Makes it easy to find and manage resources |
| Keep a changelog | Track what you installed and when |
| Test on staging first | Never install untested resources on your live server |
| Read the README | Most installation problems are covered in documentation |
| Use version control (git) | Enables rollback when something breaks |
| Limit total resources | More resources = more potential conflicts and higher resmon |
Checklist: Post-Installation Verification
- ⬜ Resource appears in server console on startup (green or white text)
- ⬜ No SCRIPT ERROR messages related to the resource
- ⬜ Database tables are created and populated
- ⬜ All dependencies are installed and loaded before this resource
- ⬜ In-game functionality works as documented
- ⬜ Resmon shows acceptable performance impact
- ⬜ No other resources were broken by the installation
- ⬜ Configuration is adjusted for your server's framework and needs
Install Premium Scripts with Confidence
All scripts from Alone Studios come with:
- Detailed documentation covering every installation step
- SQL files ready to import
- Auto-framework detection — works with ESX, QBCore, and QBOX
- Discord support for installation assistance
→ Browse Scripts at Alone Studios | → Jobs Creator Installation Guide
Ready to Transform Your Server?
FiveM Job Creator eliminates every problem discussed in this article. 0.00ms resmon. No-code configuration. ESX & QBCore native.
Get Job Creator on Tebex — €29.99