top of page

Map Builder V: User Guide

Getting Started

Thank you for using Map Builder V! Here are a few tips for beginners.

​

Map Builder V - Beginner Tips:

  • Creating maps is only supported for Singleplayer. You can load finished YMAP files in custom multiplayer servers.

  • XML files can be converted to YMAP by using this tool - XML to YMAP download

  • Install resource volumes individually, together, or in any order. Six resource volumes are available.

​

Map Builder V - Common User Problems:

​

Invisible Assets - Causes:

  • Incorrectly installing Map Builder V resource volumes.​​

  • Your map requires additional Map Builder V resource volumes.

  • Your map has a hash code instead of the model name in the YMAP file, causing an error.

  • Your map does NOT have properly calculated extents or other code in the YMAP file.

  • Some other modification is interfering with the installation. Mods that change graphics and shaders for example.

​

OIV Installation Fails - Causes:

  • You have an invalid file path in your mods folder.

  • You don't have enough space on your hard drive.

  • Your game is still running after closing it. (Rockstar Launcher)

Singleplayer Installation

Map Builder V - Singleplayer

Requirements:

OpenIV - DOWNLOAD

ScriptHookV - DOWNLOAD

ScriptHookV .NET - DOWNLOAD

3D Model Spawner - (At least one is required for spawning 3D models)

  1. Map Editor - DOWNLOAD

  2. Menyoo - DOWNLOAD

  3. CodeWalker - DOWNLOAD

Object Spawn Unlocker - DOWNLOAD (Optional: This will unlock additional game objects for Map Editor.)

​

Important:

  • Install Map Builder V resource volumes for singleplayer using the OIV or Manual installation method.

  • Install resource volumes individually, together, or in any order. 

  • Install a modified gameconfig, heap adjuster, and packfile adjuster to prevent the game from crashing.

  • Some maps may require one or more resource volumes, check with the map author or install them all.

  • Users can create and play maps in singleplayer mode. Users can only stream finished YMAPs in custom servers.

​

