Difference between revisions of "Installing mods"

From MegaGlest
Jump to navigation Jump to search
 
 
(31 intermediate revisions by 8 users not shown)
Line 1: Line 1:
==Install Mods==
+
== Installing Mods ==
 +
[[MegaGlest]] has a wide variety of [[mods]].
 +
<br>If Mods have a good stage and are fully playable, titi ( or anyone else of the MegaGlest team )  makes them available in the ingame-ModCenter. This is the first place you should look for new stuff ;-) .
  
 +
Other mods have to be installed manually.
  
'''Place new folders into existing Glest directories.'''
+
== Installing mods via ingame Mod Center ==
 +
MegagGlest has an ingame [[Mod-Center]] that let you install a lot of mods already.
 +
If the mod is not available in the mod center you have to install it manually
  
For Windows, the Glest directory should look something like this: "C:\Program Files\Glest_3.2.2\glest.
+
== Installing Mods in network games ==
 +
If you join a network game, MegaGlest lets you download all needed maps/tilesets/techtrees automatically. Just press "yes" :D .
  
For Linux, it normally looks like /user/share/games/glest or something close to that.  
+
To make this work Tilesets and Techtrees must be available as 7z archives, placed side by side to their tileset/techtree folder positions. ( bananworld.7z must be placed in same folder as banaworld/ and must have the same content )
 +
Maps don't need a special treatment, they are available as they are because maps are VERY small in MegaGlest.
  
* New tech trees and factions go in the ''techs'' folder.
+
== Manual installation ==
  
* New maps in the'' maps'' folder.
+
Sometimes a manual installation is needed because you the mod is just available as a download somewhere.
  
* New scenario in the ''scenarios'' folder.
+
===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 for Mod packing are:
 +
*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. This is the native way MegaGlest uses to distribute Mods ingame or via modcenter.
  
* New tilesets in the tilesets folder.
+
*zip - This is still used by some modders, but is 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.  
  
Check the zip package readme.txt for mod-specific instructions.
+
==== unusual formats ====
 +
*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. Using this format is not recommended because it is a proprietary format and that clashes with the free beliefs of Glest.
 +
*tar.gz / tar.bz2 - This is a duel file format. First, the data is stored with the tar format, then compressed with Gzip/Bzip2. 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.
  
 +
===Install locations===
  
  
 +
The mods are installed in the homedirectory of the user. Once the game was started one time you will find the following folders in your home directory.
 +
In Linux this location is in ~username/.megaglest  ( typically this is in /home/username/megagglest ).
  
http://images4.wikia.nocookie.net/glest/images/0/08/Install_Mods.jpg
+
In Windows you will find those folders in %appdata%\megaglest (C:\Users\Anonymous\AppData\Roaming\megaglest)
  
 
 
 
== Unfinished Guide(WIP)==
 
 
 
 
 
=== '''<u>Windows</u>''' ===
 
Windows default installation directory: "C:\Program Files\Glest_3.2.2\". 
 
 
<br /> ---------------------------------------------------------------------------------------------
 
 
Default File Structure(others please complete this): 
 
 
 
 
Glest_3.2.2 
 
 
|------------data 
 
 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; |------------core
 
 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; |------------lang
 
 
 
|------------docs  (This is where you can find game licenses)
 
  
 
|------------maps ("Map" files go here)
 
|------------maps ("Map" files go here)
  
|------------scenarios ("Scenario" files go here)
+
|------------scenarios ("Scenario" folders go here)
 
 
|------------screens (This is where Glest will store in-game screenshots)
 
  
|------------techs("Tech" files go here)
+
|------------techs("Techtree" folders go here)
  
|------------tilesets
+
|------------tilesets ("Tileset" folders go here)
  
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; |------------dark_forest("tileset" file)
+
|------------tutorials ("Tutorial" folders go here)
 
 
&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; |------------winter_forest
 
 
 
|------------tutorials
 
  
 
----
 
----
  
 +
====Maps====
 +
[[Maps]] should be a mgm (megaglest map) file. All mgm files are placed in the <tt>maps</tt> folder. ( original glest gbm files work too, but are deprecated )
  
 +
====Scenarios====
 +
