{"id":146063,"date":"2024-07-04T12:08:07","date_gmt":"2024-07-04T10:08:07","guid":{"rendered":"https:\/\/hifivem.com\/?p=146063"},"modified":"2026-06-24T17:40:32","modified_gmt":"2026-06-24T15:40:32","slug":"how-to-enable-cayo-perico-fivem","status":"publish","type":"post","link":"https:\/\/fivemx.com\/pl\/how-to-enable-cayo-perico-fivem\/","title":{"rendered":"How to Enable Cayo Perico on Your FiveM Server"},"content":{"rendered":"<p class=\"wp-block-paragraph\">Enabling Cayo Perico in your FiveM server can enhance the gameplay experience by adding a new island for your players to explore. Here\u2019s a simple, step-by-step guide to get Cayo Perico up and running on your server.<\/p>\n\n\n\n<div class=\"wp-block-rank-math-toc-block\" id=\"rank-math-toc\"><h2>Zawarto\u015b\u0107<\/h2><nav><ul><li class=\"\"><a href=\"#howto-step-1720087440566\">Step 1: Ensure Correct Server Build<\/a><\/li><li class=\"\"><a href=\"#howto-step-1720087534647\">Step 2: Modify Server Configuration<\/a><\/li><li class=\"\"><a href=\"#howto-step-1720087569233\">Step 3: Download the Cayo Perico Script<\/a><\/li><li class=\"\"><a href=\"#howto-step-1720087586844\">Step 4: Add Script to Resources<\/a><\/li><li class=\"\"><a href=\"#howto-step-1720087610255\">Step 5: Update Server Configuration<\/a><\/li><li class=\"\"><a href=\"#howto-step-1720087624023\">Last Step: Restart Your Server<\/a><\/li><\/ul><\/nav><\/div>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<figure class=\"wp-block-embed is-type-video is-provider-youtube wp-block-embed-youtube wp-embed-aspect-16-9 wp-has-aspect-ratio\"><div class=\"wp-block-embed__wrapper\">\n<iframe loading=\"lazy\" title=\"How to install Cayo Perico to your FiveM Server.\" width=\"1290\" height=\"726\" src=\"https:\/\/www.youtube.com\/embed\/xPAZv0kCH0E?feature=oembed\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share\" referrerpolicy=\"strict-origin-when-cross-origin\" allowfullscreen><\/iframe>\n<\/div><\/figure>\n\n\n<div id=\"rank-math-howto\" class=\"rank-math-block\" >\n<div class=\"rank-math-howto-description\">\n\n<p>How to Enable Cayo Perico on FiveM Server<\/p>\n\n<\/div>\n<p class=\"rank-math-howto-duration\"><strong>\u0141\u0105czny czas:<\/strong> <span>15 minut\/y<\/span><\/p>\n<div class=\"rank-math-steps\">\n<div id=\"howto-step-1720087440566\" class=\"rank-math-step\">\n<h3 class=\"rank-math-step-title\">Step 1: Ensure Correct Server Build<\/h3>\n<div class=\"rank-math-step-content\"><p>u003cstrongu003eCheck Your Server Buildu003c\/strongu003eu003cbru003eMake sure your server is running build 3324 or higher. You can check your current server build by running the u003ccodeu003eversionu003c\/codeu003e command in your server console.u003cbru003eu003cstrongu003eUpdate Server Buildu003c\/strongu003eu003cbru003eIf necessary, u003ca href=u0022https:\/\/runtime.fivem.net\/artifacts\/fivem\/build_server_windows\/master\/u0022 target=u0022_blanku0022 rel=u0022noreferrer noopeneru0022u003eupdate your server build to 3324 or higheru003c\/au003e. This is essential for enabling Cayo Perico.<\/p>\n<\/div>\n<\/div>\n<div id=\"howto-step-1720087534647\" class=\"rank-math-step\">\n<h3 class=\"rank-math-step-title\">Step 2: Modify Server Configuration<\/h3>\n<div class=\"rank-math-step-content\"><p>u003cstrongu003eOpen Server Configurationu003c\/strongu003eu003cbru003eLocate and open your u003ccodeu003eserver.cfgu003c\/codeu003e file. This file contains your server\u2019s configuration settings.u003cbru003eu003cbru003eu003cstrongu003eSet Game Buildu003c\/strongu003eu003cbru003eAdd the following line to your u003ccodeu003eserver.cfgu003c\/codeu003e file:u003cbru003eu003ccodeu003eset sv_enforceGameBuild 2189u003c\/codeu003eu003cbru003eAlternatively, you can add this to your server launch parameters:u003cbru003eu003ccodeu003e+set sv_enforceGameBuild 2189u003c\/codeu003e<\/p>\n<\/div>\n<\/div>\n<div id=\"howto-step-1720087569233\" class=\"rank-math-step\">\n<h3 class=\"rank-math-step-title\">Step 3: Download the Cayo Perico Script<\/h3>\n<div class=\"rank-math-step-content\"><p>u003cstrongu003eDownload the Scriptu003c\/strongu003e &#8211; Download the u003ccodeu003eHeistIsland_island_load.luau003c\/codeu003e script from the u003ca href=u0022https:\/\/github.com\/bdebruyn02\/HeistIslandu0022 target=u0022_blanku0022 rel=u0022noreferrer noopeneru0022u003eGitHub repositoryu003c\/au003e:u003cbru003eu003ca href=u0022https:\/\/github.com\/bdebruyn02\/HeistIsland\/archive\/refs\/heads\/main.zipu0022 target=u0022_blanku0022 rel=u0022noreferrer noopeneru0022u003eClick here to download as .zipu003c\/au003e<\/p>\n<\/div>\n<\/div>\n<div id=\"howto-step-1720087586844\" class=\"rank-math-step\">\n<h3 class=\"rank-math-step-title\">Step 4: u003cstrongu003eAdd Script to Resourcesu003c\/strongu003e<\/h3>\n<div class=\"rank-math-step-content\"><p>u003cstrongu003eAdd Script to Resourcesu003c\/strongu003eu003cbru003eu003cbru003ePlace the downloaded u003ccodeu003eHeistIsland_island_load.luau003c\/codeu003e script into your server&#8217;s resources folder.<\/p>\n<\/div>\n<\/div>\n<div id=\"howto-step-1720087610255\" class=\"rank-math-step\">\n<h3 class=\"rank-math-step-title\">Step 5: u003cstrongu003eUpdate Server Configurationu003c\/strongu003e<\/h3>\n<div class=\"rank-math-step-content\"><p>Add the following line to your u003ccodeu003eserver.cfgu003c\/codeu003e to ensure the script runs:u003cbru003eu003ccodeu003eensure HeistIslandu003c\/codeu003e<\/p>\n<\/div>\n<\/div>\n<div id=\"howto-step-1720087624023\" class=\"rank-math-step\">\n<h3 class=\"rank-math-step-title\">u003cstrongu003eLast Step: Restart Your Serveru003c\/strongu003e<\/h3>\n<div class=\"rank-math-step-content\"><p>Just restart your FiveM server<\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n\n<p class=\"rank-math-howto-supply\"><strong>Supply:<\/strong> <ul><li>FiveM Server Build 3324 or Higher &#8211; Ensure your FiveM server is running the required build.nServer Configuration File (server.cfg) &#8211; The configuration file where you will add the necessary settings.nAccess to Server Files &#8211; You need the necessary permissions to modify server files and upload new scripts.<\/li><\/ul><\/p>\n<p class=\"rank-math-howto-tools\"><strong>Narz\u0119dzia:<\/strong> <ul><li>Text Editor &#8211; For editing the server configuration files (server.cfg). Examples include Notepad++, Sublime Text, or Visual Studio Code.nFTP Client &#8211; For uploading files to your server if it\u2019s hosted remotely. Examples include FileZilla or WinSCP.nServer Console Access &#8211; To run commands and restart the server.<\/li><\/ul><\/p>\n<p class=\"rank-math-howto-tools\"><strong>Materials:<\/strong> <span>HeistIsland Script &#8211; The HeistIsland_island_load.lua script that enables Cayo Perico on your server. This can be downloaded from the GitHub repository.<\/span><\/p>\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"cayo-perico-script\">Cayo Perico Script<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Download the Script<\/strong> &#8211; Download the <code>HeistIsland_island_load.lua<\/code> script from the <a href=\"https:\/\/github.com\/bdebruyn02\/HeistIsland\" target=\"_blank\" rel=\"noreferrer noopener\">repozytorium GitHub<\/a>:<\/p>\n\n\n\n<div class=\"wp-block-buttons is-layout-flex wp-block-buttons-is-layout-flex\">\n<div class=\"wp-block-button is-style-outline is-style-outline--1\"><a class=\"wp-block-button__link wp-element-button\" href=\"https:\/\/codeload.github.com\/bdebruyn02\/HeistIsland\/zip\/refs\/heads\/main\" target=\"_blank\" rel=\"noreferrer noopener\">Click here to download as .zip<\/a><\/div>\n<\/div>\n\n\n\n<details class=\"wp-block-details is-layout-flow wp-block-details-is-layout-flow\"><summary>Cayo Script Alternative<\/summary>\n<pre class=\"wp-block-code\"><code>local islandVec = vector3(4840.571, -5174.425, 2.0)\nCitizen.CreateThread(function()\n    while true do\n\tlocal pCoords = GetEntityCoords(GetPlayerPed(-1))\t\t\n\t\tlocal distance1 = #(pCoords - islandVec)\n\t\tif distance1 &lt; 2000.0 then\n\t\tCitizen.InvokeNative(\"0x9A9D1BA639675CF1\", \"HeistIsland\", true)  -- load the map and removes the city\n\t\tCitizen.InvokeNative(\"0x5E1460624D194A38\", true) -- load the minimap\/pause map and removes the city minimap\/pause map\n\t\telse\n\t\tCitizen.InvokeNative(\"0x9A9D1BA639675CF1\", \"HeistIsland\", false)\n\t\tCitizen.InvokeNative(\"0x5E1460624D194A38\", false)\n\t\tend\n\tCitizen.Wait(5000)\n    end\nend)<\/code><\/pre>\n<\/details>\n\n\n\n<p class=\"wp-block-paragraph\">By following these steps, you should have Cayo Perico enabled on your FiveM server, providing your players with a new and exciting area to explore.<\/p>\n\n\n<!-- fivemx-quality-enrichment-v2 -->\n<h2>Practical checklist<\/h2><p>Use this guide as a staging checklist before changing a live FiveM server. Confirm the current server artifact version, framework version, resource dependencies, database changes, and any client-side files before you apply the change.<\/p><ul><li>Back up the affected configuration files and database tables.<\/li><li>Apply the change on a test server first.<\/li><li>Watch the server console and client F8 console for errors.<\/li><li>Check whether the change affects jobs, inventory, vehicles, maps, voice, permissions, or player data.<\/li><li>Document the exact file, command, or setting you changed so it can be reverted quickly.<\/li><\/ul><h2>Testing before production<\/h2><p>After the first test, join with a normal player account and repeat the flow from the player perspective. If the topic involves performance, measure before and after with the same player count, route, and resource set. If it involves admin tools or permissions, verify both allowed and denied users.<\/p><h2>Common mistakes<\/h2><p>Most FiveM issues come from missing dependencies, stale cache, wrong folder names, framework mismatch, or configuration copied from another server. Avoid changing multiple systems at once; make one change, test it, and then continue.<\/p><h2>Related resources<\/h2><p>For production-ready assets, compare paid resources in the <a href=\"https:\/\/fivemx.com\/pl\/sklep\/\">FiveMX shop<\/a>. For free resources, browse <a href=\"https:\/\/fivemx.com\/pl\/free-fivem-scripts\/\">free FiveM scripts<\/a> and test each resource before using it publicly.<\/p>\n\n<!-- fivemx-quality-depth-v3 -->\n<h2>Production rollout notes<\/h2><p>Before using this guidance on a live FiveM server, define the exact outcome you expect from the change. For How to Enable Cayo Perico on Your FiveM Server, that means checking which resource, setting, command, or workflow is affected and confirming that the change fits your current framework, artifact version, and server rules. Keep the rollout small enough that you can reverse it quickly if players report errors.<\/p><p>Use a staging server with the same framework, database schema, resource order, and key dependencies as production. If the topic changes gameplay, permissions, visuals, voice, vehicles, maps, inventory, or economy behavior, test with at least one admin account and one normal player account. Watch server console output, client F8 logs, and resource timing while repeating the exact player flow that will happen on the live server.<\/p><h2>Rollback checklist<\/h2><ul><li>Save the previous configuration file, resource folder, and database state before changing anything.<\/li><li>Record the resource version, commit, download page, or setting value you tested.<\/li><li>Restart only the affected resource first when possible, then restart the full server if dependencies require it.<\/li><li>If errors appear, revert the single changed resource or setting before testing another fix.<\/li><\/ul><h2>Maintenance guidance<\/h2><p>Review this setup again after FiveM artifact updates, framework updates, or major resource changes. A configuration that works today can break after dependency updates, renamed exports, changed events, or database migrations. Keep notes with your server documentation so future admins understand what was changed, why it was changed, and how to verify it again.<\/p>\n\n<!-- fivemx-quality-depth-v4 -->\n<h2>Ongoing review<\/h2><p>Recheck How to Enable Cayo Perico on Your FiveM Server after major FiveM artifact updates, framework changes, or resource migrations. Confirm that the advice still matches current server behavior, that any linked source remains available, and that installation steps still match the files a server owner will actually download or configure.<\/p><p>For public servers, keep a short changelog beside your server documentation. Note what was tested, what changed, which accounts were used for verification, and how to roll back. This makes future maintenance faster and prevents old setup notes from becoming unclear or unsafe for players.<\/p>","protected":false},"excerpt":{"rendered":"<p>Enabling Cayo Perico in your FiveM server can enhance the gameplay experience by adding a new island for your players to explore. Here\u2019s a simple, step-by-step guide to get Cayo Perico up and running on your server. Cayo Perico Script Download the Script &#8211; Download the HeistIsland_island_load.lua script from the GitHub repository: By following these [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":146065,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1899],"tags":[],"class_list":["post-146063","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-tutorials"],"blocksy_meta":[],"_links":{"self":[{"href":"https:\/\/fivemx.com\/pl\/wp-json\/wp\/v2\/posts\/146063","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/fivemx.com\/pl\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/fivemx.com\/pl\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/fivemx.com\/pl\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/fivemx.com\/pl\/wp-json\/wp\/v2\/comments?post=146063"}],"version-history":[{"count":1,"href":"https:\/\/fivemx.com\/pl\/wp-json\/wp\/v2\/posts\/146063\/revisions"}],"predecessor-version":[{"id":208538,"href":"https:\/\/fivemx.com\/pl\/wp-json\/wp\/v2\/posts\/146063\/revisions\/208538"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/fivemx.com\/pl\/wp-json\/wp\/v2\/media\/146065"}],"wp:attachment":[{"href":"https:\/\/fivemx.com\/pl\/wp-json\/wp\/v2\/media?parent=146063"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/fivemx.com\/pl\/wp-json\/wp\/v2\/categories?post=146063"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/fivemx.com\/pl\/wp-json\/wp\/v2\/tags?post=146063"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}