Alien-Onslaught description:

• Alien Onslaught is an action-packed game that will test your shooting skills and reflexes. The game is set in outer space, where you must shoot fleets of aliens to reach higher levels and increase your high score. With each level, the game becomes more challenging as the aliens become stronger and faster, bosses are starting to appear, and more asteroids rain down from above.

• The game offers a range of game modes (e.g.: Boss Rush, Endless Onslaught, Cosmic Conflict (PVP)), including single-player and multiplayer modes, where you can choose to battle it out with friends or take on the aliens alone. In game you can also get a variety of ship power-ups, including increased ship speed, bullet speed, and fire power, as well as shields that protect you from enemy fire. It also includes a high score system where players can compete with others for the top spot on the leaderboard, boss fights, different weapons, different player ship types, and more other features.

Requirements:

• Python 3.7 or later
• Pygame 2.0 or later

Game Launch:

Option one:

• pip install alien-onslaught
• python -m src.alien_onslaught

Option two:

• git clone https://github.com/KhadaAke/Alien-Onslaught.git
• cd Alien-Onslaught
• python -m venv env
• source env/Scripts/activate (env\Scripts\activate for Windows)
• pip install . (including the dot)
• cd src
• python alien_onslaught.py

Option three:

• Open a command prompt or terminal
• Navigate to the game project's root directory (containing setup.py)
• Install the game package with pip install . (including the dot)
• After installation, go to the src directory (use cd src)
• Run the game by executing python alien_onslaught.py

Controls:

Gameplay:

Player 1 (Thunderbird):

• Move — W, A, S, D
• Fire — Space
• Laser — C
• Launch Missiles — X

Player 2 (Phoenix):

• Move — Arrow Keys
• Fire — Enter
• Laser — R-Shift
• Launch Missiles — R-Ctrl

UI Controls:

• Toggle Fullscreen — F
• Pause — P
• Toggle Mute Music & SFX — F1 & F2
• • While Paused:
• Save Game — S
• Restart — R
• Return to Game Menu — ESC
• Return to Main Menu — M
• Quit — Q

Game Images:

More images can be found here

Alien-Onslaught Changelog

Version 3.4:

• Game mode name is now displayed in the title when displaying high scores.
• Updated tests for the new changes.
• Updated immune frames for the Cosmic Conflict game mode.
• Updated buttons positioning for better visual appearance.
• Mute/Unmute & Fullscreen Toggle functionality added on Save / Load screen.
• Updated images for buttons: Difficulty.
• Updated images for buttons: Victory.
• Updated images for buttons: Save Game, Paused.
• Added sound effects for Mute & Unmute.
• Users are able to mute/unmute sound effects in the game using the F2 key.
• Updated & Improved UI / Controls on main menu.
• Users are able to mute/unmute the music in the game using the F1 key.

Version 3.3:

• Overall codebase improvements.
• Code refactored inside the save_load_manager module.
• Improved UI for the Save/Load feature.
• Code refactored in different locations to improve maintainability.
• Completed testing for the save_load_manager module.
• Save/Load functionality improved further: Added overwriting save files and deleting all save files with confirmation popup.
• Enhanced the game's Save/Load functionality to offer players the convenience of multiple save slots. When you choose to save or load the game, a user-friendly menu will now be displayed, presenting three available save slots.
• Code refactored and documentation improved.
• The Save/Load feature has been improved to include the player's current weapon.
• Implemented the Save/Load feature.

Version 3.2:

• Sound effects have been added when changing the ship.
• A new ship selection feature has been introduced, giving players the ability to choose from three different ship types. Each player can now select their preferred ship type before starting the game
• Removed the ability to change the ship by pressing a button.
• A new feature has been added to display a message whenever a player picks up a power. Now, when a power is collected during the game, a notification will appear, indicating the type of power acquired.
• Comprehensive unit testing has been performed for the entire project.

Version 3.1:

