Guide to Adding Mappings on FiveM Server

Access your Wisp panel: https://panel.verycloud.fr/

Complete documentation: https://verycloud.fr/docs

What is a Mapping?

A mapping (or map) is a modification of the game environment that allows you to add:

• Custom buildings
• Modifications to existing locations
• New interiors
• Objects and decorations
• Custom zones

Prerequisites

Before starting, make sure you have:

• Access to your VeryCloud Wisp panel
• Your login credentials
• The mapping you want to install (.zip format or folder)
• An FTP client (FileZilla recommended) or use Wisp file manager
• Your FiveM server stopped during installation

Step 1: Connecting to Wisp Panel

1. Go to https://panel.verycloud.fr/
2. Log in with your VeryCloud credentials
3. Select your FiveM server from the list
4. You arrive at your server dashboard

Step 2: Types of FiveM Mappings

There are several types of mappings:

Standalone Mappings (recommended)

Required files:

• __resource.lua or fxmanifest.lua
• stream/ folder containing .ymap, .ytyp, .ybn files
• Sometimes a data/ folder with .meta files

MLO Mappings (Interior)

For interiors:

• .ymap files for structure
• .ytyp files for objects
• .ybn files for collisions
• stream/ folder

Add-On Mappings

More complex:

• Sometimes require server.cfg modifications
• May include scripts
• Files in stream/ and specific configurations

Step 3: Mapping Preparation

Content Verification

Before installation, verify your mapping contains:

1. Manifest file (required):
   • __resource.lua (old version)
   • OR fxmanifest.lua (new recommended version)
2. Stream folder (required):
   • Contains .ymap, .ytyp, .ybn, .ytd, .ydr files
3. Recommended structure:

mapping-name/
├── fxmanifest.lua
├── stream/
│   ├── file1.ymap
│   ├── file2.ytyp
│   └── file3.ybn
└── data/ (optional)
    └── file.meta

Example fxmanifest.lua

If your mapping doesn't have a manifest, create one:

fx_version 'cerulean'
game 'gta5'

author 'Your Name'
description 'Mapping description'
version '1.0.0'

this_is_a_map 'yes'

files {
    'data/*.meta'
}

data_file 'DLC_ITYP_REQUEST' 'data/*.ytyp'

For a simple mapping without data files:

fx_version 'cerulean'
game 'gta5'

author 'Your Name'
description 'Mapping description'
version '1.0.0'

this_is_a_map 'yes'

Step 4: Method 1 - Upload via Wisp File Manager

Access to File Manager

1. In your Wisp panel, click on Files in the left menu
2. You'll see your FiveM server tree
3. Navigate to the resources folder

Uploading the Mapping

1. In the resources folder, click on Upload (top right)
2. Two options are available:

Option A: Upload a ZIP file

• Select your mapping .zip file
• Click Upload
• Wait for the upload to complete (progress bar)
• Once uploaded, right-click on the .zip file
• Select Unarchive (Extract)
• The folder will be extracted automatically
• Delete the .zip file after extraction

Option B: Upload folder by folder

• Create a new folder with your mapping name
• Enter this folder
• Upload files one by one (manifest, then stream folder)

Structure Verification

Make sure the final structure is:

resources/
└── [your-mapping]/
    ├── fxmanifest.lua
    └── stream/
        ├── files.ymap
        └── other files...

Step 5: Method 2 - Upload via FTP

FTP Client Configuration

1. Download FileZilla: https://filezilla-project.org/
2. In Wisp panel, go to Settings > SFTP Details
3. Note the information:
   • Address: SFTP server URL
   • Port: Usually 2022
   • Username: Your SFTP username
   • Password: Your SFTP password

FTP Connection

