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.
Table of Contents
Content
How to Enable Cayo Perico on FiveM Server
Total Time: 15 minutes
Step 1: Ensure Correct Server Build
Check Your Server Build
Make sure your server is running build 3324 or higher. You can check your current server build by running the version command in your server console.
Update Server Build
If necessary, update your server build to 3324 or higher. This is essential for enabling Cayo Perico.
Step 2: Modify Server Configuration
Open Server Configuration
Locate and open your server.cfg file. This file contains your server’s configuration settings.
Set Game Build
Add the following line to your server.cfg file:set sv_enforceGameBuild 2189
Alternatively, you can add this to your server launch parameters:+set sv_enforceGameBuild 2189
Step 3: Download the Cayo Perico Script
Download the Script – Download the HeistIsland_island_load.lua script from the GitHub repository:
Click here to download as .zip
Step 4: Add Script to Resources
Add Script to Resources
Place the downloaded HeistIsland_island_load.lua script into your server’s resources folder.
Step 5: Update Server Configuration
Add the following line to your server.cfg to ensure the script runs:ensure HeistIsland
Last Step: Restart Your Server
Just restart your FiveM 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:
Cayo Script Alternative
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.
[/fusion_builder_column][/fusion_builder_row][/fusion_builder_container]