• Tests for all managers
• New tests for alien managers and player managers.
• New tests for entities, managers and animations.
• Added tests for animations and entities.
• The project is now available for installation as a package.
• New music for the Victory screen.
• Refactored the code by moving all managers into a new package called 'managers' to enhance maintainability. Additionally, various classes and functions were further refactored to improve code readability and maintainability.
• Improved overall sound management for the game.
• Implemented a new power up also accompanied with a sound effect: Enemies are frozen for a period of time.
• Implemented the option to toggle from Fullscreen to Resizable.
• UI controls are displayed on the Main Menu.
• Added application icon.
• Refactored the code : Moved weapons related code from the main class into the WeaponsManager. Moved gameplay related code such as level progression and game modes into the gameplay_handler module (renamed from game_modes).
• Sound effect for the laser implemented.
• When the player's laser is ready, a message is displayed, accompanied by a corresponding sound effect. Similarly, when the player attempts to fire the laser before it is ready or available, another message is displayed along with an appropriate sound effect.
• Laser functionality: The behavior of the laser differs depending on the game mode. In certain game modes, there is a cooldown for the laser. In other game modes, the laser becomes available every time the player successfully eliminates a certain number of aliens.

Version 3.0:

• Code refactored in main class and collision detection module, and implemented new collisions for the Laser weapon.
• Improved the timing of the power downs.
• Implemented a new very strong weapon for the player (Laser).
• Implemented a new sound effect for asteroids getting destroyed.
• Modified several modules to ensure compatibility with PyInstaller and enable easy creation of an executable using tools like Auto-py-to-exe.
• Solved a bug that was causing intermittent issues with sound playback by enhancing the play_sound function. The function now plays sounds on available channels, and if a sound is repetitive (such as the player shooting), it is played only on a specific channel to prevent unnecessary channel congestion.
• New penalty implemented: Player bullets are smaller for a period of time making it harder to hit enemies.
• Implemented a new feature: Now when defeating an alien there is a chance that it will split into a small number of smaller, baby aliens.
• Added a new mechanic in the game (exclusively for the multiplayer): After defeating the third Boss, if one of the players is not alive, he is revived with two lifes available.
• Implemented a new game mode: One Life Reign in which the players are really strong from the start of the game but they have only one life.
• Implemented a unique set of alien bullets for each type of alien present in the game.
• Code refactored to enhance the functionality of the main game class, allowing it to work for both singleplayer and multiplayer modes. This eliminates the need to create a separate class for singleplayer.
• Implemented winning screen for Cosmic Conflict.
• Added a new PVP game mode called Cosmic Conflict, where two players battle against each other in a 1v1 match.
• High score saving improved.
• Improved sound balance.
• Implemented a Victroy screen that appears in the Boss Rush when the players are defeating the last boss.
• Refactored the game code to improve its overall structure, readability, and maintainability by creating two base classes: Ship and Bullet, making it easier to create player ships and bullets and reducing code duplication.
• Reorganized the folder structure to enhance project organization and make it more navigable.

Version 2.9:

• Updated the game mechanics so that when aliens hit the bottom of the screen, players now lose 100 points from their score instead of losing one life. This change was made because losing a life felt like too severe of a punishment.
• Modified the game speed-up scale and alien speed on all difficulties because the game was too hard even on the easiest mode.
• Implemented three new aliens.
• Players now have the ability to go back to the game menu when the game is paused.
• Implemented a custom mouse cursor that is now displayed while navigating through both the main and game menus.
• Refactored the game modes display functionality to improve user experience. Instead of displaying the description for the game modes when the game modes button is clicked, the description for each game mode now appears when the user hovers the mouse over the corresponding button.
• The intensity of the alien's firepower increases in correlation with the game level and/or selected difficulty.
• Added new background music for the Boss Rush and Endless Onslaught game modes.
• Removed the player position tracking feature from alien bullets because it was making the game less enjoyable.
• Moved sound related code from the main game class into a new SoundManager class to improve code maintainability
• Fixed a bug that caused some buttons to remain clickable even when they were not visible on the screen.
• The code has been refactored to enhance compatibility with both the singleplayer and multiplayer versions of the game. And by doing this, the duplicated code in the Singleplayer class has been reduced.
• New sound effects for aliens being destroyed.

