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.

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

• Author: Alexandre Bodelot alexandre.bodelot@gmail.com
• Website: https://github.com/abodelot/cosmoscroll
• License: GPL (see LICENSE file)

• 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 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

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

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.

• title.ogg: kindly made by Mr. Megahertz
• boom.ogg: Chromium B.S.U.
• cash-register.ogg: atha89 on freesound.org
• laser-green.ogg: CGEffex on freesound.org
• end-level.ogg: metamorphmuses on freesound.org

• back_in_1982.mod
• ground_zero.mod
• hungry.mod
• spacesong.mod
• 6sievert.mod
• tempested.mod
• toxisystem.mod
• virtual_journey.mod

• hemi-head.tff: Typodermic Fonts Inc.
• Vera.ttf: Gnome Project
• VeraMono.ttf: Gnome Project