A Simple Cayo Perico Loader 2.0 (BIG UPDATE)
3,053
44
3,053
44
Description
this mod loads the Online Cayo Perico island to singleplayer.
Experience the island like it's 2020 again!
this mod has a menu, press F7 to open it
Requirements
LemonUI, specifically SHVDN3 (https://www.gta5-mods.com/tools/lemonui)
ScriptHookV
ScriptHookVDotNet (Newest version)
Installation
drag islandhopper.dll to (yourgta5folder)/scripts and then open up the menu with F7. press on Load Cayo Perico and you will be teleported to the airstrip.
Troubleshooting
in some cases music will not work, you can just disable it and enable it again
MMS Heist music don't work? make sure you have toggled HEI4_FIN_START_STA first
found a bug? tell me in the comments or add me on discord - willijem213
Notes
The online peds and car spawns aren't spawning by default with this mod, i have other mods that load the peds and the car spawns
all screenshots are not from online and are from the mod
The menu structure is actually
Load Cayo Perico
Unload Cayo Perico
Vehicle Spawner
Options
Settings
Dynamic Music System
Manual Music System (Heist)
Manual Music System (Gather Intel)
Manual Music System (Heist Preps)
Manual Music System (Extra)
HEI4 Cutscenes
i forgot to add Vehicle Spawner in the readme structure, sorry about that
Over the cutscene viewer, for some cutscene descriptions it will say "Cayo Perico required" so you don't float over the sea during these cutscenes. For some that don't require it you can keep the island loaded cause Los Santos will still be loaded i guess if you are close enough
Credits
Rockstar Games
if you are reusing this mod, please credit me!
Updates
1.1
Added the option to toggle the Beach Party Music.
1.2
Removed the option to toggle the aircraft carrier (too buggy, and the interior wouldn't load)
Fixed grass not appearing on the island
changed the black screens a little when teleporting
unloading cayo perico teleports you to the Los Santos International Airport
(because this mod enables MP maps to avoid aborting, some mansions in los santos may fail to load)
changed the option "Beach Party" to "Beach Party Props"
1.3
added an option to toggle the Cayo Perico Heist music and disable it (dynamic)
1.4
quick bug fix for the beach party music not playing
and added a checkbox to the enable beach party props and the beach music
1.5
improved the dynamic music system to be more like Online
1.6
attempted a crash fix when loading/unloading the island
removed some unused code (could increase some performance)
removed black screens, teleporting will take a little time
improved the dynamic music system again
1.7
quick bug fixes and changes to the music (changed the order so some parts would play)
should be the last music update
1.8
music fixes
2.0 (CURRENT)
redid the menu
added Vehicle spawner - type the name of a car model and it will spawn infront of you
Added 8 submenus:
Options - 18 options to toggle, you can easily make the island feel like it's Online, or however you want
Settings - is mostly for persistency but there are interesting options in the submenu aswell
Dynamic Music System - the music you hear from Cayo Perico, gather intel, heist prep and the heist are all here recreated to singleplayer! Heist V2 is the version from 1.3, more scripted than V1, and V1 is for freemode. Gather intel right now is probably the most unstable one for it's detections in the island
Manual Music System Heist, Gather intel, Heist prep and extras - you can play the Cayo Perico music yourself with the music events! For some to work you will need a toggle first, for example in Heist you need to toggle "HEI4_FIN_START_STA" first before you can trigger anything else in that menu (They are different submenus, not in one submenu)
HEI4 Cutscenes - just cutscenes from the cayo perico heist update, some cutscenes will display a description if the island is required so you don't float over the sea
-
General improvements to the island
added a readme
an ini file will be created if you mess around with the menu
this mod loads the Online Cayo Perico island to singleplayer.
Experience the island like it's 2020 again!
this mod has a menu, press F7 to open it
Requirements
LemonUI, specifically SHVDN3 (https://www.gta5-mods.com/tools/lemonui)
ScriptHookV
ScriptHookVDotNet (Newest version)
Installation
drag islandhopper.dll to (yourgta5folder)/scripts and then open up the menu with F7. press on Load Cayo Perico and you will be teleported to the airstrip.
Troubleshooting
in some cases music will not work, you can just disable it and enable it again
MMS Heist music don't work? make sure you have toggled HEI4_FIN_START_STA first
found a bug? tell me in the comments or add me on discord - willijem213
Notes
The online peds and car spawns aren't spawning by default with this mod, i have other mods that load the peds and the car spawns
all screenshots are not from online and are from the mod
The menu structure is actually
Load Cayo Perico
Unload Cayo Perico
Vehicle Spawner
Options
Settings
Dynamic Music System
Manual Music System (Heist)
Manual Music System (Gather Intel)
Manual Music System (Heist Preps)
Manual Music System (Extra)
HEI4 Cutscenes
i forgot to add Vehicle Spawner in the readme structure, sorry about that
Over the cutscene viewer, for some cutscene descriptions it will say "Cayo Perico required" so you don't float over the sea during these cutscenes. For some that don't require it you can keep the island loaded cause Los Santos will still be loaded i guess if you are close enough
Credits
Rockstar Games
if you are reusing this mod, please credit me!
Updates
1.1
Added the option to toggle the Beach Party Music.
1.2
Removed the option to toggle the aircraft carrier (too buggy, and the interior wouldn't load)
Fixed grass not appearing on the island
changed the black screens a little when teleporting
unloading cayo perico teleports you to the Los Santos International Airport
(because this mod enables MP maps to avoid aborting, some mansions in los santos may fail to load)
changed the option "Beach Party" to "Beach Party Props"
1.3
added an option to toggle the Cayo Perico Heist music and disable it (dynamic)
1.4
quick bug fix for the beach party music not playing
and added a checkbox to the enable beach party props and the beach music
1.5
improved the dynamic music system to be more like Online
1.6
attempted a crash fix when loading/unloading the island
removed some unused code (could increase some performance)
removed black screens, teleporting will take a little time
improved the dynamic music system again
1.7
quick bug fixes and changes to the music (changed the order so some parts would play)
should be the last music update
1.8
music fixes
2.0 (CURRENT)
redid the menu
added Vehicle spawner - type the name of a car model and it will spawn infront of you
Added 8 submenus:
Options - 18 options to toggle, you can easily make the island feel like it's Online, or however you want
Settings - is mostly for persistency but there are interesting options in the submenu aswell
Dynamic Music System - the music you hear from Cayo Perico, gather intel, heist prep and the heist are all here recreated to singleplayer! Heist V2 is the version from 1.3, more scripted than V1, and V1 is for freemode. Gather intel right now is probably the most unstable one for it's detections in the island
Manual Music System Heist, Gather intel, Heist prep and extras - you can play the Cayo Perico music yourself with the music events! For some to work you will need a toggle first, for example in Heist you need to toggle "HEI4_FIN_START_STA" first before you can trigger anything else in that menu (They are different submenus, not in one submenu)
HEI4 Cutscenes - just cutscenes from the cayo perico heist update, some cutscenes will display a description if the island is required so you don't float over the sea
-
General improvements to the island
added a readme
an ini file will be created if you mess around with the menu
First Uploaded: May 25, 2026
Last Updated: 8 days ago
Last Downloaded: 1 hour ago
All Versions
24 Comments
More mods by Guy321:
Description
this mod loads the Online Cayo Perico island to singleplayer.
Experience the island like it's 2020 again!
this mod has a menu, press F7 to open it
Requirements
LemonUI, specifically SHVDN3 (https://www.gta5-mods.com/tools/lemonui)
ScriptHookV
ScriptHookVDotNet (Newest version)
Installation
drag islandhopper.dll to (yourgta5folder)/scripts and then open up the menu with F7. press on Load Cayo Perico and you will be teleported to the airstrip.
Troubleshooting
in some cases music will not work, you can just disable it and enable it again
MMS Heist music don't work? make sure you have toggled HEI4_FIN_START_STA first
found a bug? tell me in the comments or add me on discord - willijem213
Notes
The online peds and car spawns aren't spawning by default with this mod, i have other mods that load the peds and the car spawns
all screenshots are not from online and are from the mod
The menu structure is actually
Load Cayo Perico
Unload Cayo Perico
Vehicle Spawner
Options
Settings
Dynamic Music System
Manual Music System (Heist)
Manual Music System (Gather Intel)
Manual Music System (Heist Preps)
Manual Music System (Extra)
HEI4 Cutscenes
i forgot to add Vehicle Spawner in the readme structure, sorry about that
Over the cutscene viewer, for some cutscene descriptions it will say "Cayo Perico required" so you don't float over the sea during these cutscenes. For some that don't require it you can keep the island loaded cause Los Santos will still be loaded i guess if you are close enough
Credits
Rockstar Games
if you are reusing this mod, please credit me!
Updates
1.1
Added the option to toggle the Beach Party Music.
1.2
Removed the option to toggle the aircraft carrier (too buggy, and the interior wouldn't load)
Fixed grass not appearing on the island
changed the black screens a little when teleporting
unloading cayo perico teleports you to the Los Santos International Airport
(because this mod enables MP maps to avoid aborting, some mansions in los santos may fail to load)
changed the option "Beach Party" to "Beach Party Props"
1.3
added an option to toggle the Cayo Perico Heist music and disable it (dynamic)
1.4
quick bug fix for the beach party music not playing
and added a checkbox to the enable beach party props and the beach music
1.5
improved the dynamic music system to be more like Online
1.6
attempted a crash fix when loading/unloading the island
removed some unused code (could increase some performance)
removed black screens, teleporting will take a little time
improved the dynamic music system again
1.7
quick bug fixes and changes to the music (changed the order so some parts would play)
should be the last music update
1.8
music fixes
2.0 (CURRENT)
redid the menu
added Vehicle spawner - type the name of a car model and it will spawn infront of you
Added 8 submenus:
Options - 18 options to toggle, you can easily make the island feel like it's Online, or however you want
Settings - is mostly for persistency but there are interesting options in the submenu aswell
Dynamic Music System - the music you hear from Cayo Perico, gather intel, heist prep and the heist are all here recreated to singleplayer! Heist V2 is the version from 1.3, more scripted than V1, and V1 is for freemode. Gather intel right now is probably the most unstable one for it's detections in the island
Manual Music System Heist, Gather intel, Heist prep and extras - you can play the Cayo Perico music yourself with the music events! For some to work you will need a toggle first, for example in Heist you need to toggle "HEI4_FIN_START_STA" first before you can trigger anything else in that menu (They are different submenus, not in one submenu)
HEI4 Cutscenes - just cutscenes from the cayo perico heist update, some cutscenes will display a description if the island is required so you don't float over the sea
-
General improvements to the island
added a readme
an ini file will be created if you mess around with the menu
this mod loads the Online Cayo Perico island to singleplayer.
Experience the island like it's 2020 again!
this mod has a menu, press F7 to open it
Requirements
LemonUI, specifically SHVDN3 (https://www.gta5-mods.com/tools/lemonui)
ScriptHookV
ScriptHookVDotNet (Newest version)
Installation
drag islandhopper.dll to (yourgta5folder)/scripts and then open up the menu with F7. press on Load Cayo Perico and you will be teleported to the airstrip.
Troubleshooting
in some cases music will not work, you can just disable it and enable it again
MMS Heist music don't work? make sure you have toggled HEI4_FIN_START_STA first
found a bug? tell me in the comments or add me on discord - willijem213
Notes
The online peds and car spawns aren't spawning by default with this mod, i have other mods that load the peds and the car spawns
all screenshots are not from online and are from the mod
The menu structure is actually
Load Cayo Perico
Unload Cayo Perico
Vehicle Spawner
Options
Settings
Dynamic Music System
Manual Music System (Heist)
Manual Music System (Gather Intel)
Manual Music System (Heist Preps)
Manual Music System (Extra)
HEI4 Cutscenes
i forgot to add Vehicle Spawner in the readme structure, sorry about that
Over the cutscene viewer, for some cutscene descriptions it will say "Cayo Perico required" so you don't float over the sea during these cutscenes. For some that don't require it you can keep the island loaded cause Los Santos will still be loaded i guess if you are close enough
Credits
Rockstar Games
if you are reusing this mod, please credit me!
Updates
1.1
Added the option to toggle the Beach Party Music.
1.2
Removed the option to toggle the aircraft carrier (too buggy, and the interior wouldn't load)
Fixed grass not appearing on the island
changed the black screens a little when teleporting
unloading cayo perico teleports you to the Los Santos International Airport
(because this mod enables MP maps to avoid aborting, some mansions in los santos may fail to load)
changed the option "Beach Party" to "Beach Party Props"
1.3
added an option to toggle the Cayo Perico Heist music and disable it (dynamic)
1.4
quick bug fix for the beach party music not playing
and added a checkbox to the enable beach party props and the beach music
1.5
improved the dynamic music system to be more like Online
1.6
attempted a crash fix when loading/unloading the island
removed some unused code (could increase some performance)
removed black screens, teleporting will take a little time
improved the dynamic music system again
1.7
quick bug fixes and changes to the music (changed the order so some parts would play)
should be the last music update
1.8
music fixes
2.0 (CURRENT)
redid the menu
added Vehicle spawner - type the name of a car model and it will spawn infront of you
Added 8 submenus:
Options - 18 options to toggle, you can easily make the island feel like it's Online, or however you want
Settings - is mostly for persistency but there are interesting options in the submenu aswell
Dynamic Music System - the music you hear from Cayo Perico, gather intel, heist prep and the heist are all here recreated to singleplayer! Heist V2 is the version from 1.3, more scripted than V1, and V1 is for freemode. Gather intel right now is probably the most unstable one for it's detections in the island
Manual Music System Heist, Gather intel, Heist prep and extras - you can play the Cayo Perico music yourself with the music events! For some to work you will need a toggle first, for example in Heist you need to toggle "HEI4_FIN_START_STA" first before you can trigger anything else in that menu (They are different submenus, not in one submenu)
HEI4 Cutscenes - just cutscenes from the cayo perico heist update, some cutscenes will display a description if the island is required so you don't float over the sea
-
General improvements to the island
added a readme
an ini file will be created if you mess around with the menu
First Uploaded: May 25, 2026
Last Updated: 8 days ago
Last Downloaded: 1 hour ago
5mods on Discord
@nj5050 no，Unless you extract it separately as SP DLC
@JoyLucien Thanks!
love the idea! to solve the problem missing texture when Enable MP Maps, any Solution? i love Cayo but always get tex disapear in Los Santos ( or somewhere i dunno). anycase to get MP Maps Enable when teleport to Cayo, and option to disable when go back to original maps?
@khanh123002 hmm mp maps aren't meant to be just enabled and disabled, so just switching them on and off randomly would cause some textures to not load
@Guy321 Sadly, my Legacy always crash when MP Maps on, and Enhanced have texture loss. But ur mod work like a charm in lastest Update, well done bro!
@khanh123002 thanks :)
Is it possible to all police on the island?
@Daz999 sorry, but not really tho if you want i can try to make a setting sometime to enable the cops on the island
so i mostly loaded the island like rockstar did, that's why no cops appear
@Guy321 Will this automatically load up or do we have to use the menu everytime?
@Starfox1993 you will need to use the menu
@Guy321 Ok thank you.
@Starfox1993 no problem
First of all, thank you for your great work on the Simple Cayo Perico Loader mod. I've been using it and really enjoy it.
I have a suggestion for a future update. Would it be possible to release a version of this mod as a traditional Add-On DLC pack? Currently, the mod loads the island via a script menu (F7). I'm thinking of an installation method like this:
Place a folder (e.g., cayoperico) into mods/update/x64/dlcpacks/
Add a line to dlclist.xml (located at mods/update/update.rpf/common/data/), like: <Item>dlcpacks:/cayoperico/</Item>
This way, the island would load automatically with the game, just like other map mods. It would always be there, which might be more convenient for some users compared to loading it via a menu each time.
I understand this might require a different approach to packaging the mod. I just wanted to share this idea in case it's something you'd consider.
Thanks again for your work and for sharing it with the community!
@Ziran-1011 a new big update is pushing out soon that can maybe solve this however if what you want is for cayo perico to be loaded when the game starts up then i can definently try to do it, thanks for your suggestion
@Guy321 Thanks for getting back. I appreciate the offer, but I can't really help with anything on my side – no logs, no testing data. So feel free to do whatever you think is best. Don’t go out of your way for me. Thanks anyway!
@Guy321 https://www.gta5-mods.com/tools/script-hook-v-net-enhanced I'm using it, but there is no response when I press F7
@shana173 this mod is for legacy only
@Guy321 I am a legacy user. Since there are many scripts that don't work in the nightly version, I have been using Script Hook V .Net Enhanced Version [Legacy + Enhanced Version] 1.1.0.6. The simple Cayo Perico Loader worked well up to version 1.8, but I am asking this question because it has become unresponsive since version 2.0
@shana173 ah, you need to update to the latest legacy shvdn version, 2.0 uses the newest version