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

  • Map Builder V resource packages stack when installing. Install multiple resource packages of choice. (patrons)

  • Resource packages have new names. (ex: mb_discovery > mbv_vol.1, etc.)

Map Builder V - Common User Problems:

Invisible Assets - Causes:

  • Incorrectly installing Map Builder.

  • A map that you are trying to use requires additional resource packages.

  • A map that you are trying to use does NOT have hash codes to asset names conversion in the YMAP file.

  • A map that you are trying to use 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)

 

Map Builder V - Singleplayer

Requirements:

OpenIV - DOWNLOAD

ScriptHookV - DOWNLOAD

ScriptHookV .NET - DOWNLOAD

Placement Editor - (At least one required for using 3D assets)

  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 packs to singleplayer using the OIV or Manual installation method. Patrons can mix and match resource packages or install them all. Install the latest Map Builder V Database file while using all resource packages in singleplayer. 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.

Singleplayer OIV Installation: (Option #1)

  • Download OIV Resource Packs of choice. (Vol.1, Vol.2, Vol.3, Vol.4, MBV Express)

  • 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.

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

Singleplayer Manual Installation: (Option #2)

  • Download Manual Resource Packs of choice. (Vol.1, Vol.2, Vol.3, Vol.4, MBV Express)

  • Extract.

  • Note: The "custom_maps" DLC is optional to install ymap files to your game.

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

  • Place all files from the "adjuster" folder into your main directory.

  • 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_vol.1/</Item>

  •         <Item>dlcpacks:/mbv_vol.2/</Item>

  •         <Item>dlcpacks:/mbv_vol.3/</Item>

  •         <Item>dlcpacks:/mbv_vol.4/</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 packs.

  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 resource packs.

  2. A map that you are trying to use requires additional Resource Packages.

  3. Some other modification is interfering with the 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 Packs of choice for FiveM servers. (Vol.1, Vol.2, Vol.3, Vol.4, MBV Express)

  • 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_vol.1)

  • 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_vol.1

start mbv_vol.2

start mbv_vol.3

start mbv_vol.4

start mbmaps

  • Restart your server to begin streaming 3D assets.

  • Done. Reinstall after each Map Builder V 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 assets.

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

 

Map Builder V - RageMP Servers

Server Installation:

  • Download Resource Packs of choice using the Manual Install option. (Vol.1, Vol.2, Vol.3, Vol.4, MBV Express)

  • 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 packages into the dlcpacks folder. (mb_vol.1, mb_vol.2, etc.)

  • Done. Reinstall after each Map Builder V update.

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

 
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_vol.1/</Item>

  •         <Item>dlcpacks:/mbv_vol.2/</Item>

  •         <Item>dlcpacks:/mbv_vol.3/</Item>

  •         <Item>dlcpacks:/mbv_vol.4/</Item>

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

  • Delete all DLC's containing Map Builder. (mbv_vol.1 / mbv_vol.2 / mbv_vol.3 / mbv_vol.4)

  • Uninstalled for Singleplayer.

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

  • Open your servers "resources" folder.

  • Delete Map Builder resource folders. (mbv_vol.1 / mbv_vol.2 / mbv_vol.3 / mbv_vol.4)

  • Open your "server.cfg" file then delete the Map Builder 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_vol.1 <-DELETE THIS

start mbv_vol.2 <-DELETE THIS

start mbv_vol.3 <-DELETE THIS

start mbv_vol.4 <-DELETE THIS

  • Uninstalled for Servers.

 

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_vol.1, etc.)

  • Ready!

 
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.jpg

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!

 
Map Builder V - Let's Build!

Let's build together using Map Builder V.