Megaglest fork
Go to file
Mark Vejvoda dfe194fa10 - cmake now somewhat split out into binaries and data, likely needs a little tweaking and final touches, good night for now :) 2011-05-04 07:51:48 +00:00
docs Another attempt to somewhat clean up documentation files. 2011-05-03 10:28:54 +00:00
mk - default to dynamic libs since most (if not ALL) distros hate static linking, still support it for our own installer: 2011-05-04 07:31:18 +00:00
source - cmake now somewhat split out into binaries and data, likely needs a little tweaking and final touches, good night for now :) 2011-05-04 07:51:48 +00:00
CMakeLists.txt - cmake now somewhat split out into binaries and data, likely needs a little tweaking and final touches, good night for now :) 2011-05-04 07:51:48 +00:00
build-mg-win32.sh Another attempt to somewhat clean up documentation files. 2011-05-03 10:28:54 +00:00
build-mg.bat - added CMAKE support for building MG in Windows using MingW 2010-12-11 06:56:19 +00:00
build-mg.sh * Rename docs/readme.txt to docs/copyright.txt 2011-05-03 04:27:37 +00:00

docs/README.txt

                                  MEGAGLEST

                     by Titus Tscharntke and Mark Vejvoda

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
                              MegaGlest README
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

                                  Contents:

1. System requirements
2. Installation
3. Configuration
4. Controls
5. Network play
6. Command line options
7. Support and further information


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~


1. System requirements

Hardware requirements:
* 6th generation x86 CPU with 1.5 GHz or better
  (modern CPU series with at least two cores of at least 1.5 Ghz recommended)
* 1.0 GB RAM
  (2.0 GB recommended)
* Graphics chip supporting OpenGL 1.3 with GL_ARB_env_crossbar and shader
  extensions (=OpenGL 1.4 or glUseProgramObjectARB etc.) or higher
  (dedicated video card with hardware 3D acceleration recommended)
* Audio chip supporting OpenAL

Software requirements:
* A supported (by its producer) operating system version
* Graphics drivers which work well with this operating system version and
  support the OpenGL requirements discussed above
* Audio drivers supporting OpenAL
* A file archiving utility which provides a command line interface and can
  decompress 7-zip archives

The MegaGlest Team currently provides builds and Installers for Linux and
Windows. The Linux version is available in 32 and 64 bit variants which have
been reported to run on Ubuntu 8.04 to 11.04, various versions of Debian,
OpenSuSE 11.1 to 11.3, and many other distributions. The Windows version runs
on 32 and 64 bit variants of Windows and has been reported to run on Windows
versions up to and including Windows 7.

There are also distribution maintained or community provided distribution
specific packages available for several Linux and BSD distributions and OS X.
Please see the website, forums and wiki for details.

Graphics hardware and drivers:
Current dedicated Nvidia and ATI hardware with vendor-supplied proprietary
drivers installed will provide the best experience. MegaGlest also runs fine on
most integrated Intel GMA, Nvidia and ATI GPUs, but you will feel an urge to 
reduce effects.

Issues with proprietary drivers for 'legacy' ATI hardware have been and are
continuously reported. On Linux, open source 3D drivers are now (Linux 2.6.38,
Gallium 0.4 via DRI) starting to become usable for both many current and
legacy GPUs, and may help with the proprietary drivers' shortcomings.


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

2. Installation

Linux:
Note that due to the various Linux window manager variants we can only provide
generic installation instructions here. Please check the FAQ and read up on the
forums for more verbose instructions.

After downloading the installer package, you need to make it executable. Use
your file manager/browser to browse to the directory containing the downloaded
file. Right-click the file, select the option to inspect and change this files'
properties/permissions, and make the file executable by its owner. Now double-
click the file to execute it.

The graphical installer will show up and display the MegaGlest license. Install
the game into your home directory (default location) or a location of your 
choice (within the boundaries of where your Linux user may write to, so
probably anywhere below your home directory only). Once the installer
completes, a MegaGlest starter/shortcut will show up on your window managers'
application menu.

Windows:
All you should need to do on Windows is to double-click the downloaded file.
You may get to see a warning saying that this file you downloaded from the
Internet may be unsafe. However, if you downloaded this file from a trusted
source, such as http://megaglest.org/, it is safe to proceed.


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

3. Configuration

