User Tools

Site Tools


gamemanual:installing_map

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
gamemanual:installing_map [2017/05/13 17:18] – [Moving the Folder to Maps] admingamemanual:installing_map [2022/06/18 12:26] (current) – [Note] admin
Line 1: Line 1:
-====== Installing Maps ======+====Note==
 +This tutorial deals with **MANUAL** installation of Maps. If you are using the Steam version of the game and downloading the map through Steam Workshop, you need to do the [[gamemanual:installing_mods_steamworkshop|Installing Maps and Mods Via Steam Workshop]] tutorial for an automated process. 
  
-So you've downloaded a new cool map, and now you want to try it out in the game! But you don't know how... Don't worry, we've got some instructions for you.+\\ 
 +\\ 
 +====== Manually Installing Maps ====== 
 + 
 +You have downloaded a new cool map, but you do not know how to install it.  Follow these instructions for manually installing maps into the game.
  
  
Line 8: Line 13:
 ===== How It Works ===== ===== How It Works =====
  
-First, you should know how the system works. Map files are actually folders. Inside these folders are all the files used for the map. There is a file in the first level of the folder called //MapFileForGame.xml//. The game looks for this file in each folder in the "Maps" folder. If the file is there, it reads the data from the file and if there are no errors, you have a playable map. If the file is missing, it will not load the map.+Map files are folders. Inside these folders are all the files used for the map, including the //MapFileForGame.xml// file. The game looks for this file in each parent folder in the "Maps" folder. 
  
  
Line 15: Line 20:
 ===== Unpacking ===== ===== Unpacking =====
  
-Most likely you received the map in a compressed file format. Depending on the format, you may need third party software to decompress it. The following list are names of software needed for each file extension: +Most likelyyou received the map in a compressed file format. Depending on the file type, you may need third-party software to decompress it. The following is a list that includes names of software for common file extensions:
- +
-//Please note, due to this wiki being viewable in game, external links have been disabled. Copy and paste, or type the URL in your address bar to visit the websites.//+
  
 The following programs are for Windows. We expect Linux and OSX users to know their software. :) The following programs are for Windows. We expect Linux and OSX users to know their software. :)
Line 24: Line 27:
 |.7z| 7zip | www.7-zip.org| |.7z| 7zip | www.7-zip.org|
 |.rar| winRAR or 7zip| www.rarlab.com/download.htm   OR   www.7-zip.org| |.rar| winRAR or 7zip| www.rarlab.com/download.htm   OR   www.7-zip.org|
 +//Please note, we disabled external links because this wiki being viewable in-game. Copy and paste, or type the URL in your address bar to visit the websites.//
  
-The contents of the map should be in one folder with the same name as the map name. + 
 +After extracting, the contents of the map should be in a single folder with the same name as the map name.
  
  
Line 33: Line 38:
 ===== Moving the Folder to Maps ===== ===== Moving the Folder to Maps =====
 {{ :gamemanual:how_to_install_a_map_folder_example.png?200|}} {{ :gamemanual:how_to_install_a_map_folder_example.png?200|}}
-Next you should locate your Maps folder. This is normally in the game's InstallPath/media/Maps folder. If you're using Steam, see [[Troubleshooting:Steam_InstallFolder|Steam: How to Access Installation Folder]].+Nextlocate the game'Maps folder. This is in the game'//InstallPath/media/Maps// folder. If you're using Steam, see [[Troubleshooting:Steam_InstallFolder|Steam: How to Access Installation Folder]] to get to the //InstallPath// folder...
  
-An example of the map folder looks like with other maps is in the picture on the right.+The picture on the right is an example of a Maps folder with maps installed.
  
 +Now, copy and paste the entire folder for the downloaded map into the //InstallPath/media/Maps// folder.
 \\ \\
 \\ \\
 +
 +
 +===== Loading Your Map =====
 +After decompressing the map files and moving the resulting folder to the Maps folder, the game should see it. Open GearCity, start a new game, and see if it is there.
 +
 \\ \\
 \\ \\
 +===== Troubleshooting =====
 +
 +Here is a list of common mistakes if something went wrong.
 +
 +==== Map Does Not Show Up On In-Game List ====
 +
 +There might be something wrong with the Map files, or you installed it incorrectly.
 +
 +First, did you copy the folder containing the Map Files to the Maps folder? For example, if you downloaded "My Fun Map," did you copy the "My Fun Map" folder to the //InstallPath/media/Maps//?
 +
 +The map's name must be the same as the folder's name. You can find the name by opening the //MapFileForGame.xml// in a text editor (Notepad) and looking at what is between the MapName tags. For example, **<MapName>**//Base City Map//**</MapName>** The name of the map is "Base City Map." So the folder containing all these files should be "Base City Map."
 +
 +
 +==== Map Crashes When I Click It On the List ====
 +
 +Most likely, the map is missing the map picture logo file. If you properly installed the map, then the problem is with the map maker. Either they did not include this file, incorrectly named it, or the file is not in the correct format.
 +
 +
 +==== Map Crashes When I Start A New Game ====
 +
 +In most instances, this is an issue that the mapmaker has to fix.  Typically, it is missing .dds texture files. Anytime the game crashes, check the logs. Sometimes it will tell you why the game crashed. [[modtools:reading_log_file|How to Read Log file.]]
 +
gamemanual/installing_map.1494710319.txt.gz · Last modified: 2022/02/15 17:58 (external edit)