Browse docs

Installation

Install Sky Fire Job, prepare its dependencies and database, and complete the first server setup.

Requirements

Before installing Sky Fire Job, update both required resources from the same CFX Portal account:

sky_base
sky_jobs_base

Keep both dependencies up to date when updating the fire resource. Start your framework, inventory, and targeting resources before the Sky resources.

Install the resource

Deploy the files

Place the sky_firejob resource in your server resources directory. Do not rename its resource folder.

Configure the start order

Add the resource to server.cfg after its dependencies:

server.cfg

# Framework, SQL, inventory, target and configured integrations first
ensure sky_base
ensure sky_jobs_base
ensure sky_firejob

Prepare the database

Config.AutoExecuteQuery is enabled by default in config/config.lua. With this option enabled, the resource creates and updates its tables automatically.

If you disable automatic queries, import the included import.sql manually before starting the resource.

The fire resource uses these tables:

sky_jobs
sky_fire_reports
sky_fire_oil_spills
sky_fire_extinguishers
sky_firejob_scenarios
sky_firejob_scenario_hub

Add the items required by the systems you enable. The default setup uses oil_absorbent, broom, foam_canister, fire_extinguisher_mount_kit, rescue_cushion, water_monitor, fire_heli_bucket, lighter, glas_hammer, hydrualic_spreader, and fire_air_bottle. Ready-to-use definitions and optional-item notes are listed on the Inventory Items page.

Copy the supplied PNG files from sky_firejob/config/inventory into your inventory image folder. The configured item key hydrualic_spreader intentionally uses the supplied hydraulic_spreader.png icon filename.

Configure custom hose weapon support when used (Optional)

Sky Fire Job uses the custom weapon WEAPON_SKY_HOSE for the hose/nozzle flow. Complete the matching optional step below when you use ox_inventory or Jaksam Inventory.

If ox_inventory strips or rejects the weapon, open ox_inventory/init.lua, locate the ignoreweapons block, add WEAPON_SKY_HOSE there, and then restart both resources. The exact location depends on your installed inventory version.

If you are troubleshooting this issue, also check your server logs for ox_inventory weapon-related warnings around equip, disarm, or weapon validation so you can confirm the custom hose weapon is the part being blocked.

-- ox_inventory/init.lua
ignoreweapons[`WEAPON_SKY_HOSE`] = true

Open jaksam_inventory/integrations/cl_integrations.lua and locate the IGNORED_WEAPONS table. Add WEAPON_SKY_HOSE to the existing table; the exact location depends on your installed inventory version:

IGNORED_WEAPONS = {
    [`WEAPON_UNARMED`] = true,
    [`WEAPON_HANDCUFFS`] = true,
    [`WEAPON_GARBAGEBAG`] = true,
    [`WEAPON_HOSE`] = true,
    [`WEAPON_PRESSURE1`] = true,
    [`WEAPON_ANIMAL`] = true,
    [`WEAPON_COUGAR`] = true,
    [`WEAPON_SKY_HOSE`] = true,
}

Configure media uploads when used

Report or tablet applications that save images or videos use the shared provider in sky_jobs_base/config/webhooks.lua. Configure FiveManage, Qbox CDN, or a custom adapter as described in Media Providers before enabling a media workflow.

Disable duplicate salaries

Set framework salary values for every firefighter grade to 0 when Sky Jobs Base manages salaries. Leaving both salary systems active can produce duplicate payments.

If you keep framework or external payroll instead, set Config.Salary.enabled = false in sky_jobs_base/config/config.lua.

Configure administrator access

Install the global permissions bootstrap, assign your administrator group, and review the Permissions page.

Grant boss permissions

Run /setboss once for the highest firefighter grade after a fresh installation or after clearing sky_job_permissions.

For example, a firefighter job whose highest grade is 4 should be configured with /setboss firefighter 4.

Configure the job

Restart the server, run /jobconfig, and select Fire Jobs. Configure jobs and enabled systems before inviting players on duty.

Test the first workflows

Test one station entry, one garage vehicle, one storage access, one fire spawn, one hose connection, and one cleanup workflow before going live.

First-start checklist

The server console shows no missing dependency or database errors.
/jobconfig lists Fire Jobs.
Your firefighter job and intended grades exist in the framework.
Required items exist in the selected inventory.
A test firefighter can go on duty and access the station features.
A test fire can be created and extinguished.
A test oil spill can be created, bound, and swept.
The scenario creator opens for an authorized administrator.

Most day-to-day settings are managed through /jobconfig when Config.UseJobConfigurator is enabled. Static and advanced settings remain in the open config directory.

Next steps

Support

Need help? Our support team is always ready to assist.

Join Discord

Overview

Start here for an overview of Sky Fire Job, its main systems, setup path, and documentation sections.

Configuration

Understand the Job Configurator, firejob feature toggles, static settings, and safe configuration workflow.