MegaGlest can be configured in three ways:
- in-game config menu: basic parameters
- using the separate configuration utility
- manual editing of glestuser.ini (options) and glestuserkeys.ini (hotkeys)

DO NOT directly edit glest.ini and glestkeys.ini but rather edit glestuser.ini
and glestuserkeys.ini and create your user over-ride values in these files.

On Linux, these files are located in ~/.megaglest/. On Windows, these files are
stored at %AppData%\megaglest (Windows XP) or %AppData%\roaming\megaglest (any
later version). '%AppData%' is an environment variable which may point to a 
different location depending on your login name and Windows version.


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

4. Controls

Most (if not all) keyboard controls are defined in glestkeys.ini and should be
changed ONLY in the user defined file called glestuserkeys.ini (which overrides
the default keyboard values).


* Camera keyboard controls *

f                                => toggle free camera mode
w                                => move camera up (free camera mode only)
s                                => move camera down (free camera mode only)
a                                => rotate camera left (free camera mode only)
d                                => rotate camera right (free camera mode only)
g                                => center camera on selection
space                            => reset camera to default position
up arrow or mouse on top         => move camera forward
down arrow or mouse on bottom    => move camera backward
left arrow or mouse on left      => move camera left
right arrow or mouse on right    => move camera right


* Orders and Unit selection keyboard controls *

left mouse button                => select or deselect units
shift + left mouse button        => add unit to selection
control + left mouse button      => remove unit from selection
left mouse double click          => select nearby units of this type
right mouse button               => auto order
menu click                       => activate order
left mouse when order activated  => give order
right mouse when order activated => cancel state
number                           => recall group
control + number                 => assign group


* Network keyboard controls*

enter                            => start typing/send chat message
h                                => toggle between 'All' and 'Team' chat modes
n                                => show network status


* Hotkeys (game camera mode only) *

a                                => activate attack command for selection
s                                => issue stop command to selection
i                                => select next idle harvester
b                                => select next building
d                                => select next damaged unit
t                                => select next storage unit
r                                => rotate building before placement


* Other Keys *

- +                              => adjust game speed (disabled in multiplayer)
p                                => pause game (disabled in multiplayer)
e                                => save screen shot to file
c                                => toggle ingame font color (and font shadow)
m                                => show faded mesages again
?                                => when DebugMode=true, display debug info
/                                => toggle mouse pointer rendering mode (OS/MG)


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

5. Network play

To start a network game, one of the players has to create a new game, open some
network slots and the other players have to join.

The best ways to find people to play a multi-player game are:
a) using the Internet Game menu
b) scheduling a game on the Glest forums
c) finding other players on the #glest IRC channel on irc.freenode.net.

For LAN play, clients may click the 'Find LAN games' menu item to find servers
with an open network slot on the local network (this uses UDP broadcasting).

For Internet play there is an Internet Game menu item which allows clients to
find published servers. Players who wish to host Internet games (servers) may
'publish' their game to the masterserver via the 'Publish on Masterserver
option in the Custom Game menu.

If you want to host games, you should know that MegaGlest uses TCP ports
61357-61366 by default. If you are behind a router you will have to forward
these ports to the LAN IP address of your computer. These ports may be changed
via glestuser.ini.

All players have to be using the same binaries of the game and have exactly
the same map, tileset and tech tree. This means that if you have mods installed
in the tech tree that is being used for the game, every player has to have the
same mods.


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

6. Command line options

megaglest                            => start game normally
megaglest --version                  => display the version string
megaglest --server                   => start in the custom game screen
                                        with all slots open
megaglest --client ServerIp          => start game connecting to a server

On Windows, replace 'megaglest' by 'glest_game' for now.


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

7. Support and further information

Further information:

- The MegaGlest website:
  http://megaglest.org

- The MegaGlest wiki:
  http://wiki.megaglest.org

- Contact us (see below)


Support:

Please keep in mind that this is a completely volunteer run project. We do this
in our spare time and look forward to meet people who try to fix problems on
their own by reading up on available documentation before getting in touch.

- The MegaGlest FAQ:
  http://faq.megaglest.org

- Post to the forums:
  If you are reporting a bug, please be sure to read the bug reporting guide.
  http://forums.megaglest.org

- Contact us on IRC:
  Network: irc.freenode.net
  Channel: #glest
  Or use the webchat at http://chat.megaglest.org/