Free and Open Source real time strategy game with a new take on micro-management

Difference between revisions of "Download and Install"

From Globulation2

Jump to: navigation, search
Line 72: Line 72:


== Compile from Sources ==
== Compile from Sources ==
{{Warning|Compiling on Windows|The instructions below will not work for Windows. To compile on that OS, please see the [[Mingw compilation]] guide, which explains how to compile globulation2 on windows using mingw.}}


For source and Mercurial installations, you'll also need to install these packages:
For source and Mercurial installations, you'll also need to install these packages:
Line 82: Line 83:
* [http://www.xiph.org/ libogg and libvorbis] can be found in their download-section. libspeex, too.
* [http://www.xiph.org/ libogg and libvorbis] can be found in their download-section. libspeex, too.
* [http://zlib.net/ zlib]
* [http://zlib.net/ zlib]
* [http://boost.org/ Boost C++ Libraries] download boost and boost-devel
* [http://boost.org/ Boost C++ Libraries] download boost and boost-devel (needs libthread library!!!)


Optional:
Optional:
Line 88: Line 89:


=== Source Distribution ===
=== Source Distribution ===
{{Warning|Warning|You must make sure that you have all of the libraries that glob2 requires installed first. Also, read the README and INSTALL files in the archive for more information}}

* Get the [[#downloadlink_source|source distribution archive]] from the download section above.
* Get the [[#downloadlink_source|source distribution archive]] from the download section above.
* Extract the archive using a compression/extraction utility such as tar.
* Extract the archive using a compression/extraction utility such as tar.
* Go in the extracted archive. If you have a Unix system (Linux, Solaris, Mac OS X):
* Go in the extracted archive. If you have a Unix system (Linux, Solaris, Mac OS X):
** Run the ''./configure'' script. If you want to install the game in a special place, type ''./configure --prefix=/path/to/install'' instead.
** Run the 'scons' script to compile the game (it will check dependencies, install any you have missing)
*** If you want to install the game in a special place, instead of 'scons', type:
** Compile Globulation 2 by running ''make''.
****scons BINDIR="/path/to/install/bin" INSTALLDIR="/path/to/install/share".
** Install with a simple ''make install'' command.
** Install with a simple 'scons install' command (will install to the location you might have entered when compiling (BINDIR and INSTALLDIR)).
** Run the game by typing ''glob2''. If it doesn't work, type ''/path/to/install/bin/glob2'' instead.
** Run the game by typing 'glob2'. If it doesn't work, type '/path/to/install/bin/glob2' instead.


=== Sources from [[Mercurial]] ===
=== Sources from [[Mercurial]] ===
{{Warning|Warning|Mercurial is often unstable and will break, it is meant for testing purposes.}}
{{Warning|Warning|Mercurial is occasionally unstable and will break, it is meant for testing purposes.}}
==== Compilation & cross compilation for Windows with mingw ====
:* [[Mingw compilation|Compile glob2 with mingw]] - explains how to compile globulation2 on windows using mingw.
:* [[Mingw_cross_compilation| Cross compile glob2]] - explains how to compile globulation2 for windows on Debian

==== Compilation on other systems ====
* Download the source code from the Mercurial by typing
* Download the source code from the Mercurial by typing
:hg clone http://hg.globulation2.org/glob2/
:hg clone http://hg.globulation2.org/glob2/
:hg clone -r master glob2 glob2-master
:* You can update the source code you have any time with a simple
:* You can update the source code you have any time with a simple
::cd glob2
::hg pull && hg update
::hg pull
::cd ../glob2-master
::hg pull -r master ../glob2
::hg update tip
* Read the README.hg and README files.
* Read the README.hg and README files.
* Get the graphics by running the ''./syncdata'' script in the Mercurial tree.
* Get the graphics by running the './syncdata' script in glob2_source.
* You can also get some maps by running the ''./syncmaps'' script.
* You can also get some maps by running the './syncmaps' script in the same location.
* Continue by following the [[#Source_Distribution|''source distribution'']] instructions from the 3rd step onwards.
* Run the ''./bootstrap'' script from the Mercurial tree. If it doesn't work, check that SDL is installed in aclocal's path. If it is not the case (with Mac OS X, for example), run ''aclocal -I /usr/local/share/aclocal'', where /usr/local/share/aclocal is the location of SDL's aclocal macros. Then, run the remaining commands of the ''bootstrap'' script (''autoheader && automake --add-missing && autoconf'').
* Continue by following the instructions in installing from a [[#Compile_from_Sources|''source distribution'']].


[[Category:User Manual]]
[[Category:User Manual]]

Revision as of 05:29, 29 July 2007

English | Français | Deutsch | Español | Italiano | Česky | Română | Русский | Català | Suomi | Japanese | Русский | Chinese

If you have installed the game but still have problems running it or if you cannot compile the source distribution, try to look at Frequently Asked Questions page, where a section is related to installation problems.

Latest Release

You can still download the Older Releases. They can sometimes be useful if you want a binary for a system that has not been packaged yet for latest release. Please keep in mind that Internet game will most likely not work with older releases. (See What version should i choose to play in the FAQ.)

Installation by Operating System and Distribution:

Debian GNU/Linux

  • Please download the latest .deb package from the download section above, and install it as you would install any ordinary debian package:
    • In root (or sudo), install it with dpkg -i glob2_VERSION.deb.
    • If you miss some dependencies, do an apt-get -f install as root (or sudo). Do NOT remove the glob2 package before apt-get -f install.
  • You can now run Globulation 2 by typing glob2.
  • If you are using Debian unstable, you can also use the integrate glob2 package but it is not as up to date.

Ubuntu Linux

  • Please download the latest .deb package from the download section above, and install it as you would install any ordinary package:
    • Install it with sudo dpkg -i glob2_VERSION.deb. You need to enter your user password.
    • If you miss some dependencies, do a sudo apt-get -f install. Do NOT remove the glob2 package before apt-get -f install.
  • You can now run Globulation 2 by typing glob2.
  • If you are using Ubuntu Breezy or newer, you can also use the integrated glob2 package but it is not as up to date.

Fedora Core

  • There are some Fedora packages (.rpm) under the download section above
  • You may find some other fedora packages on this fan-site

Gentoo GNU/Linux

  • An ebuild exists, and is in portage. To install, just execute (as root): emerge glob2
  • Make sure you are in the games group

Arch Linux

  • A package exists in the community repository. To install, execute (as root): pacman -Sy glob2
    • Make sure the community repository is enabled in pacman.conf

Source Mage GNU/Linux

  • A spell exists. Make sure that games grimoire is up to date, and execute (as root): cast globulation2

Mandriva Linux

  • Please download the latest rpm package from the download section above, and install it as you would install any other rpm:
    • Double click it to start the installation. When prompted, enter your root password. It will do the rest.
    • When it says installation is complete, click "Ok". Go to the menu and click "Run Command".
    • When the command box pops up, type "glob2" and it should load automatically.

Microsoft Windows

  • Download the latest runtime package and unzip it anywhere.
  • Open the folder glob2_runtime and double click glob2.exe
to uninstall, just remove the directory "glob2_runtime" where you extracted the .zip.

Mac OS X

  • Mount the disk image file, and start the installer from it.
  • Globulation gets installed in /Applications/Globulation2.
  • To run the game, open /Applications/Globulation2/Globulation2.

FreeBSD

  • A port exists and binary packages are built for different platforms.
  • See FreeBSD port.

Compile from Sources

Compiling on Windows: The instructions below will not work for Windows. To compile on that OS, please see the Mingw compilation guide, which explains how to compile globulation2 on windows using mingw.

For source and Mercurial installations, you'll also need to install these packages:

Optional:

Source Distribution

  • Get the source distribution archive from the download section above.
  • Extract the archive using a compression/extraction utility such as tar.
  • Go in the extracted archive. If you have a Unix system (Linux, Solaris, Mac OS X):
    • Run the 'scons' script to compile the game (it will check dependencies, install any you have missing)
      • If you want to install the game in a special place, instead of 'scons', type:
        • scons BINDIR="/path/to/install/bin" INSTALLDIR="/path/to/install/share".
    • Install with a simple 'scons install' command (will install to the location you might have entered when compiling (BINDIR and INSTALLDIR)).
    • Run the game by typing 'glob2'. If it doesn't work, type '/path/to/install/bin/glob2' instead.

Sources from Mercurial

Warning: Mercurial is occasionally unstable and will break, it is meant for testing purposes.
  • Download the source code from the Mercurial by typing
hg clone http://hg.globulation2.org/glob2/
hg clone -r master glob2 glob2-master
  • You can update the source code you have any time with a simple
cd glob2
hg pull
cd ../glob2-master
hg pull -r master ../glob2
hg update tip
  • Read the README.hg and README files.
  • Get the graphics by running the './syncdata' script in glob2_source.
  • You can also get some maps by running the './syncmaps' script in the same location.
  • Continue by following the source distribution instructions from the 3rd step onwards.
Misc