Rocket Node Logo
HomeBlogHow To Install Cayo Perico In FiveM
How To Install Cayo Perico In FiveM
Published 7 min read

How To Install Cayo Perico In FiveM

RocketNode StaffRocketNode Staff

To make Cayo Perico available on a FiveM server, set the enforced game build to 2189 or a later supported build. Build 2189 is the DLC for The Cayo Perico Heist, and it can also be selected using the h4 alias. Later game builds include content from previous versions, so using a newer build is generally recommended.

This guide explains how to enable Cayo Perico, load its native island assets, and add optional custom resources such as bridges, teleport systems, and gameplay features.

Installing Cayo Perico on Your FiveM Server

You do not need to extract or manually download Cayo Perico files from the GTA Online client. Rockstar Games included the island assets in the official GTA V updates beginning with Game Build 2189.

To enable the island, you primarily need to enforce a compatible game build and activate the Cayo Perico landmass through a script or resource.

Installation & Activation Methods

There are several ways to enable Cayo Perico depending on your server setup.

1. Configure the Minimum Game Build

Open your server.cfg file and make sure your server is running Game Build 2189 or newer. A more recent build, such as 3095 or later, is recommended when compatible with your server resources.

# Enable native Cayo Perico support
sv_enforceGameBuild 3095

2. Enable the Island via Script

The native Cayo Perico island can be activated through an IPL loader or a dedicated resource such as bob74_ipl.

For QBCore, ESX, or custom frameworks, you can use FiveM native functions on the client side:

-- Enable the Cayo Perico landmass and minimap
Citizen.CreateThread(function()
    -- Load the Cayo Perico island
    Citizen.InvokeNative(0x9A9D1C542F02AC3F, "HeistIsland")

    -- Enable the tropical minimap and radar
    Citizen.InvokeNative(0x5E1460624D17B96C, true)
end)

3. Add Bridges or Custom Map Modifications

If you want players to drive directly between Los Santos and Cayo Perico, or you want to modify the island's boundaries, you can install a community-created map resource.

  1. Download a compatible resource, such as cayo_perico_bridge or another island travel resource.
  2. Place the resource inside your server's resources folder.
  3. Add it to your server.cfg:
ensure cayo_perico_bridge

Features Available on Cayo Perico

Once the native island is enabled, players can access many of its original locations and environmental features without requiring large external map files.

  • El Rubio's Compound: A high-security estate featuring security cameras, main gates, perimeter walls, and the underground vault.
  • Airstrip & Main Docks: Useful locations for aircraft, boats, deliveries, and custom missions.
  • Tropical Environment: Native vegetation, lighting, weather effects, and ambient sounds.
  • Hangar & Beach Party Area: The island's social and entertainment areas can be used for events, gatherings, and custom activities.

Technical Considerations & Troubleshooting

IssueCauseSolution
Missing water / Invisible oceanConflict with native ocean rendering.Use an updated minimap or island resource that includes the appropriate Cayo Perico water fixes.
Falling through the map / Transparent groundThe server is using an outdated game build below 2189.Update sv_enforceGameBuild to a supported version such as 2699 or 3095.
Texture loss in Los SantosKeeping both Los Santos and Cayo Perico loaded can increase client VRAM usage.Optimize streaming resources and avoid loading unnecessary assets. Check the client's Extended Texture Budget if textures disappear.

Adding Cayo Perico to Your FiveM Server

Cayo Perico can significantly expand a FiveM server by providing additional locations for roleplay, missions, heists, transportation, and custom activities.

Prerequisites

Before enabling the island, verify the following:

  • Game Build 2189 or Higher: Cayo Perico was introduced with DLC Build 2189, The Cayo Perico Heist. Build 3095 or newer is recommended when supported by your resources.
  • Updated FiveM Server Artifacts: Keep your server artifacts updated to ensure compatibility with current game builds, map systems, and scripts.

Step-by-Step Setup Guide

1. Enforce the Required Game Build

Open your server.cfg and add or update the following setting:

# Enable a GTA V game build with Cayo Perico support
sv_enforceGameBuild 3095

2. Enable the Island and Minimap

Create or edit a client-side script in a resource such as bob74_ipl, qb-mapdata, or your own custom resource:

Citizen.CreateThread(function()
    -- Enable Cayo Perico
    Citizen.InvokeNative(0x9A9D1C542F02AC3F, "HeistIsland")

    -- Enable the tropical map radar
    Citizen.InvokeNative(0x5E1460624D17B96C, true)

    -- Optional: Adjust ocean behavior around Cayo Perico
    SetDeepOceanScaler(0.0)
end)

3. Add Travel Systems

Because Cayo Perico is located southeast of Los Santos, your server may need a practical way for players to travel between the two locations.

Available options include:

  • Flight or Boat Travel: Allow players to fly or sail to the island naturally.
  • Bridge Add-ons: Install a custom bridge resource that connects Los Santos and Cayo Perico.
  • Teleport Points: Create travel points at LSIA, the docks, or other locations using QBCore, ESX, or custom interaction scripts.

