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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://rex-studio.gitbook.io/rex-studio-docs/mapping/cayo-perico.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.