Skip to main content
Home
Shop
Free Mods
Tools
Bundles
Full Servers
  1. Home
  2. Blog
  3. Tutorials & Guides

How to Enable Cayo Perico on Your FiveM Server

Published on July 4, 2024·by Lars Miller(Founder & Lead Editor)·Credentials·2 min read·Updated on March 3, 2026
Tutorials & Guides

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...

How to Enable Cayo Perico on Your FiveM Server
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.

Content

  • Step 1: Ensure Correct Server Build
  • Step 2: Modify Server Configuration
  • Step 3: Download the Cayo Perico Script
  • Step 4: Add Script to Resources
  • Step 5: Update Server Configuration
  • Last Step: Restart Your Server

https://www.youtube.com/watch?v=xPAZv0kCH0E

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


Cayo Perico Script

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

Click here to download as .zip

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.

Related Premium HUD Scripts on FiveMX

  • Cayo Perico Heist
  • CayoPerico Resort+Bungalows
  • FiveM Cayo Perico (Premium) by UncleJust
  • Beach Club / Venice Beach (like Cayo Perico)

Related FiveM Guides & Tutorials

  • Enable Snow: Stunning Must-Have Best Guide
  • How to Enable DLCs for FiveM Server
  • Cayo Perico Bridge - FiveMX - Free FiveM MLOs | FiveMX
Previous Article

Code Redeem Script - FiveMX - Free FiveM Mods | FiveMX

Next Article

QBCore Framework - FiveM Frameworks | FiveMX

More on This Topic

FiveM Full Server Download: Complete Server Packs Explained (2026)How to Run a FiveM Server Using Docker: Complete Setup GuideBest QBOX Scripts 2026: Essential Resources for Your ServerFiveM Server Management: The Complete Guide from Setup to ScaleUltimate Drift Server Guide: Top Cars, Mods & Setups for FiveM

Turn framework research into a launch-ready script stack

Use this guide to narrow the framework decision, then move into the core commercial hubs for verified scripts, curated bundles, and a faster server launch path.

Framework hub

Browse QBCore-ready scripts

Move into the QBCore landing page to compare verified scripts, framework fit, and install-ready products built for modern FiveM servers.

Open QBCore hub

Framework hub

Review the ESX script path

Use the ESX landing page to compare framework-specific resources, launch guidance, and premium products that fit ESX-first servers.

Open ESX hub

Premium catalog

Browse premium FiveM scripts

Move from research into the main shop to compare real products, framework labels, screenshots, and production-ready quality signals.

Open premium shop

Launch faster

Compare curated bundles

Bundles shorten the path from planning to launch by grouping the highest-leverage scripts into a cleaner commercial starting point.

View bundles

Disclosure: Some links below are affiliate links to FiveMX products. We may earn a commission at no extra cost to you.

Related Articles

How to Enable DLCs for FiveM Server

How to Enable DLCs for FiveM Server

Enabling DLC (Downloadable Content) for your FiveM server allows you to offer players the latest maps, clothing, vehicles, and more. This guide will walk...

January 15, 2025
How to Enable Snow on Your FiveM Server

How to Enable Snow on Your FiveM Server

Turn your FiveM server into a sparkling winter wonderland in minutes—just drop a Lua script and let players toggle snowfall with /enablesnow and /disablesnow. Create, activate, and enjoy snowy skies a

February 5, 2024
How to Create a Logo for Your Gaming Server or Community (2026 Guide)

How to Create a Logo for Your Gaming Server or Community (2026 Guide)

Your server logo is the first thing a potential player sees — before they read your description, check your player count, or visit your Discord.

April 4, 2026
Secure CheckoutInstant AccessMoney-Back GuaranteeLifetime Updates
FiveMX

Premium FiveM scripts and mods for serious server owners.

Shop

  • Shop
  • QBCore Scripts
  • ESX Scripts
  • FiveM Scripts
  • Free Mods
  • Best Scripts & Mods

Help

  • About
  • FAQ
  • Support
  • Contact
  • Account
  • Affiliate Program

Legal

  • Privacy Policy
  • Terms of Service
  • Refund Policy
  • Cookie Policy
  • GDPR Compliance
  • DMCA
  • Imprint
  • Editorial Policy
© 2026 FiveMX. All rights reserved.·support@fivemx.com

FiveMX is not affiliated with Rockstar Games, Take-Two Interactive, or CFX.re. All trademarks are property of their respective owners.

Flash Sale — Up to 19% off!Flash Sale — 19% off!Shop Now