NAME¶

stratagus - Strategy Gaming Engine

SYNOPSIS¶

stratagus [-a] [-c file.lua] [-d datapath] [-D depth] [-e] [-E file.lua] [-F|-W] [-G options] [-h] [-I addr] [-l] [-N name] [-o|-O] [-p] [-P port] [-s sleep] [-S speed] [-v mode] [-x scaler-idx] [-Z] [map.smp|map.smp.gz]

DESCRIPTION¶

This manual page documents briefly the flags that you can give to stratagus , formerly known as FreeCraft, formerly known as ALE Clone.

stratagus is a powerful game engine for building realtime strategy games.

OPTIONS¶

A summary of options is included below.

-a

Enables asserts check in engine code (for debugging)

-c file.lua

Choose a different stratagus start config file.

-d datapath

Choose a different directory to use for game data files.

-D depth

Set the video mode depth, often called 'bpp' or 'bits per pixel'. This option is only valid for Win32/NT.

-e

Start the editor included in Stratagus.

-E

Choose a different editor config file.

-F

With this option you can start Stratagus in full screen video mode.

-G lua options

The argument is passed as argument string to the lua game script. Take care to quote if spaces are used. This can be used in conjunction with -c to have custom startup routines with arguments.

-h

Show summary of all options.

-i

Enables unit info dumping into log (for debugging).

-I addr

With this option you can specify the network address for network play.

-l

Disable command log messages.

-N name

The name of the player (will appear in network games).

-o

Do not use OpenGL or OpenGL ES 1.1.

-O

Use OpenGL or OpenGL ES 1.1.

-p

Enables debug messages.

-P port

With this option you can set the network port to use in network games. The default value is port udp/6660.

-s number

Number of frames before AI awakes. This is useful if the AI is too strong and you want it to react slower. The higher, the easier will be the game against the AI. Default is to sleep 0 time frames.

-S number

Sync speed (100 = 30 frames/s).

-v mode

With this option you can specify video mode resolution in format <xres>x<yres>

-W

With this option you can start Stratagus in windowed video mode.

-x filter-idx

In OpenGL mode, this controls the pixel scaling algorithm that is run on the entire display. This runs on the GPU Fragment shader, so your card and driver need to support at least OpenGL 1.3.
-1 - OpenGL native texture scaling (disables scaling in the shader)
1 - nearest neighbour
2 - EPX/AdvMame
3 - HQx
4 - SAL
5 - SuperEagle

This is especially useful in combination with -Z, since that will keep the original size of all elements on the screen at the ratio they have at 640x480, but scales everything to the chosen video resolution using the nice pixel scaler. To try which scaler looks best at run-time, you can use Ctrl+Alt+/ to cycle between scalers.

-Z

Use OpenGL to scale the screen to the viewport. This is nice for games with assets only in one resolution, where higher screen resolutions shouldn't make everything smaller, but instead everything should be scaled up. Implies -O. Use with -x to get nicer pixel scaling.

FILES¶

./

Default directory for Stratagus data files

./scripts/stratagus.lua

Default start config file.

./scripts/editor.lua

Default editor file.

./scripts/guichan.lua

Default menu file.

~/.stratagus/<data>/preferences.lua

User preferences configuration file for <data>

~/.stratagus/<data>/logs/

User directory with replays/logs for <data>

~/.stratagus/<data>/save/

User directory with saved games for <data>

SEE ALSO¶

More complete documentation is available in /usr/share/doc/stratagus.

NOTES¶

Stratagus needs a lot of data (maps and artwork), that can come from external datasets, like Battle of Survival (BoS).

AUTHOR¶

Stratagus is written and developed by the Stratagus Team and Contributors.

This manual page was written by Anthony Towns <ajt@debian.org>, David Martínez Moreno <ender@debian.org>, Pali Rohár <pali.rohar@gmail.com>, and Tim Felgentreff <timfelgentreff@gmail.com> for the Debian GNU/Linux system (but may be used by others).