Installation

Installation & Requirements – Space Trucker

This guide covers the complete installation process for Space Trucker on your FiveM server.

---

System Requirements

Before you begin, make sure your server has the following dependencies installed and started:

• ox_lib Essential library for UI and utility functions. Download: GitHub – overextended/ox_lib

• ox_target (or qb-target compatible) Used for third-person “eye” interactions. Download: GitHub – overextended/ox_target

• Framework Compatibility The script is fully compatible with:

  • QBCore

  • Qbox

  • ESX (requires manual adaptation of files inside the bridge/ folder)

• OneSync (Required) Space Trucker uses entity state and server-control features that require OneSync enabled (Legacy or Infinity).

---

Step-by-Step Installation

1) Adding the Files

1. Download the latest version of space_trucker.

2. Extract the folder into your server’s resources directory.

3. (Optional) Rename the folder if you want, but keep it simple (example: space_trucker).

---

2) Database Setup (SQL)

For proper operation, execute the SQL files in the following order in your database (HeidiSQL, phpMyAdmin, etc.):

• sql.sql (Required) Creates the core system tables.

• system.sql (Optional) The script automatically creates the “System” company if it doesn’t exist. Run this file only if you need to restore or manually reset the system company.

---

3) Server Configuration (server.cfg)

Add the resource to your server.cfg. It’s crucial that it starts after its dependencies.

ensure ox_lib
ensure ox_target
ensure qb-core # or qbox
# ... other scripts ...
ensure space_trucker

---

4) First Boot Check

When starting the server for the first time:

• Check the server console (F8 or terminal) for errors.

• The script should print something like:

  • [space-trucker] Generating transport missions based on real stock....

• If you see “missing dependency” errors, confirm that ox_lib is starting before space_trucker.

---

Updates

If you are updating from an older version:

• Always backup your database first.

• Check if there are any update SQL files (example: sql_updates.sql) and run them if needed.

• Replace the script files, keeping your shared/config.lua as long as there were no structural changes to it.