The [[Scenarios|scenario's]] folder needs to be placed in the scenarios folder of Glest. In GAE, it goes in the <tt>gae/scenarios/'''category'''</tt> folder (where category can be any folder name desired, as they are just ways of sorting the scenarios).
  
Check the archive for mod-specific instructions.
+
====Techtrees====
 
+
[[Techtrees]] Techtree's are simply copied into the <tt>techs</tt> 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).
 
 
 
 
 
 
 
 
=== '''<u>Linux</u>''' ===
 
(Working on Windows at the moment - somebody want to do this, it has to be detailed and complete)
 
 
 
 
 
 
 
 
 
 
 
=== '''<u>Mac OS X</u>''' ===
 
First of all, english is not my language so, if anybody can correct this... : )
 
So, here is how I did it ...
 
 
 
I downloaded the Glest32Data.pkg and all the maps, scenarios, etc. I wanted.
 
Do a right clic 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 te additionnal 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 : 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.
 
  
=== '''<u>Other OSes</u>''' ===
+
====Tilesets====
(please somebody fill in)
+
[[Tilesets]] go into the <tt>tileset</tt> folder of Glest.
  
 +
====Tutorials====
 +
In the original Glest and MegaGlest, tutorials go in the <tt>tutorials</tt> folder. In GAE, they are treated like scenarios (see above).
  
 +
== Full Conversions ==
 +
Full conversion typically come as standalone game. ( for example [[Annex_Conquer_The_World]] ). They have there own installer or installation procedure.
  
=== '''<u>KEY</u>''' ===
+
==See Also==
 +
*[[Mods/List|Wiki List of Techtrees]]
 +
*[[Tilesets/List|Wiki List of Tilesets]]
 +
*[[Maps/List|Wiki List of Maps]]
 +
*[[Scenarios/List|Wiki List of Scenarios]]
 +
*[[MegaGlest]]
 +
[[Category:Mods]]
 +
[[Category:HOW-TOs]]

Latest revision as of 00:21, 14 September 2023

Installing Mods[edit]

MegaGlest has a wide variety of mods.
If Mods have a good stage and are fully playable, titi ( or anyone else of the MegaGlest team ) makes them available in the ingame-ModCenter. This is the first place you should look for new stuff ;-) .

Other mods have to be installed manually.

Installing mods via ingame Mod Center[edit]

MegagGlest has an ingame Mod-Center that let you install a lot of mods already. If the mod is not available in the mod center you have to install it manually

Installing Mods in network games[edit]

If you join a network game, MegaGlest lets you download all needed maps/tilesets/techtrees automatically. Just press "yes" :D .

To make this work Tilesets and Techtrees must be available as 7z archives, placed side by side to their tileset/techtree folder positions. ( bananworld.7z must be placed in same folder as banaworld/ and must have the same content ) Maps don't need a special treatment, they are available as they are because maps are VERY small in MegaGlest.

Manual installation[edit]

Sometimes a manual installation is needed because you the mod is just available as a download somewhere.

Archives[edit]

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 for Mod packing are:

  • 7z - One of the most common, this is the 7-Zip file format, and has the best compression rate. The free program 7zip is required to extract/archive them. This is the native way MegaGlest uses to distribute Mods ingame or via modcenter.
  • zip - This is still used by some modders, but is 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.

unusual formats[edit]

  • 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. Using this format is not recommended because it is a proprietary format and that clashes with the free beliefs of Glest.
  • tar.gz / tar.bz2 - This is a duel file format. First, the data is stored with the tar format, then compressed with Gzip/Bzip2. 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.

Install locations[edit]

The mods are installed in the homedirectory of the user. Once the game was started one time you will find the following folders in your home directory. In Linux this location is in ~username/.megaglest ( typically this is in /home/username/megagglest ).

In Windows you will find those folders in %appdata%\megaglest (C:\Users\Anonymous\AppData\Roaming\megaglest)


|------------maps ("Map" files go here)

|------------scenarios ("Scenario" folders go here)

|------------techs("Techtree" folders go here)

|------------tilesets ("Tileset" folders go here)

|------------tutorials ("Tutorial" folders go here)


Maps[edit]

Maps should be a mgm (megaglest map) file. All mgm files are placed in the maps folder. ( original glest gbm files work too, but are deprecated )

Scenarios[edit]

The scenario's folder needs to be placed in the scenarios folder of Glest. In GAE, it goes in the gae/scenarios/category folder (where category can be any folder name desired, as they are just ways of sorting the scenarios).

Techtrees[edit]

Techtrees 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[edit]

Tilesets go into the tileset folder of Glest.

Tutorials[edit]

In the original Glest and MegaGlest, tutorials go in the tutorials folder. In GAE, they are treated like scenarios (see above).

Full Conversions[edit]

Full conversion typically come as standalone game. ( for example Annex_Conquer_The_World ). They have there own installer or installation procedure.

See Also[edit]