> For the complete documentation index, see [llms.txt](https://rex-studio.gitbook.io/rex-studio-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://rex-studio.gitbook.io/rex-studio-docs/mapping/cayo-perico.md).

# Cayo Perico

<figure><img src="/files/Yq1QakVoEZ9F0LvjsHpp" alt=""><figcaption></figcaption></figure>

## If you purchased **Cayo Pack** or **Guantacayo** and players cannot see Cayo Perico, this guide will fix it

If you bought **Cayo Pack**, **Guantacayo**, or any MLOs located on Cayo Perico and some players cannot see the island, fall into the void, or have missing collisions/objects, then their **Cayo Perico IPLs are not enabled**.\
This guide explains exactly how to fix it for everyone.

***

### 1. Understanding the issue

Your MLOs are located on Cayo Perico, but some players:

* Don’t see the island
* Fall into the water or void
* Have missing collisions or objects

This happens because **the Cayo Perico IPLs are not loaded client-side**.\
To fix this, your server must:

1. Force the correct GTA game build (Cayo Perico DLC)
2. Start a Cayo Perico IPL resource server-side\
   (for example, the one from the official Cfx topic)

Once done, players don’t need to install anything manually.

***

### 2. Requirements

Before starting, ensure:

1. **Your server build is recent enough**\
   Run in server console:

   ```txt
   version
   ```

   Should be **3324 or higher**.
2. **Game build is set to Cayo Perico (2189) or higher**\
   Cayo Perico = build **2189 (mpheist4 / h4)**.
3. You have a **Cayo Perico IPL resource**, e.g.:\
   [https://forum.cfx.re/t/the-cayo-perico-island-available-for-fivem/1897446](https://forum.cfx.re/t/the-cayo-perico-island-available-for-fivem/1897446?utm_source=chatgpt.com)
4. You can also download it here : [CayoIPL](https://rex-studio.com/RexStudio/cayoipl/ipls_resource.zip)

***

### 3. Step 1 – Enforce the Cayo Perico game build

Add this to your `server.cfg`:

```cfg
set sv_enforceGameBuild 2189
```

Or in start arguments:

```bash
+set sv_enforceGameBuild 2189
```

***

### 4. Step 2 – Install the Cayo Perico IPL resource

Download the IPL resource from the Cfx topic. It includes:

* `fxmanifest.lua`
* Script loading the Cayo IPLs

Place it here:

```
resources/[maps]/cayo_perico_ipl
```

Then in `server.cfg`:

```cfg
ensure cayo_perico_ipl
```

***

### 5. Step 3 – Start order with your Tebex MLOs

Make sure the IPL loads **before** your MLOs.

```cfg
# Game build
set sv_enforceGameBuild 2189

# Cayo island IPLs
ensure cayo_perico_ipl

# Your Tebex Cayo MLOs
ensure tebex_cayo_pack
ensure guantacayo
```

***

### 6. Step 4 – Test in-game

Restart your server and join.

Teleport to Cayo Perico:

```lua
teleport 4840.571 -5174.425 2.0
```

Check:

* Island visible
* Collisions working
* Interiors loading correctly

Repeat with another player to confirm consistency.

***

### 7. Troubleshooting

If some players **still** don’t see Cayo:

#### 7.1 They must rejoin after enabling the game build

Cayo only loads correctly after:

* A full server restart
* The player reconnects

#### 7.2 Confirm the IPL resource is running

```txt
restart cayo_perico_ipl
```

#### 7.3 Check FiveM updates for players

Ask them to fully close FiveM and reopen it.

#### 7.4 Conflicts with other map mods

Disable other map resources if necessary and test with only:

```cfg
ensure cayo_perico_ipl
ensure tebex_cayo_pack
ensure guantacayo
```

***

### 8. Optional – Dynamic loading (advanced)

Some scripts dynamically enable/disable the island depending on player distance.\
For stability, strongly recommended setup for Cayo MLOs:

* Force game build 2189
* Always keep the IPL resource running

***

### 9. Summary

To make Cayo Pack, Guantacayo, and other Cayo MLOs work for all players:

1. Set `sv_enforceGameBuild 2189`
2. Install and `ensure` the Cayo Perico IPL resource
3. Start it **before** your MLOs
4. Restart the server and have players reconnect

Once done, all players will see the island correctly and your Cayo interiors will load without issues.