README.md

Beats from Outer Space

Hello there, Terrarians! I'm your mysterious radio host, Midnight, and I have a story to share with you. It's the tale of a brave space hero, who pilots the magnificent Vapor Falcon in a battle against the body snatching aliens from outer space.

As you may know, the aliens have set their sights on Terra, our beloved home planet. They want to take over our bodies and use us as their own personal puppets. But our hero, with the help of the Vapor Falcon, is determined to stop them at all costs.

Our hero will face many challenges and obstacles. They must navigate through treacherous asteroid fields, dodge laser blasts from enemy ships, and outsmart the cunning alien invaders. But with their quick reflexes and sharp shooting skills, our hero is more than capable of taking on whatever comes their way.

In the end, it all comes down to a final showdown between the Vapor Falcon and the Mother Ship of the alien invaders. Will our hero be able to save Terra and protect the human race from being enslaved? Tune in to find out! Until then, stay safe out there and keep your eyes peeled for any signs of the menacing aliens. This is Midnight signing off.

Controls

Controls are intended to be "single finger" only utilizing gestures for the different movements and attacks. Following Controls are already implemented:

• When touching the screen the game starts:

  • Time runs normally

  • Player shoots automatically

  • Music plays unaltered

    

• Lifting the finger from the screen causes:

  • Game time slows down drastically

  • Player stops shooting

  • music pitch lowers causing a slow down effect

    

• Dragging the finger will:

  • let the player ship move towards a point slightly in front of the players finger
  • the ship movement does have a max velocity and will trail behind the finger if the player is too fast
  • max velocity is a prerequisite to perform a maneuver

• Currently the only supported maneuver is the "parry":

  • If a enemy is loading a special attack the player may risk to swish their finger towards, close to the enemy and immediately back

    

  • This causes the player to spin and hit the enemy causing a lot of damage while receiving none

    

  • If the enemy health reaches zero after the parry the enemy will explode catapulting debris around harming nearby enemies

    

  • This debris may cause other ships to explode causing a chain reaction

Balancing

For the future some aspects need to be addressed:

• Parry:
  • timing for enemy loading and reaching this enemy must be tested and balanced
  • Considering enemy health > parry damage with some visual cue to make the player strategize when to use the parry

Music and Effects

Music shall be an integral part of the game. Music pitch and also single instruments shall be effected by the player and enemy movement and attacks.

Contribute

• Download the Godot Engine from here

• Try out Godot following the getting started page in the Godot Docs

• Clone or Fork this repository

      git clone https://github.com/lombardi-antonio/beats-from-outer-space.git path/to/desired/folder

• When starting Godot click on Scan and navigate to the project folder

• You should be able to run the project now and start familiarize yourself with the folder structure

Building from Source

With godot you can compile the game for any platform. We recommend Android and iOS since the game is intended to be played with touch controls. The Godot Docs describe how to compile for Android and iOS.

Architecture

Overview

|__assets
|__audio
|  |__"all audio files"
|__materials
|  |__enemy_palette
|  |__player_palette
|  |__ufo_palette
|__models
|  |__"all 3D model files"
|__scenes
|  |__enemies
|  |  |__bomber
|  |  |__jaeger
|  |  |__rammer
|  |  |__ufo
|  |  |__BaseEnemy.gd
|  |  |__BaseEnemy.tscn
|  |  |__BaseProjectile.gd
|  |__environment
|  |  |__"all environment files"
|  |__formations
|  |__obstacles
|  |__player
|  |__powerups
|  |__spawners
|  |__Home..
|  |__LoadingScreen..
|  |__Space..
|  |__"additional configuration files"
|__sprites

Path	Description
/audio	Holds all audio files
/materials	Holds all materials grouped by enemy, player and ufo (end boss)
/models	Holds all 3D model files for the entire game as gltf files
/scenes	All files that make up the home screen: First screen after LoadingScreen where you may start the game
	All files that make up the loading screen: First screen on startup
	All files that make up the space screen: The actual game screen
/scenes/enemies	Holds bomber scene, script and projectile scene
	Holds jaeger scene, script and projectile scene
	Holds rammer scene, script and projectile scene
	Holds ufo scene, script and projectile scene
	Holds BaseEnemy script that all enemies inherit from
	Holds BaseEnemy scene that all enemies inherit from
	Holds BaseProjectile script that all projectile scenes inherit from
/scenes/environment	Holds all scenes that are part of the games environment (Stars, Camera, Music Conductor, etc.)
/scenes/formations	Holds formations that are clusters of enemies and/or obstacles that represent one wave created by a spawner
/scenes/obstacles	Holds all obstacles that block the player from moving freely
/scenes/player	Holds player scene and script
/scenes/powerups	Holds all powerups that can be collected by the player
/scenes/spawners	Holds all spawners that spawn formations and make up the waves within a level
/sprites	Holds all sprites for the game

Credits

Music

• Everything you hear in the game is composed by Marlon Jay

Assets

• Spaceships by Kenney

• UFO and everything else by DON interactive

Art

• Backdrop by PiiiXL

• Celestial bodies by Helianthus Games

• Everything else by DON interactive

License

GNU GPLv3

Contact

DON interactive
don-interactive.com