mirror of
https://github.com/glest/glest-source.git
synced 2025-02-24 03:32:35 +01:00
docs dir:README.txt:noting archived docs [skip ci]
This commit is contained in:
andy5995
Andy Alt
parent
56013bee49
commit
8daaee9696
@ -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
|
||||
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user