Browse docs
Heist Creator
Start with a small heist
Open /heistcreator with an authorized administrator. The tool must be enabled in Config.HeistCreator.enabled; its default permission is sky_crimesystem.crimecreator. See Permissions.
You can also open it from /jobconfig → Crime System → Robbery → Heist Creator → Open Heist Creator. Save any Job Configurator changes first; this action closes the configurator and opens the Creator.
For your first heist, choose one building, one locked door or vault, one equipment preparation, and one cash cart. Complete that route as a player before adding more.
Operation Flow shows the missions. Select an entry to edit its settings in the panel on the right. Use World for placing and moving objects. The optional tutorial explains these controls.
The screenshots below come from the in-game Creator. They use the included Fleeca heist to show where the settings are. Select an image to enlarge it.
Create the heist
Create a draft
Select New draft. Give the heist a clear name and description, then set the minimum and maximum crew size.
Keep it disabled while you build it. Players should only see it once it is ready. Use a unique ID so it does not replace another heist.
Use New draft for your own heist. Select Fleeca: The Legion Job when you want to inspect or edit the supplied example. Other cards depend on what you have already created.
Choose what players must do
Split the robbery into a simple order:
- Reconnaissance: discover information or photograph a target, if needed.
- Preparation: collect or craft the equipment.
- Execution: open the target and take the loot.
Add the missions using the toolbar. Give each one an instruction players can follow, such as “Collect the hacking device and store it with the crew's equipment.”
- The hacking preparation is linked to the vault's opening method.
- The mask preparation supplies protection for the gas area.
- Security & blockades contains the vault, alarm and gas settings.
- The execution mission contains the loot. Select a mission or security entry to open its properties.
Set up the door or vault
Select the target door in the world and add an opening method, such as hacking or drilling. Check where players stand to use it and which direction it opens.
The opening method can add a preparation automatically. Open that preparation and finish its settings; it is not ready just because it has appeared in the list.
For the included example, open Operation flow → Security & blockades → Vault 1. Scroll the right-hand panel to Hack electronic lock.
- Required preparations controls which mission must be completed first.
- Required equipment lists the tool and quantity for this opening method. The player performing the hack must also carry the physical
hacking_device.
Provide the equipment
Choose whether players pick up or craft the equipment.
For a pickup, place a reachable collection point and check that the player receives the required physical item. For crafting, choose ingredients, amounts, and the finished item. Drill recipes start empty for you to fill.
Keep the generated completion requirement for the opening method. A preparation can mark equipment as acquired in the plan while a separate item is still needed in the player's inventory. Test both before continuing.
To inspect a physical pickup reward, select Acquire gas masks → Mission outputs in Fleeca and open the existing output in the right-hand panel.
- Choose Inventory item when the pickup should give an item to the player.
- Select the item your inventory uses; this example uses
gas_mask. - Set the quantity to match the equipment your crew needs. The included example gives four masks.
Place the loot
Add a cash cart or another supported loot object to the execution mission. Set its value and place it where the player has room to interact.
If every cart should be collected, make all of them required. Keep the reward small during testing, then adjust it for your economy.
Set the order
Connect tasks that must happen in sequence. For example, the hacking preparation must be completed before the vault's hacking method is available.
Use the dependency controls in the selected mission or opening method. A dependency simply means “finish this other task first.” Do not make the preparation depend on completing the robbery itself.
If police must be online, add a Police on duty requirement to the appropriate phase or mission and set the minimum. Police settings for ATM or shop robberies do not automatically apply to your heist.
Add security if needed
Use Security & blockades to configure the alarm and any gas or lasers. If you add gas, provide masks and test that players can equip them before entering it.
Start with direct loot payment. Add a buyer later if you want a separate sale after collection. See Security and Loot.
Check and activate
Use Validate and correct the reported problems. For your own drafts, leave the heist disabled while saving unfinished work.
When the heist is ready, enable it and select Save draft. A successfully saved, enabled heist becomes available to new player plans.
Create a fresh plan with a normal player and complete every step, including equipment storage and payment.
Add a physical pickup reward
Use this when a preparation completes successfully but the player still needs the actual inventory item. For example, the supplied Fleeca hacking preparation has a Planning asset output, which records progress without giving a physical device.
- Open Operation flow and select Acquire hacking device.
- Under Mission outputs, keep its existing Planning asset output. The vault uses that preparation result.
- Select Add output → Inventory item. Choose
hacking_deviceand set Amount to 1. - Confirm the output dialog, then save the whole heist using the correct action below. Confirming the small dialog alone does not save the heist.
- For Fleeca, restart the resource after Save JSON and create a new plan. Complete the pickup and check that the collecting player receives one device before depositing it.
Do not add another physical output if the preparation already grants that item. In particular, crafting gives its finished item, and the supplied gas-mask pickup already gives four masks.
Which save action should you use?
| What you are editing | What to do |
|---|---|
| Your own heist created with New draft | Enable it and use Save draft to make it playable |
| An included JSON heist, such as Fleeca | Use Save JSON, then restart the resource before testing a new plan |
| Your own unfinished draft | Leave it disabled and use Save draft to save your progress |
You do not need Publish to make a heist playable on your server. The online Heist Hub is currently unavailable; enable and save the heist locally instead.
Existing player plans keep their original settings. Always create a new plan when checking your edits.
Optional: export a heist file
You only need Dev export if you want a JSON copy to move or package yourself. Normal Creator saving is enough for your server.
Exports are written to config/heist_exports/. To load an export as an included heist, move it to config/heists/, add its relative file path to Config.HeistDefinitionFiles, and restart the resource. Simply placing a file in the folder does not enable it.
Back up customized JSON files before installing a resource update.
Before letting players use it
Check that a normal crew can obtain every tool, reach every interaction, complete the robbery, and receive the expected payment. If another administrator has edited the same heist, review any save-conflict message before replacing their changes.