Browse docs

Installation Guide

Sky-Systems offers a variety of high-quality FiveM scripts that can enhance the gameplay experience on your server. In this guide, we'll walk you through the process of installing a Sky-Systems script, step-by-step.

Before you start

For a job resource you need the current versions of all three resources from the same CFX Portal account:

  • sky_base
  • sky_jobs_base
  • the job resource, for example sky_ambulancejob

Your framework, SQL adapter, inventory, target system and other integrations selected in sky_base/config must already be installed and started. Do not rename any Sky resource folder.

Interactive setup guide

Select the Sky resources installed on your server. sky_base and sky_jobs_base remain selected because every job system depends on them. The generated plan combines the correct start order, inventory locations, permissions bootstrap, and the important checks for each selected resource.

Interactive installer

Build your setup plan

Select every Sky job system you own. The guide keeps both required bases selected and generates the correct start order, item paths, and resource-specific checks.

Required foundations

These resources are always installed first and cannot be deselected.

2 required
sky_baseRequiredFramework, inventory, database, target, and integration bridge.
sky_jobs_baseRequiredShared jobs, tablet, garage, storage, dispatch, and player interactions.
Your job systems Choose only the resources present on your server. 0 selected

Your generated guide

Install 2 resources in this order

Updates with your selection
server.cfgACE bootstrap + dependency order
# Place the configured framework, SQL, inventory, target, and integrations above this block.

# Required command-permission bootstrap (must be before ensure sky_base)
add_ace resource.sky_base command.add_ace allow

# Sky resources in dependency order
ensure sky_base
ensure sky_jobs_base

1

Prepare the shared foundation

  • Download matching current versions from the same CFX Portal account.
  • Review every Sky Base integration selector: framework, garage, progress bar, SQL, locale, phone, licenses, billing, keys, fuel, inventory, banking, and target.
  • Keep Config.AutoExecuteQuery enabled in Jobs Base and every selected job, or import each matching current import.sql exactly once.
  • Set framework job salaries to 0, or disable the Jobs Base salary system.
  • Review Config.CommandPermissions in Jobs Base for /jobconfig, /setboss, and the shared restraint commands.
2

Install items and images

  • sky_jobs_base/config/inventory — shared item README and supplied icons. Review the enabled restraint, tablet, GPS-jammer, and prop-placement item requirements. Open definitions

Select a job system above to add its job-specific inventory folder.

3

Complete each selected resource

Select at least one optional resource to generate its checklist.

4

Restart and verify before players join

  • Perform a full server restart and resolve every dependency, entitlement, SQL, and missing-item error.
  • Open /jobconfig and configure every selected job before placing stations or workshops.
  • Grant the intended highest grades with /setboss.
  • Jobs Base restraint administration: /admincuff ID handcuffs/admincuff ID zipties/adminuncuff ID Open shared commands
  • Test one complete duty, storage, garage, tablet, and job-specific workflow per resource.

Installation Steps

Follow these steps to install a Sky-Systems job script on your FiveM server:

Install the sky_base resource

With the script, you will receive a sky_base resource in the CFX Portal. This is a library that our scripts use for better performance, faster configuration, and less setup. Install the sky_base first by uploading it to your resources folder.

Configure the sky_base resource

Navigate to the config folder inside sky_base. Select your framework, SQL adapter, inventory, target, banking, vehicle keys, fuel, phone, billing and language integrations. This configuration applies globally to all Sky scripts. For more information, visit the sky_base documentation page.

Do not continue until the selected integration resources start without errors. A wrong integration selection can look like a job-script problem later.

Download the script

Download the script from the CFX Portal and upload it to your resources folder. Note that sometimes after downloading from the CFX Portal, the resource folder is packed within another folder with the same name. Ensure you place the folder on your server that contains the fxmanifest file.

Install sky_jobs_base

Every Sky job resource requires sky_jobs_base. Upload it next to sky_base and keep both resources on matching current versions.

Prepare the database

Sky Jobs Base and the job resources use Config.AutoExecuteQuery = true by default and create or migrate their tables automatically. In that default setup, do not additionally import import.sql.

Import a resource's included import.sql manually before first start only when you explicitly disable its automatic queries. Never import SQL from an older resource version over newer tables.

Configure the start order

Start framework and integrations first, then the Sky resources in dependency order:

server.cfg
# Framework, SQL, inventory, target and configured integrations first
ensure sky_base
ensure sky_jobs_base
ensure sky_scriptname

Replace sky_scriptname with the unmodified resource name, for example sky_ambulancejob.

