MCPcopy Create free account
hub / github.com/SuperTux/supertux

github.com/SuperTux/supertux @v0.7.0-rev.1

Chat with this repo
repository ↗ · DeepWiki ↗ · release v0.7.0-rev.1 ↗ · + Follow
8,319 symbols 18,858 edges 1,045 files 548 documented · 7% updated 2d agov0.7.0 · 2026-03-15★ 3,093284 open issues

Browse by type

Functions 6,931 Types & classes 1,388
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

SuperTux

Windows MacOS GNU/Linux Android FreeBSD WebAssembly Github All Releases

SuperTux is a jump'n'run game with strong inspiration from the Super Mario Bros. games for the various Nintendo platforms.

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.

Screenshot

Story: Penny gets captured!

Tux and Penny were out having a nice picnic on the ice fields of Antarctica. Suddenly, a creature jumped from behind an ice bush, there was a flash, and Tux fell asleep!

When Tux wakes up, he finds that Penny is missing. Where she lay before now lies a letter:

Tux, my arch enemy! I have captured your beautiful Penny and have taken her to my fortress. The path to my fortress is littered with my minions. Give up on the thought of trying to reclaim her, you haven't got a chance!

-Nolok

Tux looks and sees Nolok's fortress in the distance. Determined to save his beloved Penny, he begins his journey.

Installation

For major platforms, stable releases are built and available for download from supertux.org or alternatively directly from GitHub. You should be able to install these using default tools provided by your platform. On macOS, when Gatekeeper is enabled (default) it will refuse to open SuperTux. This is due to the lack of a signature on the application. If you wish to open SuperTux anyway without disabling the Gatekeeper feature entirely, you can open the application from the context menu (control click on the icon). macOS will then remember your choice the next time.

Documentation

Important documentation for SuperTux is contained in multiple files. Please see them:

  • INSTALL.md - Requirements, compiling and installing.
  • README.md - This file
  • NEWS.md - Changes since the previous versions of SuperTux.
  • LICENSE.txt - The GNU General Public License, under whose terms SuperTux is licensed. (Most of the data subdirectory is also licensed under CC-by-SA)
  • data/credits.stxt - Credits for people that contributed to the creation of SuperTux. (You can view these in the game menu as well.)

Playing the game

Both keyboards and joysticks/gamepads are supported. You can view/change the controls via options > controls. Basically, the only controls you will need to use in-game are the following: jump, duck, move left & right, do an action, and use the item pocket. An "action" allows you to pick up objects and use any powerup you have, such as shooting fireballs with the fire flower, or to fire ice pellets with the ice flower. The item pocket allows you to store a single additional item, which can be useful in dire situations.

Other useful keys include the Esc key, which is used to go to the menu or to go up a level in the menu. The menu can be navigated using the arrow keys or the mouse.

Community

In case you need help, feel free to reach out using the following means:

  • IRC: #supertux on Libera Chat hosts most of the discussions between developers. Also, real-time support can be provided here. If you don't know how to use an IRC client, you access the channel using a web-based client. Please stay around after asking questions, otherwise you will be disconnected and might miss potential answers.
  • Forum: The SuperTux community is also active on the forum, the discussions range from feature proposals to support questions. In particular, most community-contributed add-ons are published there, so this is worth checking.
  • Social Media: Mostly on Twitter at the moment.
  • Discord: Also, you can join our Discord server to get in touch with us.

Core symbols most depended-on inside this repo

Shape

Method 6,552
Class 1,205
Function 379
Enum 183

Languages

C++99%
C#1%
C1%
Python1%
Java1%
Ruby1%

Modules by API surface

src/editor/object_option.hpp79 symbols
src/object/player.cpp77 symbols
src/object/custom_particle_system.hpp73 symbols
src/object/custom_particle_system.cpp71 symbols
src/object/player.hpp60 symbols
src/squirrel/supertux_api.cpp56 symbols
src/editor/overlay_widget.cpp56 symbols
src/editor/editor.cpp53 symbols
src/badguy/badguy.cpp49 symbols
src/supertux/game_object_manager.cpp45 symbols
src/supertux/game_object.hpp43 symbols
src/object/tilemap.cpp43 symbols

For agents

$ claude mcp add supertux \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page