Difference between revisions of "Installing mods"

Revision as of 14:33, 13 August 2010

Glest has a wide variety of mods, all which are installed in the Glest folder. First of all, you should be familiar with what the Glest folder is. This is the installation folder, where you installed everything either by telling the installer where to place the files or by manually copying the files into this folder yourself. If you used the Windows Installer and not sure where you installed it, it's probably either "C:\Program Files\Glest_version" on 32 bit operating systems or "C:\Program Files (x86)\Glest_version" on 64 bit operating systems.

Installation

All files are installed in the Glest Folder, which is the installation directory.If you used the Windows Installer and not sure where you installed it, it's probably either "C:\Program Files\Glest_version" on 32 bit operating systems or "C:\Program Files (x86)\Glest_version" on 64 bit operating systems.

Factions

Factions that do NOT contain the tech tree in which they should belong (ie: dark magic. It is meant to go within the magitech tech tree) should generally go inside the magitech or a related techtree (such as the Megapack). Alternatively, you can copy and paste the magitech tech tree to have a copy for the new faction. All factions go inside the techs/techtree_name/factions folder, where techtree_name is the name of the techtree (ie: magitech). How do you know if the mod you have is a faction or a techtree? Well, open the folder. If there is a resources folder, it is not a faction, but rather a techtree. If there is not a resource folder, it is a faction.

Techtrees

Techtrees are separate from factions because you can only have one techtree for the entire game, and all the player's factions must be in that tech tree. Thus, you can't play military against dark magic because they do not belong in the same techtree. Techtree's are simply copied into the techs folder. How do you know if its a techtree? Open the folder, and if there is a resources folder, it is a techtree. If there isn't a resources folder, its a faction (see above).

Tilesets

Tilesets go into the tileset folder of Glest.

Maps

Maps should be either a gbm (glest binary map) or mgm (megaglest map) file. All gbm and mgm files are placed in the maps folder.

Languages

Downloaded language files (their should be one sole .lng file) go in the data/lang folder (or gae/data/lang if using GAE). Note that this merely installs the language. To use it, you must start glest, go to the options menu, and set the language to the specific langauge.

Scenarios

The scenario's folder needs to be placed in the scenarios folder of Glest. In GAE, it goes in the gae/scenarios folder.

Tutorials

In the original Glest and MegaGlest, tutorials go in the tutorials folder. In GAE, they go in the gae/scenarios/tutorials folder.

Game Saves (GAE Only)

Game saves go in the savegames folder. This only applies to GAE. Note that if using someone else's saved game, you must have the map, tileset, techtree, and faction that they used.

