> For the complete documentation index, see [llms.txt](https://docs.rainmad.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rainmad.com/resources/cayo-perico-heist-supports-unclejust-cayo-perico-map-and-more/configuration.md). # Configuration ## General Configuration ```lua Config.general = { -- Contact NPC that hands out the job -- startHeist = { model = "u_m_y_mani", coords = vector4(986.869, -2583.983, 10.418, 200.004), cooldown = 60, -- Minutes before the heist can be started again (server wide) }, -- Boats rented at the dock to reach the island -- rentVehicle = { vehicles = { { model = "dinghy", price = 100 }, }, spawnCoords = { vector4(974.634, -2684.911, 0.615, 210.642) } }, -- Cayo Perico itself -- island = { center = vector3(5015.721, -5104.542, 4.888), blip = { sprite = 836, color = 5, scale = 1.0, name = "Cayo Perico" }, -- Marked with a route once the heist starts spawnDistance = 1600.0, -- Guards spawn once a player gets this close objectDistance = 100.0, -- Loot spawns once a player gets this close to a location enableAlarm = true, -- Island alarm siren while the guards are alerted enableGuardBlips = true, -- Show guards on the map (needs the patrol intel) enableLootBlips = true, -- Show loot on the map lootBlip = { sprite = 1, color = 5, scale = 0.5, name = "Loot" }, }, } Config.heist = { -- Laptop that downloads the intel, each file unlocks map blips -- securityRoom = { laptopCoords = vector4(4427.746, -4451.851, 7.236, 198.604), requiredItem = "hack_usb", removeItemOnUse = false, duration = 60, -- Seconds the download takes blip = { sprite = 521, color = 3, scale = 1.0, name = "Security Room" }, }, -- Mansion break-in, the doors and the loot inside are in shared/mansion.lua -- mansion = { name = "Mansion", coords = vector3(5010.026, -5749.191, 32.852), blip = { sprite = 181, color = 5, scale = 1.0, name = "Mansion" }, entryBlip = { sprite = 66, color = 4, scale = 0.6, name = "Entry Point" }, -- Items needed to open each entry point -- entryTypes = { wall = { requiredItem = "hook", removeItemOnUse = false }, underwater = { requiredItem = "blowtorch", removeItemOnUse = false }, }, -- Lockpicking the inner doors -- doorItem = { requiredItem = "lockpick", removeItemOnUse = true }, doorLockpick = { strength = 0.5, -- Attempts are strength * pins difficulty = 2, -- 1 to 5 pins = 5, -- 3 to 9 }, -- Only used on the uj_cayoPerico map, the tunnel is blown open instead of a cutscene -- poolDoor = { requiredItem = "c4", removeItemOnUse = true }, }, -- Air for the underwater entry, given by a usable item -- rebreather = { item = "rebreather", duration = 120, -- Seconds of air per use }, -- Keys are hidden in one random safe every heist -- helicopter = { model = "maverick", coords = vector4(4890.902, -5735.670, 26.464, 160.973), blip = { sprite = 574, color = 5, scale = 0.6, name = "Helicopter" }, }, safeCrackDifficulty = 1, -- How many pins the safe minigame asks for -- Buyer that pays out the stolen goods, only the player who started the heist sees it -- finish = { enabled = true, coords = vector4(2478.250, 1588.430, 32.642, 317.509), cutscene = "HS4F_DRP_OFF", blip = { sprite = 108, color = 2, scale = 1.0, name = "Buyer" }, sellableItems = { { name = "pogo_statue", price = 45000 }, { name = "panther_statue", price = 60000 }, { name = "big_diamond", price = 55000 }, { name = "painting", price = 35000 }, { name = "gold_bar", price = 12000 }, { name = "rum_bottle", price = 8000 }, }, }, } ``` ### Heist Configuration ```lua if Config.framework.selectedMap ~= "none" then return end -- Break-in points on the mansion wall -- Config.heist.mansion.entries = { { name = "Wall", type = "wall", coords = vector3(5032.920, -5684.006, 19.877) }, { name = "Underwater", type = "underwater", coords = vector3(5043.556, -5814.987, -11.335) }, } -- Every lootable spot on the island -- Config.heist.locations = { { name = "West Garage", coords = vector3(4500.033, -4543.181, 4.049), blip = { sprite = 357, color = 4, scale = 1.0 }, objects = { { model = "ex_prop_crate_expl_sc", coords = vector4(4503.59, -4543.059, 3.152, 293.582), type = "weapon_crate", rewards = { { name = "WEAPON_PISTOL", amount = {min = 1, max = 2} }, { name = "WEAPON_SNSPISTOL", amount = {min = 1, max = 2} }, { name = "WEAPON_PUMPSHOTGUN", amount = {min = 1, max = 2} }, }, }, { model = "p_v_43_safe_s", coords = vector4(4506.291, -4551.193, 3.921, 293.608), type = "safecrack", rewards = { { name = "money", amount = {min = 1500, max = 2000} } }, }, { model = "h4_prop_h4_table_isl_01a", coords = vector4(4506.150, -4555.626, 3.153, 199.894), type = "weed_table", rewards = { { name = "weed", amount = {min = 7, max = 12} } }, }, { model = "h4_prop_h4_table_isl_01a", coords = vector4(4503.851, -4556.457, 3.153, 199.894), type = "weed_table", rewards = { { name = "weed", amount = {min = 7, max = 12} } }, }, } }, { name = "North Garage", coords = vector3(5067.771, -4598.776, 2.860), blip = { sprite = 357, color = 4, scale = 1.0 }, objects = { { model = "ex_prop_crate_expl_sc", coords = vector4(5059.3657226562, -4591.5639648438, 2.0268135070801, 344.64596557617), type = "weapon_crate", rewards = { { name = "WEAPON_PISTOL", amount = {min = 1, max = 2} }, { name = "WEAPON_SNSPISTOL", amount = {min = 1, max = 2} }, { name = "WEAPON_PUMPSHOTGUN", amount = {min = 1, max = 2} }, }, }, { model = "ex_prop_crate_expl_sc", coords = vector4(5057.0727539062, -4590.9248046875, 2.0288360118866, 347.7099609375), type = "weapon_crate", rewards = { { name = "WEAPON_PISTOL", amount = {min = 1, max = 2} }, { name = "WEAPON_SNSPISTOL", amount = {min = 1, max = 2} }, { name = "WEAPON_PUMPSHOTGUN", amount = {min = 1, max = 2} }, }, }, { model = "p_v_43_safe_s", coords = vector4(5062.1157226562, -4590.8002929688, 2.6243193149567, 71.308815002441), type = "safecrack", rewards = { { name = "money", amount = {min = 1500, max = 2000} } }, }, { model = "h4_prop_h4_table_isl_01a", coords = vector4(5064.662109375, -4589.5478515625, 1.8589220046997, 340.00003051758), type = "weed_table", rewards = { { name = "weed", amount = {min = 7, max = 12} } }, }, { model = "h4_prop_h4_table_isl_01a", coords = vector4(5067.583984375, -4590.6337890625, 1.8515620231628, 340.00003051758), type = "weed_table", rewards = { { name = "weed", amount = {min = 7, max = 12} } }, }, } }, { name = "South Garage", coords = vector3(4918.848, -5236.234, 2.522), blip = { sprite = 357, color = 4, scale = 1.0 }, objects = { { model = "ex_prop_crate_expl_sc", coords = vector4(4918.8046875, -5231.390625, 1.6466443538666, 304.63122558594), type = "weapon_crate", rewards = { { name = "WEAPON_PISTOL", amount = {min = 1, max = 2} }, { name = "WEAPON_SNSPISTOL", amount = {min = 1, max = 2} }, { name = "WEAPON_PUMPSHOTGUN", amount = {min = 1, max = 2} }, }, }, { model = "ex_prop_crate_expl_sc", coords = vector4(4916.5913085938, -5237.884765625, 1.6470268964767, 124.07266235352), type = "weapon_crate", rewards = { { name = "WEAPON_PISTOL", amount = {min = 1, max = 2} }, { name = "WEAPON_SNSPISTOL", amount = {min = 1, max = 2} }, { name = "WEAPON_PUMPSHOTGUN", amount = {min = 1, max = 2} }, }, }, { model = "p_v_43_safe_s", coords = vector4(4925.4716796875, -5240.2421875, 2.2736642360687, 306.11117553711), type = "safecrack", rewards = { { name = "money", amount = {min = 1500, max = 2000} } }, }, { model = "h4_prop_h4_table_isl_01a", coords = vector4(4926.4580078125, -5244.6723632812, 1.5189210176468, 214.89454650879), type = "weed_table", rewards = { { name = "weed", amount = {min = 7, max = 12} } }, }, { model = "h4_prop_h4_table_isl_01a", coords = vector4(4924.4521484375, -5246.0708007812, 1.5189210176468, 214.89454650879), type = "weed_table", rewards = { { name = "weed", amount = {min = 7, max = 12} } }, }, } }, { name = "Weed Lab", coords = vector3(5183.093, -5151.281, 3.548), blip = { sprite = 499, color = 2, scale = 1.0 }, objects = { { model = "h4_prop_h4_table_isl_01a", coords = vector4(5182.9096679688, -5145.8637695312, 2.5317163467407, 359.62808227539), type = "weed_table", rewards = { { name = "weed", amount = {min = 7, max = 12} } }, }, { model = "h4_prop_h4_table_isl_01a", coords = vector4(5181.5561523438, -5153.8471679688, 2.4754920005798, 175.4111328125), type = "weed_table", rewards = { { name = "weed", amount = {min = 7, max = 12} } }, }, } }, { name = "Cash Lab", coords = vector3(5091.013, -4682.666, 2.407), blip = { sprite = 500, color = 4, scale = 1.0 }, objects = { { model = "h4_prop_h4_table_isl_01a", coords = vector4(5092.5708007812, -4679.9208984375, 1.4090859889984, 345.00001525879), type = "cash_table", rewards = { { name = "money", amount = {min = 1000, max = 1500} } }, }, { model = "h4_prop_h4_table_isl_01a", coords = vector4(5093.3959960938, -4683.3330078125, 1.4090859889984, 254.999984741211), type = "cash_table", rewards = { { name = "money", amount = {min = 1000, max = 1500} } }, }, { model = "h4_prop_h4_table_isl_01a", coords = vector4(5090.9995117188, -4685.8759765625, 1.4090859889984, 165.00001525879), type = "cash_table", rewards = { { name = "money", amount = {min = 1000, max = 1500} } }, }, } }, { name = "East Coke Lab", coords = vector3(5193.936, -5134.691, 3.346), blip = { sprite = 499, color = 4, scale = 1.0 }, objects = { { model = "h4_prop_h4_table_isl_01a", coords = vector4(5196.8701171875, -5133.8969726562, 2.3416209220886, 257.39462280273), type = "coke_table", rewards = { { name = "coke", amount = {min = 5, max = 7} } }, }, { model = "h4_prop_h4_table_isl_01a", coords = vector4(5196.3359375, -5136.283203125, 2.3416209220886, 257.39462280273), type = "coke_table", rewards = { { name = "coke", amount = {min = 5, max = 7} } }, }, } }, { name = "West Coke Lab", coords = vector3(4961.658, -5108.674, 2.982), blip = { sprite = 499, color = 4, scale = 1.0 }, objects = { { model = "h4_prop_h4_table_isl_01a", coords = vector4(4959.6337890625, -5107.0395507812, 1.9696220159531, 65.49996948242), type = "coke_table", rewards = { { name = "coke", amount = {min = 5, max = 7} } }, }, { model = "h4_prop_h4_table_isl_01a", coords = vector4(4962.7265625, -5106.5786132812, 1.9696220159531, 335.49993896484), type = "coke_table", rewards = { { name = "coke", amount = {min = 5, max = 7} } }, }, { model = "h4_prop_h4_table_isl_01a", coords = vector4(4964.0703125, -5109.3095703125, 1.9696220159531, 245.49996948242), type = "coke_table", rewards = { { name = "coke", amount = {min = 5, max = 7} } }, }, } }, { name = "Weapon Lab", coords = vector3(5156.585, -5128.924, 2.327), blip = { sprite = 110, color = 4, scale = 1.0 }, objects = { { model = "ex_prop_crate_expl_sc", coords = vector4(5154.6118164062, -5126.193359375, 1.4107692241669, 87.163238525391), type = "weapon_crate", rewards = { { name = "WEAPON_PISTOL", amount = {min = 1, max = 2} }, { name = "WEAPON_SNSPISTOL", amount = {min = 1, max = 2} }, { name = "WEAPON_PUMPSHOTGUN", amount = {min = 1, max = 2} }, }, }, { model = "ex_prop_crate_expl_sc", coords = vector4(5154.6118164062, -5128.6508789062, 1.4168283939362, 97.715614318848), type = "weapon_crate", rewards = { { name = "WEAPON_PISTOL", amount = {min = 1, max = 2} }, { name = "WEAPON_SNSPISTOL", amount = {min = 1, max = 2} }, { name = "WEAPON_PUMPSHOTGUN", amount = {min = 1, max = 2} }, }, }, { model = "ex_prop_crate_expl_sc", coords = vector4(5155.0512695312, -5131.5239257812, 1.4188503026962, 106.79075622559), type = "weapon_crate", rewards = { { name = "WEAPON_PISTOL", amount = {min = 1, max = 2} }, { name = "WEAPON_SNSPISTOL", amount = {min = 1, max = 2} }, { name = "WEAPON_PUMPSHOTGUN", amount = {min = 1, max = 2} }, }, }, } }, } -- How sharp the guards are -- Config.guards = { viewDistance = 40.0, fieldOfView = 100.0, -- total vision cone in degrees shoutDelay = 1500, -- ms between spotting the player and opening fire accuracy = 45, } -- Guard routes, the first point of a route is also the spawn point -- Config.patrols = { vehicle = { { model = "technical", pedModel = "s_m_y_marine_01", weapon = "WEAPON_CARBINERIFLE", gunnerSeat = 1, speed = 15.0, route = { vector4(3933.713, -4698.632, 3.770, 291.5), vector4(4525.788, -4483.708, 3.758, 291.5), } }, { model = "technical", pedModel = "s_m_y_marine_01", weapon = "WEAPON_CARBINERIFLE", gunnerSeat = 1, speed = 15.0, route = { vector4(5168.360, -4708.590, 1.754, 10.1), vector4(4822.712, -4462.258, 8.217, 90.1), } }, { model = "technical", pedModel = "s_m_y_marine_01", weapon = "WEAPON_CARBINERIFLE", gunnerSeat = 1, speed = 15.0, route = { vector4(4980.141, -5585.491, 24.109, 2.3), vector4(5171.708, -5116.396, 2.538, 347.3), } }, { model = "technical", pedModel = "s_m_y_marine_01", weapon = "WEAPON_CARBINERIFLE", gunnerSeat = 1, speed = 15.0, route = { vector4(4955.667, -5617.405, 23.116, 58.8), vector4(4776.426, -5572.272, 23.221, 113.8), vector4(4767.523, -5732.962, 21.501, 218.8), vector4(4896.543, -5760.345, 25.676, 268.8), } }, { model = "technical", pedModel = "s_m_y_marine_01", weapon = "WEAPON_CARBINERIFLE", gunnerSeat = 1, speed = 15.0, route = { vector4(5535.330, -5242.400, 11.185, 68.7), vector4(5283.770, -5104.547, 13.284, 93.7), vector4(5226.406, -5230.449, 18.525, 183.7), vector4(5391.243, -5418.818, 44.003, 228.7), } }, }, soldier = { { model = "s_m_y_marine_01", weapon = "WEAPON_CARBINERIFLE", armor = 100, route = { vector4(4361.562, -4574.326, 13.276, 18.6), vector4(4370.389, -4571.342, 13.276, 328.6), vector4(4374.678, -4583.710, 13.276, 223.6), vector4(4365.823, -4586.975, 13.276, 118.6), } }, { model = "s_m_y_marine_01", weapon = "WEAPON_CARBINERIFLE", armor = 100, route = { } }, { model = "s_m_y_marine_01", weapon = "WEAPON_CARBINERIFLE", armor = 100, route = { vector4(4434.926, -4485.685, 4.280, 284.5), vector4(4464.292, -4475.073, 4.228, 284.5), vector4(4470.859, -4452.730, 4.024, 334.5), } }, { model = "s_m_y_marine_01", weapon = "WEAPON_CARBINERIFLE", armor = 100, route = { vector4(4519.576, -4646.900, 11.255, 184.0), vector4(4475.621, -4516.718, 4.054, 14.0), } }, { model = "s_m_y_marine_01", weapon = "WEAPON_CARBINERIFLE", armor = 100, route = { vector4(4509.228, -4506.504, 4.134, 16.5), vector4(4498.192, -4538.620, 4.161, 181.5), vector4(4530.314, -4529.167, 4.170, 246.5), } }, { model = "s_m_y_marine_01", weapon = "WEAPON_CARBINERIFLE", armor = 100, route = { vector4(4875.369, -4485.783, 26.939, 38.4), vector4(4879.954, -4486.302, 26.939, 293.4), vector4(4880.376, -4490.763, 26.939, 188.4), } }, { model = "s_m_y_marine_01", weapon = "WEAPON_CARBINERIFLE", armor = 100, route = { vector4(5150.661, -4629.072, 2.683, 250.4), vector4(5031.790, -4615.380, 3.662, 85.4), } }, { model = "s_m_y_marine_01", weapon = "WEAPON_CARBINERIFLE", armor = 100, route = { vector4(5094.282, -4655.645, 1.772, 258.4), vector4(5062.174, -4641.420, 2.599, 33.4), vector4(5094.117, -4698.235, 3.324, 218.4), } }, { model = "s_m_y_marine_01", weapon = "WEAPON_CARBINERIFLE", armor = 100, route = { vector4(5031.217, -4627.869, 21.690, 55.1), vector4(5029.920, -4632.407, 21.690, 140.1), vector4(5035.974, -4628.934, 21.690, 298.9), } }, { model = "s_m_y_marine_01", weapon = "WEAPON_CARBINERIFLE", armor = 100, route = { vector4(4961.335, -4832.152, 5.368, 349.2), vector4(4895.070, -4917.981, 3.368, 134.2), } }, { model = "s_m_y_marine_01", weapon = "WEAPON_CARBINERIFLE", armor = 100, route = { vector4(4998.897, -4930.499, 8.716, 278.0), vector4(4944.774, -4913.589, 3.816, 68.0), } }, { model = "s_m_y_marine_01", weapon = "WEAPON_CARBINERIFLE", armor = 100, route = { vector4(5156.232, -4933.863, 30.878, 282.3), vector4(5154.117, -4935.888, 30.878, 162.3), vector4(5150.819, -4933.361, 30.878, 72.3), } }, { model = "s_m_y_marine_01", weapon = "WEAPON_CARBINERIFLE", armor = 100, route = { vector4(5113.981, -5199.931, 2.367, 353.4), vector4(5114.950, -5109.519, 2.165, 353.4), } }, { model = "s_m_y_marine_01", weapon = "WEAPON_CARBINERIFLE", armor = 100, route = { vector4(5046.158, -5112.322, 22.950, 301.3), vector4(5041.446, -5112.318, 22.950, 51.3), vector4(5041.060, -5117.071, 22.950, 156.3), } }, { model = "s_m_y_marine_01", weapon = "WEAPON_CARBINERIFLE", armor = 100, route = { vector4(5150.956, -5050.974, 20.397, 319.8), vector4(5146.325, -5050.958, 20.397, 54.8), vector4(5145.944, -5055.306, 20.397, 139.8), } }, { model = "s_m_y_marine_01", weapon = "WEAPON_CARBINERIFLE", armor = 100, route = { vector4(5139.917, -5241.612, 26.297, 49.9), vector4(5143.059, -5241.675, 26.297, 304.9), vector4(5142.649, -5246.754, 26.297, 224.9), } }, { model = "s_m_y_marine_01", weapon = "WEAPON_CARBINERIFLE", armor = 100, route = { vector4(4949.574, -5108.613, 3.130, 51.0), vector4(5015.548, -5185.861, 2.519, 261.0), } }, { model = "s_m_y_marine_01", weapon = "WEAPON_CARBINERIFLE", armor = 100, route = { vector4(4856.727, -5168.764, 2.439, 100.6), vector4(4914.912, -5212.767, 2.458, 220.6), } }, { model = "s_m_y_marine_01", weapon = "WEAPON_CARBINERIFLE", armor = 100, route = { vector4(4884.995, -5454.689, 47.529, 60.9), vector4(4885.244, -5459.428, 47.529, 150.9), vector4(4889.750, -5459.472, 47.529, 255.9), } }, { model = "s_m_y_marine_01", weapon = "WEAPON_CARBINERIFLE", armor = 100, route = { vector4(5126.992, -5524.222, 70.975, 3.3), vector4(5128.163, -5527.301, 70.975, 258.3), vector4(5124.257, -5529.242, 70.975, 178.3), } }, { model = "s_m_y_marine_01", weapon = "WEAPON_CARBINERIFLE", armor = 100, route = { vector4(4981.656, -5871.769, 19.920, 209.9), vector4(4944.816, -5811.706, 21.806, 24.9), } }, { model = "s_m_y_marine_01", weapon = "WEAPON_CARBINERIFLE", armor = 100, route = { } }, { model = "s_m_y_marine_01", weapon = "WEAPON_CARBINERIFLE", armor = 100, route = { vector4(4969.448, -5604.479, 23.675, 316.1), vector4(4975.690, -5608.421, 23.753, 316.1), } }, { model = "s_m_y_marine_01", weapon = "WEAPON_CARBINERIFLE", armor = 100, route = { vector4(4974.936, -5702.551, 19.887, 42.9), vector4(5096.334, -5729.500, 15.774, 232.9), } }, { model = "s_m_y_marine_01", weapon = "WEAPON_CARBINERIFLE", armor = 100, route = { vector4(5404.971, -5190.195, 32.194, 216.2), vector4(5328.935, -5241.113, 32.511, 121.2), } }, { model = "s_m_y_marine_01", weapon = "WEAPON_CARBINERIFLE", armor = 100, route = { vector4(5468.180, -5238.313, 43.967, 229.0), vector4(5467.741, -5234.801, 43.967, 334.0), vector4(5463.482, -5238.795, 43.967, 159.0), } }, { model = "s_m_y_marine_01", weapon = "WEAPON_CARBINERIFLE", armor = 100, route = { vector4(5561.606, -5234.647, 14.157, 75.2), vector4(5602.114, -5223.716, 14.168, 285.2), vector4(5570.328, -5193.553, 11.937, 15.2), } }, { model = "s_m_y_marine_01", weapon = "WEAPON_CARBINERIFLE", armor = 100, route = { vector4(5312.212, -5181.975, 30.129, 47.3), vector4(5345.258, -5214.641, 31.178, 227.3), } }, { model = "s_m_y_marine_01", weapon = "WEAPON_CARBINERIFLE", armor = 100, route = { vector4(5094.208, -5749.065, 15.677, 220.5), vector4(5060.186, -5790.081, 11.477, 220.5), } }, { model = "s_m_y_marine_01", weapon = "WEAPON_CARBINERIFLE", armor = 100, route = { vector4(5015.714, -5810.960, 17.478, 216.9), vector4(5043.253, -5793.389, 17.476, 216.9), } }, { model = "s_m_y_marine_01", weapon = "WEAPON_CARBINERIFLE", armor = 100, route = { vector4(4992.111, -5719.908, 19.880, 51.5), vector4(4971.861, -5792.457, 20.878, 141.5), vector4(4998.825, -5797.182, 20.878, 296.5), vector4(4988.656, -5775.726, 17.075, 321.5), vector4(5019.405, -5763.642, 16.278, 321.5), vector4(5022.534, -5728.364, 17.683, 311.5), } }, { model = "s_m_y_marine_01", weapon = "WEAPON_CARBINERIFLE", armor = 100, route = { vector4(5040.543, -5700.114, 19.878, 214.9), vector4(5071.227, -5739.325, 15.877, 229.9), } }, { model = "s_m_y_marine_01", weapon = "WEAPON_CARBINERIFLE", armor = 100, route = { vector4(5022.498, -5712.382, 19.877, 210.0), vector4(5015.814, -5719.702, 20.077, 210.0), vector4(5016.229, -5722.383, 17.686, 330.0), vector4(5033.686, -5724.093, 17.682, 305.0), vector4(5049.429, -5738.792, 17.078, 225.0), } }, }, } ```