View source for Tutorials/Map Editor/Introduction to the Map Editor/Saving, Loading, Sectors, and Files

{{TutorialNavigation|previous=Basic Editor Functions}}

{{TutorialInfoBox
| topic = Map Editor
| difficulty = Easy
| tools = 

[[Documentation/Tools/Map_Editor|Map Editor]]
| icon_file = First map ingame 02 8.jpg
}}

So far we have learned how to launch the editor, and some of the basic tools and functions that are available to us. We will continue to expand on this by learning how to save, load, and run our map. We'll also talk about where our files are being saved and what's in them.

= Placing our First Road and Saving our Map =

{| class="wikitable" width="100%"

|- style="vertical-align: top"
| width="10px" | '''1'''
| width="25%" | [[File:First road piece 02 1.png|upright|1024px]]
| With our editor open, we will click on the 'Item type' drop down and select 'Road' (shortcut: 1) 

|- style="vertical-align: top"
| width="10px" | '''2'''
| width="25%" | [[File:Road properties 02 2.png|upright|1024px]]
| Next, click New item (shortcut: E). This will open the Road item default properties. Leave everything for now as default - we will go in depth with road pieces and connections in a later tutorial


{{Tip|Ensure you are in Top Camera view when placing roads (shortcut: C)}}
|- style="vertical-align: top"
| width="10px" | '''3'''
| width="25%" | [[File:First_road_line_02_3.png|upright|1024px]]
| Click near the rear of the pink car and then drag your mouse up. A red line should appear showing the road path before you click the second time drawing the road. Hit Esc to clear out placing any new items

|- style="vertical-align: top"
| width="10px" | '''4'''
| width="25%" | [[File:Start position 02 4.jpg|upright|1024px]]
| Activate 'Free Camera' (shortcut: C) and fly down to your road piece. Ensure our starting spot (pink car) is touching the ground - if not, ensure Snap to Ground (shortcut: G) is on and then click 'Place Start' and click somewhere on the road

|- style="vertical-align: top"
| width="10px" | '''5'''
| width="25%" | [[File:Save first map 02 5.png|upright|1024px]]
| Now go to File > Save As (shortcut CTRL + S); name your map whatever you want - mine is named 'deerland'. You do not need to change any settings here. Leave location and anything else unchanged
|}

= Loading our map =

{| class="wikitable" width="100%"

|- style="vertical-align: top"
| width="10px" | '''1'''
| 
| Launch the Map Editor 

|- style="vertical-align: top"
| width="10px" | '''2'''
| width="25%" | [[File:Open first map 02 6.png|upright|1024px]]
| Go to File > Open; double click on your named map - it should open to where we left off</big><br>
<big>That's it! Loading the map is super easy and the editor should load in the last area you were before you exited


{{Tip|Alternatively, you can add '-edit *map_name* (-edit deerland) in your shortcut to load directly to our map}}
|}

= Running our First Map =

{| class="wikitable" width="100%"

|- style="vertical-align: top"
| width="10px" | '''1'''
| width="25%" | [[File:First map ingame 02 8.jpg|upright|1024px]]
| <big>With your map open in the editor, click on the Run Map button. The game will load a preview profile and spawn you in at the start point</big>


{{Note|If your game crashes you probably have mods enabled somewhere, either in ''/home'' or from the steam workshop. You can still run your map by launching the game like normal and then typing 'preview *map_name*' into console IE. 'preview deertest'}} 
|}

= Sectors, an Explanation =
<big>So I want you to imagine mainland Europe. Now imagine that we took a giant cookie cutter in the shape of a square and punched a chunk out in the middle of Europe. This single square is called a sector. The entire map of Europe, or any map for that matter, is made up of many of these sectors. The first sector of the map is the origin, and its named: SEC + 0000 + 0000. A single sector has a length of 4000 meters with a height of 4000 meters or 16<sup>2</sup> km. Sectors are numbered from 0000-9999 and may either have a (-/+). The can travel near infinetly in the X and Y axis. Each subsequent sector change their value based on their location. The image below shows how sectors are numbered starting from the origin.</big>


[[File:Sector layout graph.png|frameless|center|2048px]]


<big>So what does that mean for us? For map editing not too much. When we get to the edge of a sector, the editor automatically creates another sector with no input necessary from you. However, if you have a problem with a single sector you don't loose your entire map, and it makes it easier to keep track of different changes. Additionally, several map makers could work on a single map project dividing the work among sector borders.</big>


This brings us to our next topic...

= Files = 
When we launched the editor for the first time, a folder was automatically created in our ''<code>/home/mod</code>'' directory called 'user_map' This is where the game automatically saved our map and map files. Lets take a look at what was saved.


[[File:Mod directory user map 02 7.png|frameless|center|2048px]]


{{Note|Typical location of the ''<code>/home</code>'' directory: ''<code>C:\Users\*user*\Documents\Euro Truck Simulator 2\mod</code>''}}


Looking inside of ''<code>/home/mod/user_map/</code>'' we have a folder and 3 files (''remember our example map was named "deerland"''):
* deerland (''folder'')
* deerland.epa
* deerland.mbd
* deerland.set


Now looking inside of ''<code>/home/mod/user_map/deerland/</code>'' we have 5 files:
* sec-0001-0001.aux
* sec-0001-0001.base
* sec-0001-0001.data
* sec-0001-0001.desc
* sec-0001-0001.layer


{{Note|Your first sector number might be different depending on where you clicked and drew your first and only road piece}}


These files are stored in binary format that the game reads data from. The most important part is that a single sector is made up of 5 files (''6 files counting a .SND file which is not present here since we have no sounds in our sector, yet'') In order for your map sector to function you need at least all 5 named sector files or your game will crash. Each of the 5 sector files are responsible for a different aspect of our map: roads, signs, sounds, model placement, sign layouts, overlays, cities, companies, etc. The 3 other map named files are header files that are used to open our map in the editor.


{{TutorialNavigation|previous=Basic Editor Functions}}