Skip to content

abodelot/cosmoscroll

Repository files navigation

CosmoScroll

CosmoScroll is a space-based shoot'em up game. Inspired by games such as R-Type and Gradius, it features side-scrolling, retro-looking graphics and chiptune music.

cosmoscroll

This project is written in C++ with the SFML library. It also uses DUMB for playing modules files, and TinyXML for parsing XML files.

How to play?

Keyboard layout

  • Move spaceship: Up, Down, Left, Right
  • Fire: Space
  • Launch missile: A
  • Use ice cube power-up: Left Ctrl
  • Pause the game: Escap
  • Place HUD at the top of the screen: Page Up
  • Place HUD at the bottom of the screen: Page Down
  • Take a screenshot (saved in screenshots directory): F1

You can also play with a pad or a joystick. Keyboard and joystick layouts can be configured in the Options menu.

Power-ups

Power-ups are randomly dropped when an enemy is destroyed.

  • Repair: Restores 1 health point.
  • Full repair: Restores all health points.
  • Shield: Restores 1 shield point.
  • Full shield: Restores all shield points.
  • Ice cube: Gives +1 ice cube. Use an ice cube to instantly cool down the weapon system and cancel over-heat. You can store up to 5 ice cubes.
  • Missile: Gives +1 missile. One shot can destroy many enemies. You can store up to 5 missiles.
  • Double laser: Doubles laser for 10 seconds.
  • Triple laser: Triples laser for 10 seconds.
  • Speed: Increases speed for 10 seconds

How to compile?

CosmoScroll should compile on any system supported by SFML (Windows, Linux, MacOS).

First, you must install the following libraries:

  • SFML, version >= 2.4
  • sfMod (for Debian/Ubuntu, simply install the libmodplug-dev package)

Run the make command if you are using a UNIX-based system with the gcc compiler, or you can use the Code::Blocks project file (cosmoscroll.cbp).

If you want to use another compiler than gcc:

  • Make sure your compiler is c++11 compliant
  • Add the src directory in your compiler search path
  • Link against the aforementioned libraries

Configuration file

CosmoScroll saves your configuration in your application settings directory, using your operating system's convention:

  • Windows: Application Data/cosmoscroll/cosmoscroll.ini
  • Linux: ~/.config/cosmoscroll/cosmoscroll.ini
  • Mac OS: ~/Library/Application Support/cosmoscroll/cosmoscroll.ini

If you don't want CosmoScroll to store your configuration in this directory, you can set another location with the -config argument in command line.

You can reset the game by deleting this file, a new one will be created the next time the game is launched. Take note you will lost your entire configuration (scores, level progression, settings, etc.) by deleting the settings file.

Credits

Sounds

Musics

Fonts

About

Space-based shoot'em up game

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 3

  •  
  •  
  •  

Languages