Version 2.8:

• Players can now delete all high scores with the click of a button. Additionally, if a player's name already exists in the high scores, they will be prompted to enter a new name.
• Enhanced the high score system to allow players to enter a personalized name for their achievement. This allows players to see their name next to their high score which is adding a sense of ownership and accomplishment.
• New sound effects for both the gameplay and UI and in addition to the new sound effects, there are also new penalties to make the game more challenging.
• Implemented sound effects for: Ship exploding, gift boxes, power ups, penalties, health and game over screen.
• Implemented loading screen.
• The game now features dynamic background music that changes as the player progresses through the different levels. The menu also has its own distinct background music.
• The alien bullets in the game have become more advanced, adapting to the player's movements and tracking their position to create a more challenging gameplay experience.
• Now the players are able to fire continuously while holding down their fire button.
• Implemented a new power that changes the ship size.
• Implemented missiles icons where the number of missiles is displayed on screen and a new penalty that gives to the normal aliens a shielded state for a period of time and for bosses 15 HP.
• Improved UI by adding a description for every game mode available in the game
• Code refactored
• Implemented two new powers, bonus points and invincibility.
• Implemented a new feature: Gift boxes now drop from the top of the screen, each containing different weapon for players to use.

Version 2.7:

• Solved a bug that prevented the ships from playing their destroy animation when losing their last health.
• New background after level 25.
• Now when a player picks up a power, there is a chance for that power to be a penalty. Introduced two penalties: Reversed movement and disarm. The penalties are active for a short period of time.
• Moved all projectiles into a new module called 'projectiles' and refactored the code in the 'collision_detection' module.
• Implemented a new feature to the game which introduces a new weapon for players. Each player now starts with three missiles that can cause damage to multiple aliens when they explode. Additionally, a power-up has been included which increases the number of missiles available to the player.
• New power up that is available only in the Last Bullet game mode, remaining bullets increased.
• Implemented new power_ups, alien speed and alien bullet speed decreased.
• Created a new module 'game_modes' that manages the different game modes available in the game.
• Refactored code in multiple modules and created two new @dataclasses to hold values for different parts of the game.
• Improved UI, moved some buttons and added the game title in the Menu screen.
• Improved the high score system, now there are separate high scores for every game mode.
• Implemented a new game mode, Boss Rush: Players must fight different bosses at every level, each with their own unique designs and bullet patterns. With each level, the bosses become stronger and faster, making them more challenging.
• Created a new module, 'image_loader' which has functions to load images for aliens.

Version 2.6:

• Implemented a new Boss fight and a new animation for power-ups being picked up.
• Implemented new animation for entities getting destroyed, and a new module 'frames' which contains constants for animations or images used in the game.
• New feature to enhance gameplay: player immunity after being hit! Now, when a player is hit, they will be granted a brief period of immunity to prevent them from taking another hit right away. This will give players a chance to recover and avoid getting hit again immediately after respawning. An animation will play during the immunity period, letting the players know they are invulnerable.
• Implemented a new game mode, Meteor Madness: Players must navigate a barrage of asteroids as each level progresses, the number of asteroids coming towards the player will increase, and their speed will become more relentless. Additionally, the player's speed will decrease, adding an extra layer of challenge to the game.
• New packages created: "animations": This package contains modules for handling animations in the game. "entities": This package includes modules for defining and managing game entities such as ships, asteroids, aliens, and power-ups. "game logic": This package contains modules that handle the core game logic, such as collision detection, game settings, and scoring. "ui": This package includes modules for managing the user interface (UI) of the game. It contains classes and functions for creating game buttons, scoreboards, and other UI elements. "utils": This package contains modules for various utilities and helper functions used throughout the game and constants.
• Refactored code into new classes and modules
• Improvements to the code organization by grouping related modules and classes into new packages.