@@ Line 1: / Line 1: @@
-==Install Mods(Old Guide, please use the new one below this one)==
+Glest has a wide variety of mods, all which are installed in the Glest folder. First of all, you should be familiar with what the Glest folder is. This is the installation folder, where you installed everything either by telling the installer where to place the files or by manually copying the files into this folder yourself. If you used the Windows Installer and not sure where you installed it, it's probably either "C:\Program Files\Glest_version" on 32 bit operating systems or "C:\Program Files (x86)\Glest_version" on 64 bit operating systems.
-'''Place new folders into existing Glest directories.'''
-For Windows, the Glest directory should look something like this: "C:\Program Files\Glest_3.2.2\glest.
+==Archives==
+Because mods are usually a compilation of multiple files, they are usually compressed into an archive. This is a special file format that greatly reduces filesize and ensures that all the files are available together. In order to use the files, you must first extract them from this archive. Common archives used in Glest are:
-For Linux, it normally looks like /user/share/games/glest or something close to that.
+*7z - One of the most common, this is the 7-Zip file format, and has the best compression rate. The free program [http://7zip.org/ 7zip] is required to extract/archive them.
+*zip - This is an old format, and not very common anymore, due mostly to its poor compression rates. Windows, Linux, and Mac can all extract and compress zip files by default, as can the program 7zip.
-* New tech trees and factions go in the ''techs'' folder.
+*rar - A less common program because free tools can only decompress it. 7zip (free) or winRAR (commercial) can extract these files. Only winRAR can archive in this format.
+*tar.gz / tar.bz2 - This is a duel file format. First, the data is stored with the Tar format, then compressed with Gzip/Bzip2, providing better compression than all but the 7z format. If extracting, you must extract TWICE (once for the gz/bz2, once for the tar file). Linux can extract by default, as can the 7zip program.
-* New maps in the'' maps'' folder.
+==Installation==
+All files are installed in the Glest Folder, which is the installation directory.If you used the Windows Installer and not sure where you installed it, it's probably either "C:\Program Files\Glest_version" on 32 bit operating systems or "C:\Program Files (x86)\Glest_version" on 64 bit operating systems.
-* New scenario in the ''scenarios'' folder.
+===Factions===
+Factions that do NOT contain the tech tree in which they should belong (ie: dark magic. It is meant to go within the magitech tech tree) should generally go inside the magitech or a related techtree (such as the Megapack). Alternatively, you can copy and paste the magitech tech tree to have a copy for the new faction. All factions go inside the techs/'''techtree_name'''/factions folder, where techtree_name is the name of the techtree (ie: magitech). How do you know if the mod you have is a faction or a techtree? Well, open the folder. If there is a resources folder, it is '''not '''a faction, but rather a techtree. If there is not a resource folder, it is a faction.
-* New tilesets in the tilesets folder.
+===Techtrees===
+Techtrees are separate from factions because you can only have one techtree for the entire game, and all the player's factions must be in that tech tree. Thus, you can't play military against dark magic because they do not belong in the same techtree. Techtree's are simply copied into the techs folder. How do you know if its a techtree? Open the folder, and if there is a resources folder, it is a techtree. If there isn't a resources folder, its a faction (see above).
-Check the zip package readme.txt for mod-specific instructions.
+===Tilesets===
+Tilesets go into the tileset folder of Glest.
+===Maps===
+Maps should be either a gbm (glest binary map) or mgm (megaglest map) file. All gbm and mgm files are placed in the maps folder.
+===Languages===
-http://images4.wikia.nocookie.net/glest/images/0/08/Install_Mods.jpg
+Downloaded language files (their should be one sole .lng file) go in the data/lang folder (or gae/data/lang if using GAE). Note that this merely installs the language. To use it, you must start glest, go to the options menu, and set the language to the specific langauge.
+===Scenarios===
-== '''Unfinished Guide(0.5.1)'''==
+The scenario's folder needs to be placed in the scenarios folder of Glest. In GAE, it goes in the gae/scenarios folder.
+===Tutorials===
+In the original Glest and MegaGlest, tutorials go in the tutorials folder. In GAE, they go in the gae/scenarios/tutorials folder.
+===Game Saves (GAE Only)===
+Game saves go in the savegames folder. This only applies to GAE. Note that if using someone else's saved game, you must have the map, tileset, techtree, and faction that they used.
-=== UNPACKING/OPENING&nbsp;ARCHIVES===
+[[Category:mods]]
-====Archive Formats that you will need to be able to open====
--Zip (.7z)
-Zip (.zip)
-RAR (.rar)
-Executable Installer (.exe) [WINDOWS ONLY]
-====How to open those archives====
-====='''Windows'''=====
--Zip---------------------------7-Zip File Manager
-Zip------------------------------7-Zip File Manager, any file-manager
-RAR---------------------------7-Zip File Manager, WinRAR, and some file-managers
-Executable Installer-----Double-click, and follow the instructions
-====='''Linux'''=====
--Zip: Install P7zip via package manager, and your archiving tools should be able to open a 7-Zip File.
-Zip: Any generic archiving tool.
-RAR: Install the "rar" and "unrar" packages via the package manager, and your archiving tools should be able to open/unpack a .rar file.
-====='''Max OS X'''=====
-(Other users please fill in)
-----
-----
-=== INSTALLATION===
-TIP: REFER TO THE [[InstallMod#FILE-TYPE_KEY|FILE-TYPE KEY]] TO LEARN HOW TO RECOGNIZE DIFFERENT FILE TYPES
-====Windows====
-Windows default installation directory: "C:\Program Files\Glest_3.2.2\".
-Glest_3.2.2
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|------------data (only few mods go here, and they almost definitely will have outside instructions)
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|------------docs (This is where you can find game licenses)
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|------------maps ("Map" files go here)
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|------------scenarios ("Scenario" files go here)
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|------------screens (This is where Glest will store in-game screenshots)
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|------------techs("Tech" files go here)
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; |------------magitech
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; |------------factions("Faction" files go here)
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|------------tilesets("Tileset" files go here)
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; |------------dark_forest
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; |------------forest
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; |------------winter_forest
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|------------tutorials (only few mods go here, and they almost definitely will have outside instructions)
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; |------------basic tutorial
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; |------------advanced tutorial
-----
-====Linux====
-=====If you installed Glest with a package manager:=====
-(WIP)
-=====If you installed Glest with a Loki installer:=====
-(WIP)
-=====If you installed Glest manually:=====
-(WIP)
-----
-====Mac OS X====
-First of all, english is not my language so, if anybody can correct this...&nbsp;: )
-So, here is how I did it ...
-I downloaded the Glest32Data.pkg and all the maps, scenarios, etc. I wanted.
-Right click on the Glest32Data.pkg and choose to see the content of the package.
-You should find Archive.pax.gz.
-Copy it and extract it.
-It will create a GlestGame folder witch contains scenarios, tilesets, techs, etc. folders.
-Unpack and place in the respective folders the additional contents you want.
-Then, from the terminal, make an archive of the GlestGame folder (witch now contains the additionnals maps, tilesets, etc.).
-For this, use command&nbsp;: tar -zcvf test.gz ./GlestGame/
-In the Glest32Data.pkg, rename the Archive.pax.gz (so you still have it if this operation doesn't work...)
-Place your test.gz file in the same folder than Archive.pax.gz and rename it as Archive.pax.gz.
-Now run the Glest32Data.pkg.
-It will install Glest with the added maps...
-I don't know if this operation delete saved games (I only installed the game yesterday)
-[http://ciderhouse.opal.ne.jp/wp/english/glest/ this may be helpful for the installmod process - otherwise trashcan it.
-====Other OSes====
-(Other users please fill in)
-Tip: Check the mod archive/installation directory for mod-specific instructions.
-=== FILE-TYPE KEY===
- '''Faction File-----Has 3 folders within it named: "music", "units", and "upgrades".'''
- '''Map File---------Has a .gbm extension. '''
- '''Scenario File----Has a file with a .xml extension within it. '''
- '''Tech File--------Within it you can find two files: "factions" and "resources". '''
- '''Tileset File-----Has 3 folders within it named: "models", "sounds", and "textures".'''