SUPERTUX2(6)

✨ NAME ✨

okay so bestie, this is the page for supertux2 β€” that's SuperTux, the classic jump'n'run platformer starring everyone's favorite penguin, Tux πŸ§πŸ’–. It's a section 6 (Games) manual page, so pull up a chair, grab a snack, and let's get into it πŸŽ€


🌈 SYNOPSIS 🌈

supertux2 [options]
supertux2 [options] level.stl
supertux2 [options] worldmap.stwm

πŸ¦‹ DESCRIPTION πŸ¦‹

SuperTux is a classic style 2D platform game ✨ You run, you jump, you vibe your way through multiple worlds 🌍🌎🌏, and you deal with enemies by jumping on them, bumping them from below, or tossing objects at them 😀πŸ’₯ Along the way you grab power-ups and other stuff, because obviously πŸ’…

It's giving pure nostalgia, no cap.


πŸ’… OPTIONS πŸ’…

These programs follow the usual GNU command line syntax, with long options starting with two dashes (-). A summary of options is included below, and yes, we're doing all of them because every single one matters 🫢

  • -h, --help β€” Show this help message πŸ™‹β€β™€οΈ
  • -v, --version β€” Show SuperTux version and quit πŸ‘‹
  • --verbose β€” Print verbose messages πŸ—£οΈ
  • --debug β€” Print extra verbose messages πŸ—£οΈπŸ—£οΈ (yes, even more)
  • --print-datadir β€” Print SuperTux's primary data directory πŸ“
  • --acknowledgements β€” Print the licenses of libraries used by SuperTux πŸ“œ (credit where it's due, periodt)
  • -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 πŸŽ„ (festive whenever you want, iconic)
  • --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 ⭐
  • --record-demo FILE LEVEL β€” Record a demo to FILE ⏺️
  • --play-demo FILE LEVEL β€” Play a recorded demo ▢️
  • --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. πŸ‘‘ (so yeah, whatever you drop in here wins, iykyk)

⭐ EXAMPLES ⭐

Wanna play the level /tmp/mylevel.stl in a window that's 800x600? Run it like this, bestie:

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

Wanna replay a previously recorded demo /tmp/mylevel.demo of the level /tmp/mylevel.stl? Do it 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
 ...

πŸ’€ BUGS πŸ’€

This is a development version, so expect plenty of bugs. 😭 Not me warning you in advance, but like, genuinely β€” development version, lots of bugs. You've been told 🫢


πŸ‘‘ AUTHOR πŸ‘‘

This manual page was written by the SuperTux Devel Team and is placed in the public domain. Respect the icons who wrote it πŸ’–


okay that's the whole thing, you're officially a supertux2 expert now 🌟 this was SuperTux 0.6.3, dated December 20, 2021 β€” mwah, slay, go jump on some enemies bestie πŸ’…πŸ§πŸ’–