supertux26

Usage

Overview

SuperTux is a classic style 2D platform game. Run and jump through multiple worlds, fighting off enemies by jumping on them, bumping them from below or tossing objects at them, grabbing power-ups and other stuff on the way.

Options

These programs follow the usual GNU command line syntax, with long options starting with two dashes (`-'). A summary of options is included below.

-h, --help

Show this help message

-v, --version

Show SuperTux version and quit

--verbose

Print verbose messages

--debug

Print extra verbose messages

--print-datadir

Print SuperTux's primary data directory.

--acknowledgements

Print the licenses of libraries used by SuperTux.

-f, --fullscreen

Run in fullscreen mode

-w, --window

Run in window mode

-g, --geometry WIDTHxHEIGHT

Run SuperTux in given resolution (eg. -g 800x600)

-a, --aspect WIDTH:HEIGHT

Run SuperTux with given aspect ratio (eg. -a 4:3)

-d, --default

Reset video settings to default values (-g 800x600 -a auto -w)

--renderer RENDERER

Render the game using the specified video renderer. Valid values are sdl, opengl20, opengl33, and auto (the default).

--disable-sound, --disable-sfx

Disable sound effects

--disable-music

Disable music

--edit-level

Open given level in editor

--resave

Loads given level and saves it

--show-fps

Display framerate in levels

--no-show-fps

Do not display framerate in levels

--show-pos

Display player's current position

--no-show-pos

Do not display player's position

--christmas

Enable Christmas mode outside Christmas times

--no-christmas

Disable Christmas mode during Christmas times

--developer

Enable developer features

-s, --debug-scripts

Enable script debugger.

--spawn-pos X,Y

Where in the level to spawn Tux. Only used if [level] is specified.

--sector SECTOR

Spawn Tux in SECTOR

--spawnpoint SPAWNPOINT

Spawn Tux in SPAWNPOINT

--datadir DIR

Set the directory for the games datafiles

--userdir DIR

Set the directory for user data (savegames, etc.)

--repository-url URL

Set the URL to the Add-On repository

Environment

SUPERTUX2_USER_DIR

Directory for user data (savegames, etc.)

SUPERTUX2_DATA_DIR

Directory for the games datafiles

Files

~/.local/share/supertux2, ~/.supertux2

Contains configuration and savegames. Also acts as an overlay of the SuperTux game data path: Files placed here will override or supplement game data files.

Examples

To play level /tmp/mylevel.stl in a window of size 800x600, run the program like this:

supertux2 --window --geometry 800x600 /tmp/mylevel.stl

To play a previously recorded demo /tmp/mylevel.demo of level /tmp/mylevel.stl, run SuperTux like this:

supertux2 --play-demo /tmp/mylevel.demo /tmp/mylevel.stl

Custom-made levels can be conveniently stored in the overlay data folder.

~/.supertux2/levels/sample_collection/level01.stl

(supertux-level
  (version 2)
  (name (_ "Sample Level"))
  (author "Myself")
  ...

Make sure to also create an "info" file, so the collection will be recognized by SuperTux.

~/.supertux2/levels/sample_collection/info

;SuperTux-Level-Subset
(supertux-level-subset
  (title "Sample Collection")
  (description "")
)

For easier distribution, the level collection can be bundled in a Zip archive.

~/.supertux2/sample_collection.zip

levels/sample_collection/info
levels/sample_collection/level01.stl
 ...