Singleplayer OIV Installation: (Option #1)

  • Install requirements.

  • Download OIV resource volumes of choice. (Vol1, Vol2, Vol3, Vol4, Vol5, Vol6)

  • Start OpenIV with Edit Mode enabled.

  • Install OpenIV.asi for first-time use.

  • Drag the downloaded OIV file into OpenIV. (Do NOT extract manually)

  • Click Install* in the package installer window.

  • Select the "mods" folder in the next window.

  • Installed for Singleplayer. Repeat the process for updates and additional resource volumes.

​

Singleplayer Manual Installation: (Option #2)

  • Install requirements.

  • Download Manual resource volumes of choice. (Vol1, Vol2, Vol3, Vol4, Vol5, Vol6)

  • Create file path (GTAV/mods/update/update.rpf) and copy update.rpf to the mods folder.

  • Place the resource folders into the dlcpacks folder. (Ex: "mbv_vol1") (mods/update/x64/dlcpacks)

  • Download and replace the gameconfig.xml file (mods/update/update.rpf/common/data)

  • Add any of the following lines to your dlclist.xml (mods/update/update.rpf/common/data)

  •         <Item>dlcpacks:/custom_maps/</Item>

  •         <Item>dlcpacks:/mbv_vol1/</Item>

  •         <Item>dlcpacks:/mbv_vol2/</Item>

  •         <Item>dlcpacks:/mbv_vol3/</Item>

  •         <Item>dlcpacks:/mbv_vol4/</Item>

  •         <Item>dlcpacks:/mbv_vol5/</Item>

  •         <Item>dlcpacks:/mbv_vol6/</Item>

  • Add the list of objects from "add objects" to ObjectList or PropList.

  • Done.

​

Notes:

  • A custom gameconfig, heap adjuster, or packfile limit adjuster may be required if your game crashes.

  • Install your YMAP files to the end of the custom_maps DLC. (Included with Map Builder V resource packs)

  • All assets are automatically added to the end of your ObjectList or PropList.

​

What can cause my game to crash?

  1. Incorrectly installing Map Builder V resource volumes.

  2. Using an old game version.

  3. Installing other "dlcpacks" based modifications with Map Builder V overloads the games available resources.

  4. Installing graphics-based modifications.

  5. Some other modification is interfering with the installation.

​

Why are Map Builder V assets invisible?

  1. Incorrectly installing Map Builder V resource volumes.

  2. A map that you are trying to use requires additional resource volumes.

  3. Some other modification is interfering with the installation.

FiveM Installation

Map Builder V - FiveM Servers

Important: Patrons can mix and match resource packages or install them all. Some existing maps may require one or all of the Map Builder V resource packages. Users can create and play maps in singleplayer mode. Users can only stream finished ymaps in custom servers. If you have any questions ask us in the Discord.

​

Server Installation:

  • Download resource volumes of choice for FiveM servers. (Vol1, Vol2, Vol3, Vol4, Vol5, Vol6)

  • Extract .zip folder.

  • Create a "resources" folder in your server data root if you do not have one already. (ex: root contains server.cfg)

  • Add all folders provided to your "resources" folder. (ex: mbv_vol1)

  • Open your "server.cfg" file in your server data root then add the folder names to the start command and save.

​

[EXAMPLE] - server.cfg

# Only change the IP if you're using a server with multiple network interfaces, otherwise change the port only.

endpoint_add_tcp "0.0.0.0:30009" endpoint_add_udp "0.0.0.0:30009"

​

start mbv_vol1

start mbv_vol2

start mbv_vol3

start mbv_vol4

start mbmaps

​

  • Restart your server to begin streaming 3D models.

  • Done. Reinstall after each Map Builder V resource volume update.

​

Important Installation Notes!

  • Invisible assets - Installing resource packs incorrectly / Missing required resource packs for the map / ymap file failed to convert the hash code to the name of the models.

  • Missing folders - Each of the available resources has a folder. You may not have all of the folders, depending on your selection.

RageMP Installation

Map Builder V - RageMP Servers

Server Installation:

  • Download Resource Packs of choice using the Manual Install option. (Vol1, Vol2, Vol3, Vol4, Vol5, Vol6)

  • Extract .zip folder.

  • Open your "client_packages" folder and create the "dlcpacks" file path if you have not already.

  • File Path: (server-files\client_packages\game_resources\dlcpacks)

  • Place any of the Map Builder V resource volumes into the dlcpacks folder. (mb_vol1, mb_vol2, etc.)

  • Done. Reinstall after each Map Builder V resource volume update.

​

Note: Optionally load YMAP files into your RageMP server using the "custom_maps" DLC.

Uninstall Tool
Uninstall Map Builder V

  • OIV Uninstall Tool - Singleplayer: (Option #1)

  • Download OIV removal tool and extract .zip folder. (Removal_Tool_V2.oiv)

  • Start OpenIV with Edit Mode enabled.

  • Install OpenIV.asi for first-time use.

  • Drag the downloaded OIV file into OpenIV. (Do NOT extract manually)

  • Click Install* in the package installer window.

  • Select "mods" folder in the next window.

  • Uninstalled for Singleplayer.

 

  • Uninstall Map Builder V Manually - Singleplayer: (Option #2)

  • Start OpenIV

  • Go to (Grand Theft Auto V\mods\update\update.rpf\common\data)

  • Open dlclist.xml in edit mode. (Right click then select edit.)

  • Delete all lines containing Map Builder.

  •         <Item>dlcpacks:/mbv_vol1/</Item>

  •         <Item>dlcpacks:/mbv_vol2/</Item>

  •         <Item>dlcpacks:/mbv_vol3/</Item>

  •         <Item>dlcpacks:/mbv_vol4/</Item>

  • Go to (Grand Theft Auto V\mods\update\x64\dlcpacks)

  • Delete all DLC's containing Map Builder. (mbv_vol1 / mbv_vol2 / mbv_vol3 / mbv_vol4)

  • Uninstalled for Singleplayer.

​

  • Uninstall Map Builder V Server Resources - Servers: (Option #3)

  • Open your servers "resources" folder.

  • Delete Map Builder V resource folders. (mbv_vol1 / mbv_vol2 / mbv_vol3 / mbv_vol4)

  • Open your "server.cfg" file then delete the Map Builder V start commands for the folder names and save.

​

[EXAMPLE] - server.cfg

# Only change the IP if you're using a server with multiple network interfaces, otherwise change the port only.

endpoint_add_tcp "0.0.0.0:30009" endpoint_add_udp "0.0.0.0:30009"

​

start mbv_vol1 <-DELETE THIS

start mbv_vol2 <-DELETE THIS

start mbv_vol3 <-DELETE THIS

start mbv_vol4 <-DELETE THIS

start mbv_vol5 <-DELETE THIS

start mbv_vol6 <-DELETE THIS

​

  • Uninstalled for Servers.

Using Placement Editors

Using Placement Editors

Map Builder V is a tool for creating beautiful maps. It's up to the artist to make something incredible. Here are the basics for using each verified placement editor.

Map Editor Tutorial

  • Start GTA V - (game starts)

  • Press "F7" or "R3 + LB" - (menu opens)

  • Select "Enter Map Editor" - (activates map editor camera)

  • Press "F" or "Y" - (opens props menu)

  • Scroll to the bottom of the list - (map builder assets are added to the bottom)

  • Check if props load into the game - (make sure assets are valid)

  • Ready!

Menyoo Tutorial

  • Find Prop List - (GTA V main folder > menyooStuff > PropList.txt)

  • Locate Map Builder props - (located at the end of the PropList.txt)

  • Start GTA V - (game starts)

  • Press "F8" or "RB + Left" - (menu opens)

  • Select "Object Spooner" - (opens editor menu)

  • Activate "Spooner Mode" - (activates menyoo camera)

  • Select "Spawn Entity Into World" - (opens entity type menu)

  • Select "Object" - (opens object menu)

  • Select "SEARCH" - (opens search)

  • Type in the Map Builder prop of choice - (name needs to be exact to work)

  • Check if prop loads into the game - (make sure prop is visible and valid)

  • Note: You can create a favorites list to avoid retyping in the search.

  • Ready!

CodeWalker Tutorial

  • Start CodeWalker

  • Click "<<" at the top right - (menu opens)

  • Select "enable mods" and "enable dlc" checkbox - (prepares dlc activation)

  • Select each of the Map Builder resources as the "dlc level" - (activates dlc props)

  • Press "T" to toggle toolbar - (toolbar opens)

  • Open "project window" from the toolbar - (project window opens)

  • Select "file / new / ymap file" from project window - (activates new map)

  • Click "add entity" from the toolbar

  • Type the name of a prop into "archetype" space - (name needs to be exact to work)

  • Note: Refer to ObjectList for 3D Models (GTA V main folder > scripts > ObjectList.ini)

  • Note: Map Builder props are located at the end of ObjectList.ini

  • Note: If models are invisible go to options in right side toolbar and enable "Show proxies"

  • Note: Resource packages have new names. (ex: mb_discovery > mbv_vol1, etc.)

  • Ready!

Test Maps & Tools
Map Builder V - Hash Codes to Asset Names (YMAP Files)

Sometimes the XML to YMAP coverter tool doesn't convert Map Builder V assets properly. If Map Builder V assets are invisible after converting from XML to YMAP use this guide to fix the problem.

​

  • Start OpenIV

  • Open your YMAP in OpenIV edit mode.

  • Search the "<archetypeName></archetypeName>" for hash code errors. (ex: 0x66B0B56F)

  • Replace any hash codes with the correct asset name. (ex: mbp3_plank_old_2x2b_floor3)

​

Tips:

  • Use the Map Builder Hash Key to find the asset names for the hash codes. (download below)

  • Use a text editor such as Notepad++ to find hash codes quickly using the "Find" function.

Map Builder V - Updated Asset Lists

Updated asset lists for all Map Builder V resource packages.

Map Builder V - Test Maps (YMAP)

Use test maps to verify the Map Builder V resource package installations.

TestMapsImageMBc

FREE Test Map - Requirements:

  • Vol.1 Discovery Resource Package

​

PATRON Test Map - Requirements:

  • Vol.1 Resource Package

  • Vol.2 Resource Package

  • Vol.3 Resource Package

  • Vol.4 Resource Package

​

Installing Test Map - Singleplayer:

  • Install Map Builder V resource package requirements for Singleplayer.

  • Download selected test map. (YMAP)

  • Extract the YMAP file from the zip folder.

  • Start OpenIV with Edit Mode enabled.

  • Go to (Grand Theft Auto V\mods\update\x64\dlcpacks\custom_maps\dlc.rpf\x64\levels\gta5\_citye\maps\custom_maps.rpf)

  • Place the YMAP file into "custom_maps.rpf" (test map = ymap)

  • Done.

​

Installing Test Map - Servers:

  • Install Map Builder V resource package requirements for Servers. (install "mbmaps" resource as well)

  • Download selected test map. (YMAP)

  • Extract the YMAP file from the zip folder.

  • Open the "resources" folder in your server data root. (ex: root contains server.cfg)

  • Place the YMAP file into the "mbmaps" stream folder. (mbmaps/stream)

  • Note: Remember to add resource packages including mbmaps to your server.cfg file.

  • Done.

​

Important Notes:

  • Keep in mind these are test maps. Sections of the maps may appear unfinished, but they should match the provided images.

  • Delete or keep maps after testing.

  • Map Builder V resource packages are verified if the test maps work.

  • If another user's map is NOT working after successfully using test maps, it's a problem with their YMAP file. Contact them about the problem with their map file.

  • Finally, if the test maps aren't working for you, please, contact us. Thank you!

Let's Build! - Video Series
Map Builder V - Let's Build!

Let's build together using Map Builder V.

Let's Build! (Video Series)

Let's Build - Episode 1

OmegaKingStudios
Let's Build - Episode 1
Search video...
Let's Build - Episode 1

Let's Build - Episode 1

06:05
Play Video
Let's Build - Episode 2

Let's Build - Episode 2

03:13
Play Video
Let's Build - Episode 3

Let's Build - Episode 3

02:24
Play Video
DLC Unlocker - Map Editor Extension

Unlock additional game assets for your Map Editor ObjectList.

download-dlc-unlocker-file
bottom of page