Cayo Perico Loader - Ultimate Edition. Lightweight, Customizable, Upgraded
Download: Direct
Source Code: Github
Images
Yet another Cayo Perico loader… but with some improvements. Most loaders I’ve seen are horrendously unoptimized and lack ease of customization. We solve all of these problems, along with many other improvements.
Features
- Cayo Perico loaded via IPL calls, no unnecessary streamed assets.
- Customizable map sections (see “Config” section below)
- Compatible with LS-Removed and Extra-Map-Tiles.
- Toggleable airstrip hangar door and mansion gates.
- Removed invisible collisions on the hills and in the party area.
- Removed prologue snow effects.
- Fixed hangar HD LOD disappearing.
- Dynamic wave and path node toggling between calm water in Cayo and waves in Los Santos.
- Fixed the water clipping through Cayo Perico in some areas.
- Compatible with any framework (ESX, QB, etc.)
- Compatible with the Rockstar Editor.
- No bloatware ymaps/props/peds/vehicles.
Note: If you were running LS-Removed along with a streamed version of Cayo Perico, I encourage you to update to the newest version of LS-Removed that allows loading DLC IPLs and use a Cayo Perico IPL loader, such as this one.
Config
config = {}
-- Misc options
config.disable_prologue_snow = true -- true = disable snow from North Yankton, false = enable snow
config.disable_emitters = true -- true = disable arena wars emitters, false = enable emitters; set this to false if other scripts interact with emitters
config.peds = false -- true = peds will spawn on the island, false = no peds will spawn
config.ambient_zone = true -- true = enable ambient zones (birds, insects, etc), false = disable ambient zones
config.disable_radio = false -- true = disable car radio when on Cayo Perico, false = enable car radio on Cayo Perico
-- Map options
config.vault_entity_set = 'pink_diamond_set' -- options: 'panther_set', 'pearl_necklace_set', 'pink_diamond_set', nil (disables the entity set)
config.hangar_open = true -- true = hangar door open; false = hangar door closed
config.gate_open = true -- true = mansion gate open; false = mansion gate closed
config.underwater_gate_closed = false -- true = underwater gate closed; false = underwater gate open
config.sea_mines = false -- true = enable sea mines, false = disable sea mines
config.shark = true -- true = enable dead shark, false = disable dead shark
config.whale = true -- true = enable beached whale, false = disable beached whale
config.drug_plants = false -- true = enable drug plants, false = disable drug plants; set to false for better performance in the dock area
-- Minimap options
--[[
[*] If you use anything else than 'compact', I highly encourage you to use the Extra Map Tiles resource (link below).
It has much better performance, and has better and easier customizability options.
https://forum.cfx.re/t/release-extra-map-tiles-v2-add-extra-textured-tiles-on-the-pause-menu-map-and-minimap-new-and-revamped-version
]]
config.minimap_type = 'off' -- options: 'compact', 'scaleform', 'off'
config.dynamic_path_nodes = true -- true = dynamically enable/disable GPS path nodes when entering/exiting Cayo Perico, false = no GPS path nodes on Cayo Perico
-- true = dynamically load custom water when entering/exiting Cayo Perico, false = default water on Cayo Perico;
-- setting dynamic_water to false will not apply the Cayo Perico water textures
config.dynamic_water = true
config.dynamic_waves = true -- true = dynamically change wave intensity when entering/exiting Cayo Perico, false = default wave intensity on and off Cayo Perico
config.dynamic_waves_scaler = 1.0 -- wave scaler values when the player is not near Cayo Perico, only used if dynamic_waves is true
-- if dynamic_water is set to false, these values will only be applied once, when the resource starts, without running the infinite loop.
-- if dynamic_water is set to true, these have no effect; set dynamic_water to nil to completely ignore water configuration when the resource starts.
config.static_water_type = 0 -- water type used if dynamic_water is false (0 = default LS water, 1 = Cayo Perico water); setting to 1 will makes water clip in areas of LS
config.static_waves_scaler = 0.0 -- global wave scaler value, used if dynamic_waves is false (1.0 = default wave intensity, 0.0 = no waves)
config.dynamic_actions_delay = 3000 -- delay in ms for updating path nodes state and wave scaler; 3000 should be perfectly fine
Using this with LS-Removed:
- In
cayo-perico-ultimate, setconfig.dynamic_water = false. - In
ls-removed, setconfig.custom_water_name = 'ls_cayo_water'.
Known Limitations
- Hot reloading might lead to game crashes when using this resource with LS-Removed.
Performance
This resource basically takes up no CPU cycles, having in most cases 0.00ms. If you are running the scaleform minimap, expect the process time to go up to 0.01-0.02ms, but I strongly discourage using the Scaleform map, as stated in the config.
Support and bug-reporting
If you require any help, have found a bug with this resource, or have a feature request, either leave a reply in this thread, in my forum PMs or Discord DMs. I read and reply to everything. As always, feedback is very much appreciated.
My other resources
Carrier Operations - Working aircraft carrier mechanics.
Los Santos Removed - Empty game map.
Vehicle Helmets - Wear hats and helmets inside vehicles.
| Code is accessible | Yes |
| Subscription-based | No |
| Lines (approximately) | 200 |
| Requirements | Build 2189+ |
| Support | Yes |