Key Locations on Cayo Perico

LocationFeatures & Suggested Uses
El Rubio's CompoundHigh-security estate with an underground vault, CCTV cameras, garage, and helipads. Suitable for heists, raids, or faction bases.
The AirstripPaved runway with a hangar and control tower. Useful for flight jobs, smuggling missions, and aircraft spawning.
Beach Party ZoneOpen-air stage, DJ booth, bar, and beach area. Ideal for social events and nightlife activities.
Main Docks & North DocksIndustrial docks with warehouses and boat slips. Useful for smuggling, deliveries, and maritime missions.

⚠️ Performance & Optimization Tips

  • Avoid Texture Loss: Loading Los Santos and Cayo Perico simultaneously can increase VRAM usage.
  • Dynamic Loading: On larger servers, consider proximity-based systems that activate island resources only when players travel near Cayo Perico.
  • Streaming Budget: Players experiencing missing roads or textures should check their Extended Texture Budget and client graphics settings.

Setting Up a Cayo Perico Server

Creating a dedicated Cayo Perico server involves more than enabling the island. You can build an entire gameplay experience around the location by adding jobs, heists, transportation systems, illegal operations, faction territories, and custom events.

Whether Cayo Perico is the main setting of your server or an extension of an existing Los Santos economy using QBCore or ESX, the island provides many opportunities for custom gameplay.

1. Core Server & Resource Architecture

A basic resource structure could look like this:

FiveM Server Root/
├── server.cfg
└── resources/
    ├── [qb] or [esx]/          # Core roleplay framework
    ├── [maps]/
    │   └── cayo_perico_map/    # IPL loaders, minimap fixes & water patches
    ├── [scripts]/
    │   ├── cayo_heist/         # Custom heist & vault logic
    │   ├── cayo_teleports/     # Airport / boat travel
    │   └── cayo_drugs/         # Processing and gathering systems
    └── [vehicles]/             # Custom boats, aircraft & island vehicles

2. Server Configuration

Add the required resources to your server.cfg:

# Minimum GTA V DLC build
sv_enforceGameBuild 3095

# Maximum player clients
sv_maxclients 48

# Cayo Perico and supporting resources
ensure [maps]
ensure cayo_perico_ipl
ensure pma-voice

3. Essential Framework Features

Travel Infrastructure

Create transportation systems between Los Santos and Cayo Perico:

  • Airport / Ferry System: Add NPCs at LSIA or the docks that allow players to purchase tickets and travel to the island.
  • Custom Bridge: Install a compatible bridge resource for direct vehicle access.
  • Teleport Locations: Add interaction zones for fast travel using QBCore, ESX, or another framework.

Drug Operations & Faction Territories

The island's isolated areas can be used for high-risk roleplay activities:

  • Cocaine & Weed Farms: Create gathering and processing locations in suitable agricultural areas.
  • Cartel Territories: Use El Rubio's Compound or other secluded locations as faction-controlled areas.
  • Smuggling Routes: Connect the island's docks with Los Santos delivery missions.

Heist Scripts & Vault Mechanics

The Compound is particularly suitable for custom heist gameplay:

  • Add hackable keypads and locked doors.
  • Create thermite or cutting interactions.
  • Add guards with patrol routes around the compound.
  • Configure custom loot tables and primary targets.
  • Use the underground vault as the main objective.

Beach Party & Nightlife Mechanics

The beach area can become a social hub for your community:

  • Add DJ and music systems.
  • Create bars and shops.
  • Add custom clothing or beachwear stores.
  • Add jet ski and boat rental systems.
  • Host server-wide parties and special events.

Key Coordinates for Server Developers

These coordinates can be used when creating spawn points, teleport locations, or interaction zones. Always test them in-game because orientation and resource configurations may affect the final position.

LocationVector4 Coordinates (x, y, z, w)Best Use Case
Airstrip Runway4443.58, -4484.22, 4.23, 200.0Flight arrivals / aircraft spawning
El Rubio's Vault5006.7, -5756.2, 14.8, 145.0Heist vault objective
Main Docks4938.8, -5173.1, 2.4, 60.0Boat travel / smuggling deliveries
Beach Party Stage4869.2, -4930.5, 2.5, 300.0Social events / DJ booth

Performance Optimization Summary

💡 Server Optimization Rules

  • Water & Map Patches: Use compatible Cayo Perico resources to prevent water and map conflicts.
  • Entity Cleanup: Remove abandoned boats, aircraft, and other unused entities around the ocean between Los Santos and Cayo Perico.
  • Resource Management: Avoid loading unnecessary map and streaming resources when they are not required.
  • Client Performance: Remember that Cayo Perico can increase memory and VRAM usage, particularly on lower-end systems.

With the correct game build and resources, Cayo Perico can be integrated into FiveM without requiring players to download the original island assets separately. From simple exploration to complete heist, smuggling, faction, and roleplay systems, the island can serve as a valuable addition to almost any FiveM server.

RocketNode

Launch faster. Stay ahead.