1. Open FileZilla
2. Fill in the fields at the top:
   • Host: SFTP address (e.g., sftp://panel.verycloud.fr)
   • Username: Your username
   • Password: Your password
   • Port: 2022
3. Click Quickconnect
4. If a certificate alert appears, check "Always trust" and confirm

Uploading Mapping via FTP

1. In FileZilla, on the server side (right), navigate to the resources folder
2. On the local side (left), locate your mapping folder
3. Drag the complete mapping folder from left to right
4. Wait for the transfer to complete (progress bar at bottom)
5. Verify all files are present on the server side

Step 6: Activating Mapping in server.cfg

Access to server.cfg File

Via Wisp panel:

1. In the left menu, click on Files
2. Locate and click on the server.cfg file
3. The file opens in the integrated editor

Adding the Resource

1. Scroll to the resources section (usually at the bottom of the file)
2. Add the following line:

ensure mapping-name

Example:

# Mappings
ensure my-custom-garage
ensure luxury-villa
ensure lspd-station

Note: Replace mapping-name with the exact folder name in resources/

Difference between ensure and start

• ensure: Starts the resource and automatically restarts it if it crashes (recommended)
• start: Starts the resource only once

For mappings, always use ensure.

Loading Order

Important: The order of resources in server.cfg can be important.

Recommendations:

1. Load base resources first (framework, scripts)
2. Then mappings
3. Then scripts that depend on mappings

Example of correct order:

# Framework
ensure es_extended
ensure esx_skin

# Mappings
ensure mapping-police-station
ensure mapping-hospital

# Scripts
ensure esx_policejob
ensure esx_ambulancejob

Step 7: Starting the Server

Via Wisp Panel

1. Return to Console in the left menu
2. Click the Start button
3. Wait for the server to fully start
4. Monitor the console to verify resource loading

Loading Verification

In the console, you should see:

Started resource mapping-name

If you see an error, read the message carefully to identify the problem.

Step 8: In-Game Verification

Connecting to the Server

1. Launch FiveM
2. Connect to your server
3. Go to the mapping coordinates

Using Teleportation

If you're admin, use the teleport command:

/tp X Y Z

Replace X, Y, Z with mapping coordinates (usually indicated in description).

Visual Verification

Check that:

• Buildings appear correctly
• Textures are loaded
• Collisions work (you don't walk through walls)
• Doors open if applicable
• Interior is accessible

Step 9: Common Problem Management

Mapping Doesn't Appear

Solutions:

1. Check the manifest:
   • Make sure fxmanifest.lua or __resource.lua exists
   • Check the line this_is_a_map 'yes'
2. Check the stream folder:
   • The folder must be named exactly stream
   • Files must be directly in stream/, not in a subfolder
3. Check server.cfg:
   • The line ensure mapping-name is present
   • The name exactly matches the folder name
   • No syntax errors (# for comments)
4. Check permissions:
   • In Wisp panel, verify files have correct permissions
5. Restart the server:
   • Stop the server completely
   • Wait 10 seconds
   • Restart

Mapping Appears but with Missing Textures

Solutions:

1. Check .ytd files:
   • These files contain textures
   • Must be in the stream/ folder
2. FiveM cache:
   • Close FiveM completely
   • Go to %localappdata%\FiveM\FiveM Application Data
   • Delete the cache folder
   • Restart FiveM
3. Corrupted files:
   • Re-download the mapping
   • Re-upload all files

Server Won't Start After Adding Mapping

Solutions:

1. Check console:
   • Read error messages carefully
   • Search for the mapping name in errors
2. Manifest error:
   • Check fxmanifest.lua syntax
   • No special characters
   • Correct quotes
3. Conflict with other resources:
   • Temporarily disable other mappings
   • Test one by one to identify conflict
4. Disk space:
   • Check that you have enough space
   • Wisp panel > Settings > Storage

Collisions Don't Work

Solutions:

1. Missing .ybn files:
   • These files define collisions
   • Must be in stream/
2. Client cache:
   • Clear FiveM cache (see above)
3. Incompatible mapping:
   • Some old mappings don't have collisions
   • Search for an updated version

"Failed to start resource" Error

Solutions:

1. Incorrect folder name:
   • No spaces in name
   • No special characters
   • Use dashes - or underscores _
2. Incorrect structure:
   • Verify manifest is at folder root
   • The stream/ folder is in the right place
3. File permissions:
   • Via Wisp, check permissions
   • They must be read/write

Step 10: Mapping Optimization

Limit Number of Mappings

• Too many mappings = reduced performance
• Recommended maximum: 20-30 medium mappings
• Prioritize quality over quantity

Texture Compression

Some mappings have very heavy textures:

• Use tools like OpenIV to optimize
• Reduce resolution if possible

Priority Order

In server.cfg, load with priority:

1. Essential mappings (police station, hospital)
2. Important RP mappings
3. Decorative mappings last

Streaming Distance

In some manifests, you can define loading distance:

fx_version 'cerulean'
game 'gta5'

this_is_a_map 'yes'

distance 500.0  -- Distance in meters

Reduce this value to improve performance.

Step 11: Removing a Mapping

Via Wisp Panel

1. Go to Files > resources
2. Locate the mapping folder to delete
3. Right-click on the folder
4. Select Delete
5. Confirm deletion

Removing from server.cfg

1. Open the server.cfg file
2. Find the line ensure mapping-name
3. Delete this line or comment it with #:

# ensure mapping-to-delete

4. Save the file
5. Restart the server

Step 12: Creating a Custom Manifest

If your mapping doesn't have a manifest, create one:

For a Simple Mapping

1. In the mapping folder, create a new file
2. Name it fxmanifest.lua
3. Add this content:

fx_version 'cerulean'
game 'gta5'

author 'YourName'
description 'Mapping description'
version '1.0.0'

this_is_a_map 'yes'

For a Mapping with .meta Files

If your mapping has a data/ folder with .meta files:

fx_version 'cerulean'
game 'gta5'

author 'YourName'
description 'Mapping description'
version '1.0.0'

this_is_a_map 'yes'

files {
    'data/*.meta'
}

-- For ytyp files
data_file 'DLC_ITYP_REQUEST' 'data/*.ytyp'

-- For ymf files (if present)
data_file 'TIMECYCLEMOD_FILE' 'data/*.ymf'

Saving the Manifest

1. Save the file
2. Upload it via Wisp panel or FTP
3. Restart the server

Step 13: MLO Mappings (Interiors)

MLOs are special interior mappings.

Typical MLO Structure

mlo-interior/
├── fxmanifest.lua
└── stream/
    ├── interior.ymap
    ├── interior.ytyp
    ├── interior_shell.ybn
    └── textures.ytd

Manifest for MLO

fx_version 'cerulean'
game 'gta5'

this_is_a_map 'yes'

files {
    'stream/*.ytyp'
}

data_file 'DLC_ITYP_REQUEST' 'stream/*.ytyp'

Entry Points

Some MLOs require scripts to define entry points:

• Check the MLO documentation
• Install provided scripts if necessary

Step 14: Coordination with Other Resources

Scripts Dependent on Mappings

Some scripts require specific mappings:

• esx_policejob → LSPD Police Station
• esx_ambulancejob → Pillbox Hospital
• esx_mechanicjob → Bennys Garage

Coordinate Configuration

After installing a mapping, update coordinates in your scripts:

Example for a garage:

-- Script config
Config.Zones = {
    GarageVehicle = {
        Pos   = {x = 215.124, y = -810.057, z = 30.731},
        Size  = {x = 1.5, y = 1.5, z = 1.0},
        Type  = 27
    }
}

Loading Order

In server.cfg, make sure to:

1. Load the mapping first
2. Load the script that uses it afterwards

ensure mapping-police-station
ensure esx_policejob

Step 15: Mapping Sources

Recommended Sites

Free:

• GTA5-Mods: https://www.gta5-mods.com/maps
• FiveM Forums: https://forum.cfx.re/
• GTA Modding Discord: Search for dedicated servers

Paid:

• Tebex: https://www.tebex.io/
• GTA5mods Premium: Higher quality mappings

Quality Verification

Before installing a mapping:

• Read comments and reviews
• Check the update date
• Make sure it's FiveM compatible
• Watch videos/screenshots

Rights and Licenses

• Respect creators' licenses
• Don't redistribute without permission
• Credit authors on your server

Step 16: Backing Up Your Mappings

Backup via Wisp Panel

1. Go to Files > resources
2. Select the mapping folder
3. Click on Archive
4. The .tar.gz file will be created
5. Download it to your PC

Backup via FTP

1. Connect with FileZilla
2. Navigate to resources
3. Drag the mapping folder to your PC (left side)
4. Keep a safe copy

Backup Frequency

Recommendations:

• Before each major modification
• After each mapping addition
• At minimum once a week

Step 17: Updating a Mapping

Update Process

1. Backup the old version:
   • Download the current folder
   • Keep a copy
2. Stop the server:
   • Via Wisp panel, click Stop
3. Delete the old version:
   • In Files, delete the mapping folder
4. Upload the new version:
   • Follow installation steps (Step 4 or 5)
5. Check server.cfg:
   • Make sure the ensure line is still present
   • Verify folder name hasn't changed
6. Restart the server:
   • Click Start
7. Test in-game:
   • Verify everything works

In Case of Problem

If the new version doesn't work:

1. Stop the server
2. Delete the new version
3. Re-upload your backup
4. Restart the server

VeryCloud Support

If you encounter difficulties:

Documentation: https://verycloud.fr/docs

Wisp Panel: https://panel.verycloud.fr/

Technical Support:

• Open a ticket from your VeryCloud customer area
• Contact support via Discord or email
• Consult the online knowledge base

When contacting support, provide:

• Your server name
• The mapping name concerned
• A detailed problem description
• Error screenshots
• Console logs (if applicable)

Best Practices

Organization

• Consistent naming: Use clear names (e.g., mapping-lspd-v2)
• Documentation: Keep a list of your mappings with their sources
• Categorization: Organize mappings by type (jobs, houses, shops)

Performance

• Test one by one: Add mappings progressively
• Monitor FPS: Check performance impact
• Regular cleanup: Delete unused mappings

Compatibility

• Framework: Make sure mappings are compatible with your framework (ESX, QBCore, etc.)
• Versions: Check compatibility with your FiveM version
• Conflicts: Test interactions between mappings

Security

• Reliable sources: Only download from recognized sites
• Antivirus scan: Check files before upload
• Backup: Always keep copies of your configurations

Additional Resources

Useful Tools

• OpenIV: To view and edit .ymap/.ytyp files
• CodeWalker: To find coordinates and explore mappings
• FiveM Native Reference: FiveM function documentation

FiveM Community

• Official forum: https://forum.cfx.re/
• FiveM Discord: Search for community servers
• YouTube: Video tutorials on mappings

Learning

If you want to create your own mappings:

• Learn to use OpenIV
• Follow GTA V modding tutorials
• Practice with simple mappings

Conclusion

You now know how to add, manage, and optimize mappings on your FiveM server hosted at VeryCloud via Wisp panel!

Key Steps Summary:

1. Download your mapping
2. Upload it to resources/ via Wisp or FTP
3. Add ensure mapping-name in server.cfg
4. Restart the server
5. Test in-game

Points to Remember:

• Always check mapping structure (manifest + stream)
• Backup before any modification
• Test performance after each addition
• Consult mapping documentation

Welcome to the FiveM mapping universe and enjoy your custom server with VeryCloud!