Browse docs
Troubleshooting
Start with the section matching your problem. Test again as the affected player after each change.
Crime System is missing from /jobconfig
Check that sky_base, sky_jobs_base, and sky_crimesystem started. Read the first error in the server console.
Keep Config.UseJobConfigurator enabled. On Qbox, also check that the configured organization exists as a gang in qbx_core.
See Installation.
I changed a config file, but nothing changed in game
Check the active value in /jobconfig → Crime System. Use that editor for the settings it offers; an edit to a Lua file alone may not replace the saved value or shipped default.
Drugs and heists also have their own editors. Change the entry in the correct editor, save it, and test a new activity. See Configuration.
A player cannot use the organization's features
Run /crimejobtest <playerId>. Check the organization and grade it reports.
Then check the membership model, grade permissions, and access to the particular facility. If only an administrator can use a drug feature, the administrator bypass may be hiding a missing player permission.
See Permissions.
Heist Creator does not open
Check administrator access and the crimecreator entry in Config.CommandPermissions in sky_crimesystem/config/config.lua. The default Heist Creator command uses that permission name. See Permissions.
If the message says planning is not ready, check the server console for database or startup errors.
My heist does not appear
Check that it is enabled and saved in the Heist Creator. You do not need to publish it to an online hub.
After editing a supplied heist file, restart Crime System during maintenance and create a new plan. An existing plan can keep the previous version.
See Heist Creator.
Preparations are finished, but the heist will not start
Read the plan's remaining requirements. Check crew members, police requirements if used, cooldown, and stored equipment.
A preparation can mark equipment as acquired without putting the physical item in a player's inventory. Follow Your First Heist for the included Fleeca setup.
The planning board is missing
An authorized organization member must place it with /heistplanning or the planning-table item. The default placement permission is Manage Members.
Crafting and equipment storage are separate locations. See Planning and Equipment.
A drug item is missing or cannot be used
Check the item name in the Drug Creator and the missing-item warning in the server console. Add that exact item to your active inventory.
Seeds, raw materials, and finished products are different items. A recipe that needs weed_dried will not accept raw_weed.
Not every registered item has an inventory Use action. Materials are used at their recipe or equipment interaction; consumption is only available for products configured for it.
See Inventory Items.
A plant will not grow or cannot be harvested
Check its water, nutrients, growing conditions, health, and current stage. Make sure the player has the required care or harvest tools and access to the plant.
A visible plant may still need more time. See Growing and Harvesting.
Laboratory production will not start
Check:
- The player's access to the laboratory.
- The selected recipe and all its ingredients.
- The required station or equipment.
- Power, fuel, and maintenance.
- Worker requirements, if used.
- Free space for the output.
With the supplied recipes, direct processing checks the player's inventory for ingredients and tools. A queued laboratory order uses the lab's Storage instead. Deposit its ingredients and required tools there, choose an available worker in Production, and put enough money in the lab treasury to cover the quoted cost.
A newly purchased lab can still need equipment. Follow Laboratories and Production.
My camper does not work as a lab
Buy and prepare the camper through the configured camper flow. Spawning a vehicle with the same model does not make it an owned laboratory.
Check its conversion, interior, and equipment in Campers and Mobile Labs.
Players cannot sell, or the payout is wrong
Check that the buyer accepts the finished product and quantity. Check any quality, contact, or cooldown requirements.
Market conditions can change offers. Then check the configured payment account; ordinary drug sales use black_money by default.
Police or medical staff receive no alert
Check that alerts are enabled, your dispatch integration is connected, and the recipient jobs match your server.
Not every action creates an immediate alert. Some drug consequences happen later. Test the specific event you want staff to receive.
Money wash businesses are unavailable
Money Wash Businesses is disabled in the current release. Changing its switch or placing locations will not enable it. Existing business data is retained. See Money Wash Businesses.
BlackBay has no handover location
Configure at least two meeting locations and two dead-drop locations in /jobconfig → Crime System → Darknet Market → Handover locations. Each point must be somewhere players can reach. Follow the setup in BlackBay Market.
Still need help?
Send support:
- Your Crime System, Sky Base, and Sky Jobs Base versions.
- Your framework and inventory.
- What you tried, what happened, and the exact error.
- The affected heist, recipe, item, or organization.
- Whether it happens to a normal player, an administrator, or both.
Include the relevant console error and remove passwords or other private information before sharing logs.