How to Enable Cayo Perico on Your FiveM Server

Enabling Cayo Perico in your FiveM server can enhance the gameplay experience by adding a new island for your players to explore. Here’s a simple, step-by-step guide to get Cayo Perico up and running on your server.

Supply:

• FiveM Server Build 3324 or Higher – Ensure your FiveM server is running the required build.
• Server Configuration File (server.cfg) – The configuration file where you will add the necessary settings.
• Access to Server Files – You need the necessary permissions to modify server files and upload new scripts.

Tools:

• Text Editor – For editing the server configuration files (server.cfg). Examples include Notepad++, Sublime Text, or Visual Studio Code.
• FTP Client – For uploading files to your server if it’s hosted remotely. Examples include FileZilla or WinSCP.
• Server Console Access – To run commands and restart the server.

Materials: HeistIsland Script – The HeistIsland_island_load.lua script that enables Cayo Perico on your server. This can be downloaded from the GitHub repository.

Cayo Perico Script

Download the Script – Download the HeistIsland_island_load.lua script from the GitHub repository:

local islandVec = vector3(4840.571, -5174.425, 2.0)
Citizen.CreateThread(function()
    while true do
	local pCoords = GetEntityCoords(GetPlayerPed(-1))		
		local distance1 = #(pCoords - islandVec)
		if distance1 < 2000.0 then
		Citizen.InvokeNative("0x9A9D1BA639675CF1", "HeistIsland", true)  -- load the map and removes the city
		Citizen.InvokeNative("0x5E1460624D194A38", true) -- load the minimap/pause map and removes the city minimap/pause map
		else
		Citizen.InvokeNative("0x9A9D1BA639675CF1", "HeistIsland", false)
		Citizen.InvokeNative("0x5E1460624D194A38", false)
		end
	Citizen.Wait(5000)
    end
end)

By following these steps, you should have Cayo Perico enabled on your FiveM server, providing your players with a new and exciting area to explore.