Installation
Step 1: Download and Prepare Files
Configurable Settings
For detailed configuration, visit this page: DOCS.RAINMAD.COM
cfg.timecycleInShipZone
Custom timecycle name (or false to disable).
Heist Rules
cfg.heistInitiatedByDriverOnly
Only driver can trigger heist on entering zone.
cfg.heistCooldown
Minutes before the next heist can start.
cfg.heistFinishDelay
Delay (s) after players leave before cooldown begins.
Search & Loot
cfg.searchDurations
Durations (s) to search lootboxes, med cabinets, guards, containers.
cfg.lootboxModel
/ cfg.lootboxes
Loot-crate object model and spawn locations.
cfg.medicineCabinets
Coordinates for medical-supply searches.
Security NPCs
cfg.guards.patrol
Array of patrol-route waypoints for foot guards.
cfg.skyliftAttachHelpSphere
Visual helper marker for helicopter attachment (toggle & opacity).
Container Mechanics
cfg.containers
Coordinates & rotations for each container target.
cfg.weldingSpeed
/ cfg.drillingSpeed
Base speeds for welding and drilling actions.
cfg.disableContainerDrilling
Toggle drill method on/off.
Tool Items & Offsets
cfg.items
Item names for C4, thermite, weld cutter and drill.
cfg.containerDrillOffsets
Drill head positions for mini-game.
cfg.containerAttachOffsets
Attachment models, positions and rotations for each tool.
Reward Display
cfg.containerRewardOffsets
Crate-spawn offsets by loot type (default, medicine, jewelry, etc.)
Action Timers
cfg.c4DetonationDuration
Seconds until C4 blast.
cfg.thermiteMeltDuration
Seconds for thermite to burn through.
UI Positioning
cfg.heistInfoPosition
On-screen corner for timer/guard info.
Download the Script from FiveM Keymaster
Visit the FiveM Keymaster site.
Log in with your account credentials.
Locate the Cargo Ship Heist, Cargo Ship Map (If you haven’t purchased the K4MB1-CARGOSHIP map) and Tools scripts in your Granted Assets section.
Download the script files from Keymaster.
Install and Configure ox_lib
Download the latest version of ox_lib from the official GitHub page.
Extract the
ox_lib
files to yourresources
folder.In your
server.cfg
, ensure thatox_lib
is started before the Cargo Ship Heist script by adding the following line:
Step 2: Add Script to Server Configuration
Edit server.cfg
server.cfg
Open the
server.cfg
file located in the root directory of your FiveM server.Add the following line to ensure the Cargo Ship Heist script starts with your server:
ensure ox_lib
ensure rm_tools
ensure rm_shipmap # (If you haven’t purchased the K4MB1-CARGOSHIP map)
ensure rm_shipheist
Last updated