User Guide Map Builder V | OmegaKingStudios

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)

Singleplayer Installation

Map Builder V - Singleplayer

Requirements:

OpenIV - DOWNLOAD

ScriptHookV - DOWNLOAD

ScriptHookV .NET - DOWNLOAD

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

Map Editor - DOWNLOAD
Menyoo - DOWNLOAD
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. (Vol1, Vol2, Vol3, Vol4, 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. (Vol1, Vol2, Vol3, Vol4, 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_vol1") (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_vol1/</Item>
<Item>dlcpacks:/mbv_vol2/</Item>
<Item>dlcpacks:/mbv_vol3/</Item>
<Item>dlcpacks:/mbv_vol4/</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?

Incorrectly installing Map Builder V resource packs.
Using an old game version.
Installing other "dlcpacks" based modifications with Map Builder V overloads the games available resources.
Installing graphics-based modifications.
Some other modification is interfering with the installation.

Why are Map Builder V assets invisible?

Incorrectly installing Map Builder resource packs.
A map that you are trying to use requires additional Resource Packages.
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 Packs of choice for FiveM servers. (Vol1, Vol2, Vol3, Vol4, 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_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 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.

RageMP Installation

Map Builder V - RageMP Servers

Server Installation:

Download Resource Packs of choice using the Manual Install option. (Vol1, Vol2, Vol3, Vol4, 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_vol1, mb_vol2, etc.)
Done. Reinstall after each Map Builder V 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 resource folders. (mbv_vol1 / mbv_vol2 / mbv_vol3 / mbv_vol4)
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_vol1 <-DELETE THIS

start mbv_vol2 <-DELETE THIS

start mbv_vol3 <-DELETE THIS

start mbv_vol4 <-DELETE THIS

Uninstalled for Servers.

Uninstall Tool

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.

HASH KEY

Map Builder V - Updated Asset Lists

Updated asset lists for all Map Builder V resource packages.

3D ASSET LISTS

Map Builder V - Test Maps (YMAP)

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

FREE TEST MAP

PATRON TEST MAP

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!