Installation

Step 1: Download and Prepare Files

Configurable Settings

For detailed configuration, visit this page: DOCS.RAINMAD.COM

Category	Config Key	Description
	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 your resources folder.

• In your server.cfg, ensure that ox_lib is started before the Cargo Ship Heist script by adding the following line:

Step 2: Add Script to Server Configuration

Edit 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