glest — A free 3d real-time customizable strategy game.




This manual page documents briefly the glest game commands and configuration.



f => toggle camera mode (game mode and free mode)
w => move camera up (only on free camera more)
s => move camera down (only on free camera more)
a => rotate camera left (only on free camera more)
d => rotate camera right (only on free camera more)
up arrow or mouse on top => move camera forward
down arrow or mouse on bottom => move camera backwards
left arrow or mouse on left => move camera left
right arrow or mouse on right => move camera right
Orders and Unit selection

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 is activated => give order
right mouse when order is activated => cancel state
number => recall group
control + number => assign group
a => activate attack command for selection
m => activate move 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 => select next producer unit
Other Keys

c => switch display color
- + => adjust game speed
p => pause game
e => save screen to TGA file
alt + enter => toggle fullscreen/windowed


Glest can be configured in three ways:

- in-game config menu: basic parameters
- configuration tool: advanced parameters
- glest.ini: all parameters

Video card hints

Auto config.

The first time you run the game it will try to detect the graphic settings most suitable for your video card. It's highly recommended that you don't change them unless you really know what you are doing. If you change the settings and you want to reset to the recommended ones, you can do it by using the auto config button in the in-game config menu.
Required card features.

The game requires either OpenGL 1.4 or OpenGL 1.3 plus the GL_ARB_env_crossbar extesion. Most video cards with recent drivers support this features. You can bypass the feature check by replacing the "CheckGlCaps=1" line in glest.ini by "CheckGlCaps=0", but the game may crash or have graphics errors.
ATI card problems.

It seems to be bug in some ATI OpenGL drivers that makes the game crash with certain card/driver configurations when using more than 1 light. Auto config will detect this issue and turn off all secondary lights when it detects an ATI card. If you still want to try running the game using more than 1 light you can change this setting in the in-game config menu.

The game features real-time shadows using different algorithms. 1) Projected: Fast shadows but they provide unit over terrain shadows only, and can produce incorrect shadows in some circumstances. 2) Shadow mapping: Slow shadows but they are always correct and provide everything over everything shadows. In ATI cards they look aliased. Both types of shadows require a video card with 3 texture unit support. Auto config will set the most suitable shadow mode for your video card.
3D textures

The game uses 3D textures for some effects like animated water. Some old video cards (ie: GeForceMX) don't support this feature by hardware and the game runs really slow when the camera is near a river. Auto config will detect this and disable 3D textures when needed.


Glest was written by Martino Figueroa et al (see readme.txt).

This manual page was written by Giuseppe Borzi <>, for the Debian project (but may be used by others).