File: README.compiling-linux.txt

package info (click to toggle)
megaglest 3.13.0-6
  • links: PTS, VCS
  • area: main
  • in suites: bookworm, bullseye, sid
  • size: 12,960 kB
  • sloc: cpp: 144,280; ansic: 11,861; sh: 3,233; perl: 1,904; python: 1,751; objc: 142; asm: 42; makefile: 22
file content (174 lines) | stat: -rw-r--r-- 5,169 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174

                                  MEGAGLEST

                     by Titus Tscharntke and Mark Vejvoda

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
                         Build instructions for Linux
~~~~~~~~~~~~~~~~~~~~~~~~~~~ 1. Architecture ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Developed on Linux with glibc, little endian CPU. While MacIntel builds exist
(for some versions of the game), MegaGlest does not currently work on big
endian CPUs like PPC (though some unfinished patches for vanilla Glest float
around on the forums, e.g. http://forum.megaglest.org/?topic=1426#).

~~~~~~~~~~~~~~~~~~~~~~ 2. Building and Installation ~~~~~~~~~~~~~~~~~~~~~~~~~~~

--- 2.1 Prerequesites ---

Compiling MegaGlest requires the following dependencies to be installed:

* Standard GNU compiler and additional tools (g++ version 4.6.3 or later is
  required at the moment)

* Kitware CMake 2.8.2 or later (used as build tool)

* X11 libraries + headers
  http://x.org/

* SDL 2.0.0 or later
  http://libsdl.org/

* OpenGL
  http://dri.freedesktop.org/wiki/libGL

* libvlc
  http://www.videolan.org/vlc/libvlc.html

* libcurl
  http://curl.haxx.se/libcurl/

* wxWidgets
  http://wxwidgets.org/

* OpenAL
  http://openal.org/

* Ogg
  http://xiph.org/ogg/

* Vorbis
  http://xiph.org/vorbis/

* Xerces-C
  http://xerces.apache.org/xerces-c/

* Lua 5.1 or later
  http://www.lua.org/

* JPEG
  http://www.ijg.org/

* PNG
  http://www.libpng.org/

* Zlib
  http://zlib.net/

* GnuTLS
  http://www.gnu.org/software/gnutls/

* ICU
  http://site.icu-project.org/

* libdl

NOTE: A script which tries to install build dependencies on many Linux distros
is located in mk/linux/setupBuildDeps.sh

--- 2.2 Building ---

To build the game simply invoke the build script:

../mk/linux/build-mg.sh

This script manually calls cmake with some optional parameters. Feel free to 
examine it and build manually using cmake.

--- 2.3 Installation --

We provide MojoSetup based installers for Linux and NSIS based installers for
Windows. By default, the Linux installers install to your home directory. The
Windows installers install to %ProgramFiles% (global system scope).

There are also community maintained packages available for several Linux and
BSD distributions. Please see the website, forums and wiki for details.


~~~~~~~~~~~~~~~~~~~~~~ 3. Troubleshooting ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

--- General ---
* Make sure both the hardware and software of your system match the requirements
* If you cannot find what you are looking for on here please check the FAQs
  (https://docs.megaglest.org/MG/FAQ) before contacting the developers.

--- Compiling ---
* If CMake reports that it cannot find some of the libraries, make sure that 
  the relevant ...-dev(el) packages are also installed (distro-dependent).

--- Sound/Audio ---
* If the game doesn't start because of audio/sound errors:
  Make sure no other application is using your soundcard. Typical problems are
  the Gnome/KDE sound dameons esd and artsd. You can kill these daemons with
  the following commands:
  	# killall esd ; killall artsd

* If this doesn't solve the sound problems, get an updated OpenAL from
  http://openal.org or a newer repository provided by your distribution.

* Sound is played through OpenAL - double-check the OpenAL system 
  configuration: http://supertux.lethargik.org/wiki/OpenAL_Configuration

--- OpenGL  ---
* If the game produces error messages regarding OpenGL or OpenGL extensions
  being unavailable, look at glxinfo and make sure the system is using the 
  drivers you want to use. If you have a NVIDIA or AMD/ATI graphics card then 
  consider using the proprietary drivers, which may provide better 
  performance than the open source drivers most distributions use by default.
  Most Intel graphics chips use an open source driver on Linux, based on Mesa
  ("glxinfo | grep -i mesa"). This hardware is much slower than any dedicated
  graphics cards produced during the past few years. The same holds true for
  AMD APUs (the graphics chips embedded into AMD processors).

--- Crashing ---
* Check the forums at http://forums.megaglest.org/
* Please report any crashes and freezes that are not yet described on the forums, 
  preferably with a gdb backtrace from a debugging enabled build 
  (cmake -DCMAKE_BUILD_TYPE=RelWithDebInfo)


~~~~~~~~~~~~~~~~~~~~~~~~~~ 4. More information ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

* Website
  http://megaglest.org/

* Wiki
  https://docs.megaglest.org/Main_Page

* Forums
  http://forums.megaglest.org/

~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 5. Contact + Credits ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* MegaGlest is developed by:
    Titus Tscharntke (info@titusgames.de)
    Mark Vejvoda (www.soft-haus.com - mark_vejvoda@hotmail.com)

* General contact:
    contact@megaglest.org

* MegaGlest is a fork of Glest:
    http://glest.org/

* Linux port by:
    Matthias Braun 
    <matze@braunis.de> 
  
    with help from 
  
    Karl Robillard
    <krobbillard@san.rr.com>

*** Please also refer to the copyright file. ***

On Debian GNU/Linux systems please find license information in: 
/usr/share/common-licenses