Home FiveM Installing Custom Maps on Your FiveM Server

Installing Custom Maps on Your FiveM Server

Last updated on Feb 13, 2025

In this tutorial, you'll learn how to install custom maps on your FiveM server using the Pterodactyl panel (VolticHost Game Panel). Custom maps can enhance your roleplay environment by introducing new locations, interiors, or entire custom worlds—giving your players fresh experiences and immersive environments. 🚀


📌 Prerequisites

  • A FiveM server purchased at VolticHost.com

  • Pre-installed FiveM with txAdmin, accessible via the VolticHost Game Panel

  • Basic knowledge of file management and server configuration

  • Custom map resource files (such as .ymt or other map files) downloaded from trusted sources


1️⃣ First Step - Preparing Your Custom Map Resource

  1. Download Custom Map Files:

    • Obtain your desired map files and any associated assets (like interior XMLs, textures, and models) from reputable websites or FiveM community forums.
  2. Organize Files in a Folder:

    • Create a folder (e.g., custom_maps) and ensure it includes all necessary files along with a resource manifest file (fxmanifest.lua or __resource.lua).
  3. Verify the Manifest:

    • Open or create your manifest file in the folder. A basic example for fxmanifest.lua might be:

      fx_version 'cerulean'
      game 'gta5'
      
      author 'YourName'
      description 'Custom Map Resource'
      version '1.0.0'
      
      files {
          'mapdata.ymt',
          'interiors.meta'
      }
      
      data_file 'INTERIOR_PROXY_ORDER_FILE' 'interiors.meta'
      data_file 'MAP_DATA_FILE' 'mapdata.ymt'
      
  4. Save Your Files:

    • Ensure all files and the manifest are properly saved and organized in the custom_maps folder.

Custom map resource prepared and organized successfully!


2️⃣ Next Step - Uploading the Map Resource via the Pterodactyl Panel

  1. Log in to the Panel:

  2. Navigate to the Resources Directory:

    • Go to the /resources/ directory, where all FiveM resources are stored.
  3. Upload Your Map Resource Folder:

    • Upload the custom_maps folder into the /resources/ directory.
  4. Verify the Upload:

    • Confirm that the folder and all files (including the manifest) are correctly uploaded.

Custom map resource uploaded successfully!


3️⃣ Next Step - Activating the Map Resource in server.cfg

  1. Open the server.cfg File:

    • In the File Manager, locate and open your server.cfg file in the root directory of your FiveM server.
  2. Add the Startup Command:

    • Insert the following line to start your map resource:

      start custom_maps
      
    • Ensure that this line is placed among other resource startup commands for proper load order.

  3. Save the Changes:

    • Save and close the server.cfg file.

server.cfg updated to activate the custom map resource!


4️⃣ Next Step - Restarting Your Server and Testing the Custom Map

  1. Restart Your Server:

    • Return to the txAdmin dashboard and click the Restart Server button to apply the changes.
  2. Monitor the Logs:

    • Watch the live console logs to ensure that the map resource loads without errors.
  3. Test In-Game:

    • Once the server is running, join your FiveM server and use an in-game map loader or teleport command (if provided) to visit the new custom map area.

    • Verify that the new map or interior appears correctly and functions as expected.

Custom map resource tested and functioning successfully!


🎉 Conclusion

You have now successfully installed custom maps on your FiveM server using the Pterodactyl (VolticHost Game) panel! By preparing your resource files, uploading them to the /resources/ directory, updating your server.cfg, and testing in-game, you can provide your players with fresh and immersive locations to explore. Enjoy enhancing your roleplay environment, and if you need further assistance, contact VolticHost Support. 🚀