Difference between revisions of "Installing mods"

From MegaGlest
Jump to navigation Jump to search
 
 
(23 intermediate revisions by 6 users not shown)
Line 1: Line 1:
==Install Mods(Old Guide, please use the new one below this one)==
+
== 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(0.5)'''==
 
 
 
 
 
=== UNPACKING/OPENING&nbsp;ARCHIVES===
 
====Archive Formats that you will need to be able to open====
 
 
 
7-Zip (.7z)
 
 
Zip (.zip)
 
 
RAR (.rar)
 
 
Executable Installer (.exe) [WINDOWS ONLY]
 
 
 
====How to open those archives====
 
 
 
====='''Windows'''=====
 
 
7-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'''=====
 
 
7-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===
 
REFER TO 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
 
 
|------------data (only few mods go here, and they almost definitely will have outside instructions)
 
 
|------------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)
 
 
 
&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;          |------------factions("Faction" files go here)
 
 
 
|------------tilesets("Tileset" files go here)
 
 
 
&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;        |------------forest
 
 
 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;        |------------winter_forest
 
 
 
|------------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;        |------------basic tutorial
 
 
 
&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:=====
+
|------------techs("Techtree" folders go here)
(WIP)
 
  
 +
|------------tilesets ("Tileset" folders go here)
  
=====If you installed Glest manually:=====
+
|------------tutorials ("Tutorial" folders go here)
(WIP)
 
  
 
----
 
----
  
====Mac OS X====
+
====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 )
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.
 
 
 
 
 
  
 +
====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).
  
====Other OSes====
+
====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).
  
(Other users please fill in)
+
====Tilesets====
 +
[[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.
  
Tip: Check the mod archive/installation directory for mod-specific instructions.
+
==See Also==
=== FILE-TYPE KEY===
+
*[[Mods/List|Wiki List of Techtrees]]
'''Faction File-----Has 3 folders within it named: "music", "units", and "upgrades".'''
+
*[[Tilesets/List|Wiki List of Tilesets]]
'''Map File---------Has a .gbm extension. '''
+
*[[Maps/List|Wiki List of Maps]]
'''Scenario File----Has a file with a .xml extension within it. '''
+
*[[Scenarios/List|Wiki List of Scenarios]]
'''Tech File--------Within it you can find two files: "factions" and "resources". '''
+
*[[MegaGlest]]
'''Tileset File-----Has 3 folders within it named: "models", "sounds", and "textures".'''
+
[[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]