Version 2.5:

• Created new modules: "game_utils" for common utility functions, "screen_manager" for managing screen resizing behavior, "game_buttons" for creating the game buttons, "animations" for animating elements on the screen, and "constants" for storing constants.
• Refactored code by grouping related functions and classes into new modules for improved organization.
• Implemented Game Modes:
• Last Stand: In the Last Stand game mode, the ship and bullet speeds decrease over time, making the game more difficult.
• The Endless game mode features fleets of aliens and asteroids that continuously appear, with the speed of the aliens and their bullets increasing over time.

Version 2.4:

• Added minimum and maximum window sizes: 1260x700 and 1920x1080.
• Changed fleet creation so that aliens drop in rows from the top of the screen, and the number of aliens in each row increases with each level.
• Implemented high scores; when the game ends, the high score is saved, and players can view the top 10 high scores by clicking the "HIGH SCORES" button.
• Improved the code to make it more concise, refactored, and easier to read, and added more documentation.
• Changed the alien movement so that they randomly move in different directions.

Version 2.3:

• Improved code readability and added more documentation, comments, and docstrings.
• Implemented boss fights: different bosses with different types of bullets.
• Added a ship warp animation when the game starts.
• Fixed a bug that occurred when the game window was resized.
• Improved the game's user interface.

Version 2.2.1:

• Added the ability to pause the game.
• Fixed a bug in ship movement by using Python's "match case" instead of "if-elif-else".
• Players can now adjust the game's difficulty.
• Added new buttons: "Menu" and "Difficulty".

Version 2.2:

• Added Game Over screen when the game ends.
• Displayed controls for both players on the screen.
• Improved the Start Menu with button images instead of text for Singleplayer, Multiplayer, Play, and Quit buttons.

Version 2.1:

• Added new background images.
• Added a new power-up that increases the number of bullets the player can shoot.
• Added new animations for ship hitting an alien, asteroid, or alien bullet.

Version 2.0:

• Introduced new animated aliens.
• Implemented new ship skins and the ability to switch between them.
• Added animated asteroids dropping from the top of the screen as the game progresses.

Version 1.9:

• Added random alien shooting and a new power-up, the shield.

Version 1.8:

• Added ship power-ups, including increased ship speed, bullet speed, and bullets allowed.
• Increased the strength of aliens as the player progresses to higher levels.

Version 1.7:

• Made the game window resizable.
• Implemented new backgrounds that change as the game progresses.
• Added the option to choose Singleplayer or Multiplayer mode from the Start Menu.

Credits

This is a list of assets used in the project that were not created by me, along with their respective authors:

Music:

• Level soundtracks — by Matthew Pablo
• Third phase song in Boss Rush — by Juhani Junkala
• Endless Onslaught soundtrack — by Alexander Ehlers
• Meteor Madness soundtrack — by Alexandr Zhelanov
• Game over music — by Otto Halmén
• Victory and Menu music — by yd

Sound Effects (SFx):

• Mute — by LokiF
• Unmute — by OpenGameArt.Org
• UI Sound effects: Click sound, Quit sound, Empty save sound, Load game sound and other — by Circlerun
• Explosion , Laser ready, Ship change, — by Michael Kurinnoy
• Power-up, penalty, health — by phoenix1291
• Laser sound effect — by [celestialghost8] (https://opengameart.org/users/celestialghost8)
• Laser not ready — by ViRiX
• Freeze — by qubodup

Images/Sprites:

• Ships/missiles — by MillionthVector
• Warp effect, bosses, shields, explosions and some bullets — by Skorpio
• Aliens — by Gamedevtuts
• Powers and some bullets — by JanaChumi
• Most of the bullets — by Wenrexa
• Alien Bullet — by GameSupplyGuy