Permissions bootstrap

Add this ACE entry to your server.cfg before ensure sky_base. It gives sky_base permission to wire configured command access automatically on server start:

server.cfg
add_ace resource.sky_base command.add_ace allow

Without this line, admin commands like /jobconfig, /setboss, and /revive cannot be granted to any player and only the server console will be able to use them.

The actual per-command permissions are defined in each resource's Config.CommandPermissions. For every configured group, Sky Base grants both the native command.<command> object and the resource runtime object such as sky_policejob.<command>. See each job's permissions page for details.

Customize the script settings

Navigate to the resource's config folder and review at least the language, enabled systems, command permissions and advanced/static settings. Most job and station settings are created later through /jobconfig.

Install inventory items and images

Open the selected resource's Inventory Items reference page and add every item used by the systems you enable in the format required by your inventory. Ready-to-copy shared restraint definitions are on the Jobs Base Inventory Items page; copy the available shared icons from sky_jobs_base/config/inventory. Job-specific items and icons remain in that job resource's config/inventory folder.

Item keys are configurable. If you change a key in the job configuration, use the same key in your inventory definition. Some optional systems add their own items; the resource-specific installation page separates required and optional items.

Complete resource-specific setup

Read the installation page for the job you are installing. Depending on the resource this includes requirements such as:

  • removing conflicting framework job/medical resources;
  • configuring the FiveManage Media API key used by tablet uploads;
  • installing an external wheelchair vehicle model;
  • using a metadata-capable inventory for police evidence;
  • disabling duplicate framework salaries;
  • granting the highest grade with /setboss;
  • creating jobs, hospitals, stations and workshops with /jobconfig.

For tablet or report features that upload images or videos, open the FiveManage dashboard, create a token with the Media permission, place it in sky_jobs_base/config/webhooks.lua as Webhooks.fivemanage.apiKey, and restart sky_jobs_base. See the FiveManage upload guide.

Save changes and start your server

Save your changes and perform a full server restart. Check the console for dependency, entitlement, SQL and missing-item errors before players connect. Do not rely on restarting a single resource as the installation test.

Important Considerations

  • Remove Conflicting Resources: Our scripts replace the default framework resources for the same job. For example, sky_ambulancejob replaces esx_ambulancejob, qb-ambulancejob, qbx-ambulancejob, and qbx-medical. Make sure to stop and remove the original resources from your server.cfg before starting ours. The scripts will warn you in the server console if a conflict is detected.
  • CFX Portal Account: Ensure that your server has a key from the same CFX Portal account the resource was purchased with. Otherwise, you will encounter the error: "You lack the required entitlement to use ..."
  • Do Not Rename Scripts: Do not rename the scripts. Renaming them will break their functionality.
  • Keep Dependency Versions Together: When updating a job resource, also update sky_base and sky_jobs_base from the same delivery. Mixed versions can expose incompatible APIs.
  • Do Not Run Two Salary Systems: Sky Jobs Base pays configured salaries. Set framework job-grade salaries to 0, or disable Config.Salary.enabled in sky_jobs_base if another payroll system should remain responsible.

First-start checklist

  • The framework, SQL adapter, inventory, target and configured integrations start before sky_base.
  • sky_base, sky_jobs_base and the job resource start in this order without console errors.
  • Automatic database migration completed, or the matching current import.sql was imported once when automatic queries are disabled.
  • Every enabled system's inventory items and images were installed.
  • ACE permissions are present before ensure sky_base.
  • /jobconfig lists the installed resource and its default jobs can be configured.
  • The highest intended boss grade was granted with /setboss.
  • Framework salaries and Sky Jobs Base salaries are not both active.
  • A full restart and one end-to-end job workflow were tested.

That's it! You've successfully installed a Sky-Systems script on your FiveM server.

Possible Issues

If you encounter any issues during the installation process, here are some troubleshooting steps you can try:

Failed to verify protected resource ...

This error message indicates that the script files may have been corrupted during the download process or that the .fxap file wasn't uploaded to your server. To resolve this issue, try the following steps:

  • Verify that the .fxap file is present in the sky_scriptname folder within the resources folder on your server.
  • Try deleting the sky_scriptname folder from your server and uploading it again using your FTP client.
  • If the issue persists, try using a different FTP client to upload the script files to your server.

You lack the required entitlement to use ...

If you see this error message, it may indicate an issue with your CFX Portal account. Try restarting your FiveM server and verifying your CFX Portal account to resolve this issue.

Support

Need help? Our support team is always ready to assist

Join Discord