Back to Blog
Server Setup 11 min read October 5, 2025

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.

fivem install fivem script fxmanifest fivem resource fivem tutorial

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:

FieldPurposeRequired
fx_versionAPI versionYes
gameTarget gameYes
server_scriptsLua files running on serverIf has server code
client_scriptsLua files running on clientIf has client code
shared_scriptsLua files running on bothIf has shared code
dependenciesResources that must load firstIf has deps
filesAssets accessible to clientIf has NUI/assets
ui_pageNUI HTML entry pointIf 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:

  1. Open your database management tool (phpMyAdmin, HeidiSQL, DBeaver)
  2. Select your server's database
  3. Open and run each .sql file
  4. 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:

DependencyWhat It Provides
qb-core or es_extendedFramework features
ox_libUtility library (notifications, input, targeting)
oxmysqlDatabase connectivity
ox_inventoryInventory system
ox_target or qb-target3D 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:

  1. The resource appears in the server console without errors
  2. In-game functionality works as expected
  3. 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

PracticeWhy
Organize by category folderMakes it easy to find and manage resources
Keep a changelogTrack what you installed and when
Test on staging firstNever install untested resources on your live server
Read the READMEMost installation problems are covered in documentation
Use version control (git)Enables rollback when something breaks
Limit total resourcesMore 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