mirror of
https://github.com/glest/glest-source.git
synced 2025-08-24 08:52:49 +02:00
docs dir:README.txt:noting archived docs [skip ci]
This commit is contained in:
andy5995
Andy Alt
@@ -1,174 +0,0 @@
|
|||||||
|
|
||||||
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
|
|
||||||
@@ -1,152 +0,0 @@
|
|||||||
|
|
||||||
MEGAGLEST
|
|
||||||
|
|
||||||
by Titus Tscharntke and Mark Vejvoda
|
|
||||||
|
|
||||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
||||||
Build Instructions for Windows
|
|
||||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
||||||
|
|
||||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 1. Architecture ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
||||||
|
|
||||||
Developed on Windows with Microsoft Visual Studio Community 2015,
|
|
||||||
little endian CPU. Compiling using the mingw32 toolset is experimental, which
|
|
||||||
also allows for cross compiling.
|
|
||||||
|
|
||||||
On Debian GNU/Linux systems please find license information in:
|
|
||||||
/usr/share/common-licenses
|
|
||||||
Also see Build Instructions for Linux
|
|
||||||
|
|
||||||
~~~~~~~~~~~~~~~~~~~~~~~~ 2. Building and Installation ~~~~~~~~~~~~~~~~~~~~~~~~
|
|
||||||
|
|
||||||
--- 2.1 Prerequesites ---
|
|
||||||
|
|
||||||
To build the game, the following tools and libraries must be present:
|
|
||||||
|
|
||||||
- Pick 1:
|
|
||||||
* Microsoft Visual Studio Community 2015
|
|
||||||
https://www.microsoft.com/en-us/download/details.aspx?id=48146
|
|
||||||
(Experimental Microsoft Visual C++ Express 2012 projects also exist in the vc2012
|
|
||||||
folder)
|
|
||||||
* mingw32
|
|
||||||
http://mingw.org/
|
|
||||||
|
|
||||||
- Pick 1:
|
|
||||||
* MegaGlest dependencies for building with VC++, which which will be downloaded
|
|
||||||
automatically in 'Option A' (see below)
|
|
||||||
* MegaGlest Windows 32 bit dependencies for building with mingw:
|
|
||||||
https://github.com/MegaGlest/megaglest-source/releases/download/3.2.3/win32_deps_mingw.7z
|
|
||||||
|
|
||||||
- These include:
|
|
||||||
* Xerces-C
|
|
||||||
http://xerces.apache.org/xerces-c/
|
|
||||||
* wxWidgets
|
|
||||||
http://wxwidgets.org/
|
|
||||||
* And many more. For a more verbose list, please inspect the archive contents and refer to the
|
|
||||||
Linux build instructions.
|
|
||||||
|
|
||||||
|
|
||||||
--- 2.2 Building ---
|
|
||||||
|
|
||||||
To build and install the game proceed as follows:
|
|
||||||
|
|
||||||
*** Option A ~ (recommended) Automated build on the command line:
|
|
||||||
|
|
||||||
1. Open a command prompt and navigate to the root folder where you have acquired the source code.
|
|
||||||
|
|
||||||
2. cd mk\windows
|
|
||||||
|
|
||||||
3. build-mg-2015.bat (or build-mg32bit-2015.bat for 32 bit build)
|
|
||||||
|
|
||||||
4. megaglest.exe --version
|
|
||||||
|
|
||||||
5. megaglest.exe
|
|
||||||
|
|
||||||
*** Option B ~ Using VC++ IDE:
|
|
||||||
|
|
||||||
1. Download the dependencies archive (which one and from where you can find
|
|
||||||
out in the "code" of build-...bat script from 'Option A' approach, some line
|
|
||||||
with "wget.exe") and decompress its contents into the 'source' directory. This
|
|
||||||
should create a subdirectory called "windows_deps..." with many files and
|
|
||||||
subdirectories in it.
|
|
||||||
|
|
||||||
2. Start the Visual C++ 2015 IDE and open the solution file:
|
|
||||||
\mk\windows\Glest_vc2015.sln
|
|
||||||
|
|
||||||
3. Right Click on the top level 'Glest' node in Solution Explorer and select
|
|
||||||
'Rebuild All' (choose release mode or release with debug info).
|
|
||||||
|
|
||||||
Note: If you had no errors all binaries will be created.
|
|
||||||
Before running MegaGlest you must run CopyWindowsRuntimeDlls_2015.bat.
|
|
||||||
You should now be able to just run megaglest.exe.
|
|
||||||
|
|
||||||
|
|
||||||
--- 2.3 Installation ---
|
|
||||||
|
|
||||||
We provide NSIS based installation packages. By default, these will create a
|
|
||||||
system-wide installation below %ProgramFiles% and setup Desktop icons for
|
|
||||||
simplified access. User specific configuration will be stored within the
|
|
||||||
directory tree the %AppData% environment variable points to.
|
|
||||||
|
|
||||||
|
|
||||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 3. Troubleshooting ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
||||||
|
|
||||||
--- General ---
|
|
||||||
* Make sure that 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.
|
|
||||||
|
|
||||||
--- Compiling ---
|
|
||||||
* If configure fails make sure you have read the Building section above
|
|
||||||
|
|
||||||
--- Sound/Audio errors when starting ---
|
|
||||||
* If the game doesn't start because of audio/sound errors:
|
|
||||||
Make sure no other application is using your soundcard.
|
|
||||||
* If this doesn't solve your sound problems try to get an updated OpenAL from
|
|
||||||
http://openal.org
|
|
||||||
* Sound is played through OpenAL - you might need to take a look at your
|
|
||||||
configuration: http://supertux.lethargik.org/wiki/OpenAL_Configuration
|
|
||||||
|
|
||||||
--- The game complains that OpenGL 1.3: is not available, is missing OpenGL
|
|
||||||
extensions, or works very slowly ---
|
|
||||||
* Try to get updated graphics drivers.
|
|
||||||
|
|
||||||
-- The game crashes ---
|
|
||||||
* Check the forums at http://forums.megaglest.org/
|
|
||||||
* Please report any other crashes and freezes that are not yet described on
|
|
||||||
the forums, preferably with a backtrace from a debugging enabled build
|
|
||||||
|
|
||||||
~~~~~~~~~~~~~~~~~~~~~~~~~~ 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. ***
|
|
||||||
@@ -1,3 +1,7 @@
|
|||||||
|
The documents in this directory are here for historical purposes and pertain
|
||||||
|
to MegaGlest, not ZetaGlest. To view active documentation for ZetaGlest, see
|
||||||
|
https://github.com/ZetaGlest/zetaglest-source and https://zetaglest.github.io/docs/
|
||||||
|
|
||||||
|
|
||||||
MEGAGLEST
|
MEGAGLEST
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user