From 8ddd22f3bd271b200af7392d75cba24d1aff3f09 Mon Sep 17 00:00:00 2001
From: Bernd Hagen <31480734+BerndHagen@users.noreply.github.com>
Date: Mon, 26 Aug 2024 16:15:00 +0200
Subject: [PATCH] Version 1.0.1
---
ASCII Orbit.csproj | 73 ++++
ASCII Orbit.sln | 25 ++
App.config | 6 +
LICENSE | 28 ++
Program.cs | 516 ++++++++++++++++++++++++++++
README.md | 92 +++++
img/v1.0.0-ascii-orbit-game.png | Bin 0 -> 9319 bytes
img/v1.0.0-ascii-orbit-gameover.png | Bin 0 -> 11923 bytes
img/v1.0.0-ascii-orbit-title.png | Bin 0 -> 9732 bytes
properties/AssemblyInfo.cs | 36 ++
release/ASCII Orbit.exe | Bin 0 -> 429056 bytes
release/ASCII Orbit.exe.config | 6 +
symbol.ico | Bin 0 -> 410598 bytes
13 files changed, 782 insertions(+)
create mode 100644 ASCII Orbit.csproj
create mode 100644 ASCII Orbit.sln
create mode 100644 App.config
create mode 100644 LICENSE
create mode 100644 Program.cs
create mode 100644 README.md
create mode 100644 img/v1.0.0-ascii-orbit-game.png
create mode 100644 img/v1.0.0-ascii-orbit-gameover.png
create mode 100644 img/v1.0.0-ascii-orbit-title.png
create mode 100644 properties/AssemblyInfo.cs
create mode 100644 release/ASCII Orbit.exe
create mode 100644 release/ASCII Orbit.exe.config
create mode 100644 symbol.ico
diff --git a/ASCII Orbit.csproj b/ASCII Orbit.csproj
new file mode 100644
index 0000000..5ef5d47
--- /dev/null
+++ b/ASCII Orbit.csproj
@@ -0,0 +1,73 @@
+
+
+
+
+ Debug
+ AnyCPU
+ {D8419A89-46A1-441D-BC12-DDC31E22D787}
+ Exe
+ ASCII_Orbit
+ ASCII Orbit
+ v4.7.2
+ 512
+ true
+ true
+
+
+ AnyCPU
+ true
+ full
+ false
+ bin\Debug\
+ DEBUG;TRACE
+ prompt
+ 4
+
+
+ AnyCPU
+ pdbonly
+ true
+ bin\Release\
+ TRACE
+ prompt
+ 4
+
+
+ false
+
+
+ 2888365B9361140A106AA1AD96DA1E6332675D54
+
+
+ ASCII Orbit_TemporaryKey.pfx
+
+
+ false
+
+
+ symbol.ico
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/ASCII Orbit.sln b/ASCII Orbit.sln
new file mode 100644
index 0000000..0c574d5
--- /dev/null
+++ b/ASCII Orbit.sln
@@ -0,0 +1,25 @@
+
+Microsoft Visual Studio Solution File, Format Version 12.00
+# Visual Studio Version 17
+VisualStudioVersion = 17.7.34003.232
+MinimumVisualStudioVersion = 10.0.40219.1
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "ASCII Orbit", "ASCII Orbit\ASCII Orbit.csproj", "{D8419A89-46A1-441D-BC12-DDC31E22D787}"
+EndProject
+Global
+ GlobalSection(SolutionConfigurationPlatforms) = preSolution
+ Debug|Any CPU = Debug|Any CPU
+ Release|Any CPU = Release|Any CPU
+ EndGlobalSection
+ GlobalSection(ProjectConfigurationPlatforms) = postSolution
+ {D8419A89-46A1-441D-BC12-DDC31E22D787}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+ {D8419A89-46A1-441D-BC12-DDC31E22D787}.Debug|Any CPU.Build.0 = Debug|Any CPU
+ {D8419A89-46A1-441D-BC12-DDC31E22D787}.Release|Any CPU.ActiveCfg = Release|Any CPU
+ {D8419A89-46A1-441D-BC12-DDC31E22D787}.Release|Any CPU.Build.0 = Release|Any CPU
+ EndGlobalSection
+ GlobalSection(SolutionProperties) = preSolution
+ HideSolutionNode = FALSE
+ EndGlobalSection
+ GlobalSection(ExtensibilityGlobals) = postSolution
+ SolutionGuid = {B294C090-ED5A-4817-AB38-9D046A895C76}
+ EndGlobalSection
+EndGlobal
diff --git a/App.config b/App.config
new file mode 100644
index 0000000..56efbc7
--- /dev/null
+++ b/App.config
@@ -0,0 +1,6 @@
+
+
+
+
+
+
\ No newline at end of file
diff --git a/LICENSE b/LICENSE
new file mode 100644
index 0000000..ee143f6
--- /dev/null
+++ b/LICENSE
@@ -0,0 +1,28 @@
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+| ASCII-ORBIT - TERMINAL SHOOTER |
+| COPYRIGHT NOTICE |
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+The MIT License grants permission, free of charge, to any individual
+obtaining a copy of this software and its associated documentation
+files (the "Software") to use, copy, modify, merge, publish, distribute,
+sublicense, and/or sell copies of the Software. This permission also
+extends to allowing others to whom the Software is furnished to do the
+same, subject to the following conditions:
+
+1. **Attribution:** The copyright notice and this permission notice must
+ be included in all copies or significant portions of the Software.
+
+2. **Acknowledgment:** Proper attribution to the original creator must be
+ provided in all projects, documentation, or other materials that utilize
+ this Software. Additionally, a link to the original repository created by
+ Bernd Hagen should be included.
+
+The Software is provided "as is," without any warranty of any kind, express
+or implied, including but not limited to warranties of merchantability,
+fitness for a particular purpose, and noninfringement. Under no circumstances
+shall the authors or copyright holders be held liable for any claims, damages,
+or other liabilities, whether in an action of contract, tort, or otherwise,
+arising from or related to the Software or its use.
+
+For more details, please visit: https://opensource.org/licenses/MIT
diff --git a/Program.cs b/Program.cs
new file mode 100644
index 0000000..3a71a1c
--- /dev/null
+++ b/Program.cs
@@ -0,0 +1,516 @@
+using System.Collections.Generic;
+using System;
+using System.Diagnostics;
+using System.Linq;
+using System.Runtime.InteropServices;
+using System.Threading.Tasks;
+using System.Threading;
+
+namespace ASCII_Orbit
+{
+ class Program
+ {
+ static Stopwatch Playtime = new Stopwatch();
+ static int GameWidth = 60;
+ static int GameHeight = 25;
+ static int AreaLeft = ((Console.WindowWidth - GameWidth) / 2) + 1;
+ static int AreaTop = (Console.WindowHeight - GameHeight) / 2 + 1;
+ static float Invaderspeed = 2f;
+ static Random RandomNumber = new Random();
+ static int Lives = 3;
+ static int InvaderBeat = 0;
+ static Timer InvaderSpawnTimer;
+ static char[] InvaderTypes = Enumerable.Range('A', 26).Select(i => (char)i).ToArray();
+ static ConsoleColor[] Colors = { ConsoleColor.Red, ConsoleColor.Green, ConsoleColor.Yellow, ConsoleColor.Cyan, ConsoleColor.Magenta, ConsoleColor.Blue, ConsoleColor.DarkYellow, ConsoleColor.DarkMagenta, ConsoleColor.DarkCyan };
+ static List Invaders = new List();
+ static int PlayerPosition;
+ static List<(int shotX, int shotY)> Projectiles = new List<(int, int)>();
+ static int Score = 0;
+ static int NextExtraLife = 10000;
+ static int Level = 1;
+ static float Min = 3;
+ static float Max = 6;
+ static Stopwatch FireCooldown = new Stopwatch();
+
+ private const int GWL_STYLE = -16;
+ private const int WS_MAXIMIZEBOX = 0x00010000;
+ private const int WS_THICKFRAME = 0x00040000;
+
+ [DllImport("user32.dll")]
+ private static extern int SetWindowLong(IntPtr hWnd, int nIndex, int dwNewLong);
+
+ [DllImport("kernel32.dll")]
+ private static extern IntPtr GetConsoleWindow();
+
+ [DllImport("user32.dll", EntryPoint = "GetWindowLong")]
+ private static extern int GetWindowLong(IntPtr hWnd, int nIndex);
+
+ // Main game loop controlling player movement and actions
+ static async Task Main(string[] args)
+ {
+ Console.CursorVisible = false;
+ Console.WindowWidth = 80;
+ Console.BufferWidth = 80;
+ Console.WindowHeight = 30;
+ Console.BufferHeight = 30;
+ AreaLeft = ((Console.WindowWidth - GameWidth) / 2) + 1;
+ AreaTop = (Console.WindowHeight - GameHeight) / 2 + 1;
+ IntPtr consoleHandle = GetConsoleWindow();
+ int windowStyle = GetWindowLong(consoleHandle, GWL_STYLE);
+ windowStyle &= ~WS_MAXIMIZEBOX;
+ windowStyle &= ~WS_THICKFRAME;
+ SetWindowLong(consoleHandle, GWL_STYLE, windowStyle);
+
+ DisplayTitleScreen();
+ Console.Clear();
+ bool isRunning = true;
+ PlayerPosition = GameWidth / 2;
+ ConsoleKeyInfo keyInfo;
+ Console.CursorVisible = false;
+ DrawBorder();
+ DisplayScoreAndLives(Score, Lives, Level);
+ await Task.Delay(2000);
+ Playtime.Start();
+ InvaderSpawnTimer = new Timer(OnInvaderspawn, null, TimeSpan.FromSeconds(Min), TimeSpan.FromSeconds(Max));
+ FireCooldown.Start();
+
+ while (isRunning && Lives > 0)
+ {
+ if (Console.KeyAvailable)
+ {
+ keyInfo = Console.ReadKey(true);
+ ClearPosition(PlayerPosition + AreaLeft, GameHeight - 2 + AreaTop);
+ switch (keyInfo.Key)
+ {
+ case ConsoleKey.LeftArrow:
+ PlayerPosition = Math.Max(1, PlayerPosition - 1);
+ break;
+ case ConsoleKey.RightArrow:
+ PlayerPosition = Math.Min(GameWidth - 2, PlayerPosition + 1);
+ break;
+ case ConsoleKey.Spacebar:
+ if (FireCooldown.ElapsedMilliseconds >= 750)
+ {
+ StartShoot(PlayerPosition + AreaLeft, GameHeight - 3 + AreaTop);
+ FireCooldown.Restart();
+ }
+ break;
+ }
+ }
+ if (Projectiles.Count > 0)
+ UpdateProjectiles(ref Score);
+
+ MoveInvaders();
+ DrawPlayer(PlayerPosition, GameHeight - 2);
+ DisplayScoreAndLives(Score, Lives, Level);
+
+ foreach (var invader in Invaders)
+ {
+ if (invader.PositionX == PlayerPosition && invader.PositionY == GameHeight - 2)
+ {
+ Lives--;
+ if (Lives <= 0)
+ break;
+ }
+ }
+ Invaders.RemoveAll(invader => invader.PositionY >= GameHeight - 2);
+
+ if (Lives <= 0)
+ {
+ DisplayGameOverScreen(Score, Level);
+ isRunning = false;
+ Projectiles.Clear();
+ Invaders.Clear();
+ Invaderspeed = 10;
+ break;
+ }
+ await Task.Delay(20);
+ }
+ }
+
+ // Display the game title screen with instructions
+ static void DisplayTitleScreen()
+ {
+ Console.Clear();
+ Console.CursorVisible = false;
+ string[] titleLines = {
+ @" __ ___ ___ ____ ____ _____ ____ ____ ____ ____ ",
+ @" /__\ / __) / __)(_ _)(_ _) ( _ )( _ \( _ \(_ _)(_ _)",
+ @" /(__)\ \__ \( (__ _)(_ _)(_ )(_)( ) / ) _ < _)(_ )( ",
+ @"(__)(__)(___/ \___)(____)(____) (_____)(_)\_)(____/(____) (__) "
+ };
+
+ string instructions = "PRESS SPACE TO START THE GAME";
+ int screenWidth = Console.WindowWidth;
+ int screenHeight = Console.WindowHeight;
+ int titleHeight = titleLines.Length;
+ int startY = ((screenHeight - titleHeight) / 2) - 2;
+ int instructionsY = startY + titleHeight + 2;
+ Console.ForegroundColor = ConsoleColor.Cyan;
+
+ foreach (string line in titleLines)
+ {
+ Console.SetCursorPosition((screenWidth - line.Length) / 2, startY++);
+ Console.WriteLine(line);
+ }
+ Console.ResetColor();
+ BlinkInstructions(instructions, screenWidth, instructionsY);
+ Console.Clear();
+ }
+
+ // Displays blinking instructions until spacebar is pressed
+ static void BlinkInstructions(string instructions, int screenWidth, int instructionsY)
+ {
+ bool showInstructions = true;
+ while (!Console.KeyAvailable || Console.ReadKey(true).Key != ConsoleKey.Spacebar)
+ {
+ Console.SetCursorPosition((screenWidth - instructions.Length) / 2, instructionsY);
+ if (showInstructions)
+ {
+ Console.ForegroundColor = ConsoleColor.White;
+ Console.WriteLine(instructions);
+ Console.ResetColor();
+ }
+ else
+ Console.WriteLine(new string(' ', instructions.Length));
+ showInstructions = !showInstructions;
+ Thread.Sleep(500);
+ }
+ }
+
+ // Draws a border around the game area
+ static void DrawBorder()
+ {
+ string horizontalBorder = new string('═', GameWidth - 2);
+ string verticalBorder = "║";
+ Console.SetCursorPosition(AreaLeft, AreaTop);
+ Console.Write("╔" + horizontalBorder + "╗");
+ for (int y = 1; y < GameHeight - 1; y++)
+ {
+ Console.SetCursorPosition(AreaLeft, AreaTop + y);
+ Console.Write(verticalBorder);
+ Console.SetCursorPosition(AreaLeft + GameWidth - 1, AreaTop + y);
+ Console.Write(verticalBorder);
+ }
+ Console.SetCursorPosition(AreaLeft, AreaTop + GameHeight - 1);
+ Console.Write("╚" + horizontalBorder + "╝");
+ }
+
+ // Clears a specific position within the game area
+ static void ClearPosition(int x, int y)
+ {
+ if (x > AreaLeft && x < AreaLeft + GameWidth - 1)
+ {
+ Console.SetCursorPosition(x, y);
+ Console.Write(" ");
+ }
+ }
+
+ // Displays score, lives and level information
+ static void DisplayScoreAndLives(int Score, int Lives, int Level)
+ {
+ Console.SetCursorPosition(AreaLeft + 1, AreaTop - 1);
+ Console.ForegroundColor = ConsoleColor.Red;
+ Console.Write("Lives: ");
+ Console.ResetColor();
+ Console.Write($"{Lives:D2} ");
+ Console.ForegroundColor = ConsoleColor.Red;
+ Console.Write("Score: ");
+ Console.ResetColor();
+ Console.Write($"{Score:D9} ");
+ Console.ForegroundColor = ConsoleColor.Red;
+ Console.Write("Level: ");
+ Console.ResetColor();
+ Console.Write($"{Level:D2}");
+ }
+
+ // Initiates a projectile from the player's position
+ static void StartShoot(int startX, int startY)
+ {
+ Task.Run(() => Console.Beep(200, 100));
+ Projectiles.Add((startX, startY));
+ }
+
+ // Handles invader spawn and timer adjustment
+ static void OnInvaderspawn(object state)
+ {
+ int xPos = RandomNumber.Next(1, GameWidth - 1);
+ int yPos = 1;
+ char enemyChar = InvaderTypes[RandomNumber.Next(InvaderTypes.Length)];
+ ConsoleColor color = Colors[RandomNumber.Next(Colors.Length)];
+ Invader newInvader = new Invader(xPos, yPos, enemyChar, color, Invaderspeed);
+ Invaders.Add(newInvader);
+ Console.Beep(300, 100);
+ double nextSpawnTimeInSeconds = RandomNumber.NextDouble() * (Max - Min) + Min;
+ if (InvaderSpawnTimer != null)
+ InvaderSpawnTimer.Change(TimeSpan.FromSeconds(nextSpawnTimeInSeconds), Timeout.InfiniteTimeSpan);
+ }
+
+ // Updates projectile positions and handles collision detection
+ static void UpdateProjectiles(ref int Score)
+ {
+ for (int i = Projectiles.Count - 1; i >= 0; i--)
+ {
+ var (shotX, shotY) = Projectiles[i];
+ ClearPosition(shotX, shotY);
+ shotY--;
+
+ bool shotRemoved = false;
+ if (shotY >= AreaTop + 1)
+ {
+ foreach (var invader in Invaders.ToList())
+ {
+ if ((shotX == AreaLeft + invader.PositionX && shotY == AreaTop + invader.PositionY) ||
+ (shotX == AreaLeft + invader.PositionX && shotY == AreaTop + invader.PositionY - 1))
+ {
+ Score += 50 + (Level * 50);
+ InvaderBeat++;
+ ClearPosition(shotX, shotY);
+ Console.Beep(800, 100);
+ Invaders.Remove(invader);
+ shotRemoved = true;
+ DisplayScoreAndLives(Score, Lives, Level);
+ if (Score >= NextExtraLife)
+ {
+ NextExtraLife = NextExtraLife * 2;
+ Lives++;
+ Console.Beep(1200, 200);
+ Thread.Sleep(100);
+ Console.Beep(800, 200);
+ }
+ if (InvaderBeat == 5 + (2 * (Level - 1)))
+ {
+ InvaderBeat = 0;
+ Level++;
+ Console.Beep(500, 100);
+ Console.Beep(600, 100);
+ Console.Beep(700, 100);
+ Console.Beep(800, 100);
+ if (Min > 1.0f) Min -= 0.2f;
+ if (Max > 2.5f) Max -= 0.2f;
+ }
+ break;
+ }
+ }
+ if (!shotRemoved)
+ {
+ Projectiles[i] = (shotX, shotY);
+ Console.SetCursorPosition(shotX, shotY);
+ Console.Write("|");
+ }
+ else
+ Projectiles.RemoveAt(i);
+ }
+ else
+ Projectiles.RemoveAt(i);
+ }
+ }
+
+ // Moves invaders downwards and handles collisions
+ static void MoveInvaders()
+ {
+ for (int i = Invaders.Count - 1; i >= 0; i--)
+ {
+ Invader invader = Invaders[i];
+ int previousY = invader.PositionY;
+
+ invader.Move(Level);
+
+ if (invader.PositionY != previousY)
+ {
+ ClearPosition(AreaLeft + invader.PositionX, AreaTop + previousY);
+ DrawInvader(invader.PositionX, invader.PositionY, invader.Char, invader.Color);
+ }
+
+ if (invader.PositionY >= GameHeight - 2)
+ {
+ Console.Beep(500, 200);
+ Console.Beep(300, 200);
+ Invaders.RemoveAt(i);
+ Lives--;
+ if (Lives <= 0)
+ break;
+ }
+ }
+ }
+
+ // Draws the player's character on screen
+ static void DrawPlayer(int positionX, int positionY)
+ {
+ Console.SetCursorPosition(positionX + AreaLeft, positionY + AreaTop);
+ Console.Write("▲");
+ }
+
+ // Draws an invader at the specified position
+ static void DrawInvader(int positionX, int positionY, char character, ConsoleColor color)
+ {
+ Console.SetCursorPosition(positionX + AreaLeft, positionY + AreaTop);
+ Console.ForegroundColor = color;
+ Console.Write(character);
+ Console.ResetColor();
+ }
+
+ // Displays the game over screen with player statistics
+ static void DisplayGameOverScreen(int Score, int Level)
+ {
+ Console.Clear();
+ Console.CursorVisible = false;
+ int centerX = Console.WindowWidth / 2;
+ int centerY = Console.WindowHeight / 2 - 8;
+ string[] gameOverString = new string[] {
+ @" ____ _ __ __ _____ _____ _______ ____ ",
+ @" / ___| / \ | \/ | ____| / _ \ \ / / ____| _ \ ",
+ @"| | _ / _ \ | |\/| | _| | | | \ \ / /| _| | |_) |",
+ @"| |_| |/ ___ \| | | | |___ | |_| |\ V / | |___| _ < ",
+ @" \____/_/ \_\_| |_|_____| \___/ \_/ |_____|_| \_\",
+ };
+
+ if (InvaderSpawnTimer != null)
+ {
+ InvaderSpawnTimer.Change(Timeout.Infinite, Timeout.Infinite);
+ InvaderSpawnTimer.Dispose();
+ InvaderSpawnTimer = null;
+ }
+
+ Console.ForegroundColor = ConsoleColor.Red;
+ foreach (var line in gameOverString)
+ {
+ Console.SetCursorPosition(centerX - line.Length / 2, centerY++);
+ Console.WriteLine(line);
+ }
+ Console.ResetColor();
+ int infoY = centerY + 3;
+ string longestLine = $"Playtime:\t{59:D2}m {59:D2}s";
+ int totalWidth = longestLine.Length;
+ int infoX = centerX - (totalWidth / 2) - 2;
+
+ Console.SetCursorPosition(infoX, infoY);
+ Console.ForegroundColor = ConsoleColor.Red;
+ Console.Write("Score:\t ");
+ Console.ResetColor();
+ Console.WriteLine($"{Score,9:D9}");
+
+ Console.SetCursorPosition(infoX, infoY + 1);
+ Console.ForegroundColor = ConsoleColor.Red;
+ Console.Write("Level:\t ");
+ Console.ResetColor();
+ Console.WriteLine($"{Level,9:D2}");
+
+ Console.SetCursorPosition(infoX, infoY + 2);
+ Console.ForegroundColor = ConsoleColor.Red;
+ Console.Write("Time:\t ");
+ Console.ResetColor();
+ Console.WriteLine($"{Playtime.Elapsed.Minutes,6:D2}:{Playtime.Elapsed.Seconds:D2}");
+
+ Console.SetCursorPosition(infoX, infoY + 3);
+ Console.ForegroundColor = ConsoleColor.Red;
+ Console.Write("Rank:\t ");
+ Console.ResetColor();
+ Console.WriteLine($"{GetRank(Score),9}");
+
+ Console.SetCursorPosition(centerX - 16, infoY + 7);
+ Console.ForegroundColor = ConsoleColor.White;
+ Console.Write("PRESS THE SPACE BUTTON TO CONTINUE");
+ while (!Console.KeyAvailable || Console.ReadKey(true).Key != ConsoleKey.Spacebar)
+ {
+ Thread.Sleep(500);
+ Console.SetCursorPosition(centerX - 16, infoY + 7);
+ Console.Write(new string(' ', "PRESS THE SPACE BUTTON TO CONTINUE".Length));
+ Thread.Sleep(500);
+ Console.SetCursorPosition(centerX - 16, infoY + 7);
+ Console.Write("PRESS THE SPACE BUTTON TO CONTINUE");
+ }
+ ResetGameState(ref Score, ref Lives, ref Level, ref InvaderBeat);
+ DisplayTitleScreen();
+ Invaderspeed = 10;
+ }
+
+ // Resets game state for a new session
+ static void ResetGameState(ref int score, ref int lives, ref int level, ref int invaderBeat)
+ {
+ score = 0;
+ lives = 3;
+ level = 1;
+ invaderBeat = 0;
+ PlayerPosition = GameWidth / 2;
+ Projectiles.Clear();
+ Invaders.Clear();
+ Console.Clear();
+ DrawBorder();
+ DisplayScoreAndLives(score, lives, level);
+ Playtime.Reset();
+ Playtime.Start();
+ FireCooldown.Reset();
+ }
+
+ // DeterMines player's rank based on Score
+ static string GetRank(int Score)
+ {
+ int rank = 0;
+ int currentThreshold = 3000;
+ int result = Score;
+
+ while (result >= currentThreshold)
+ {
+ result -= currentThreshold;
+ rank++;
+ currentThreshold = 3000 + (750 * rank);
+ }
+
+ if (rank == 0) return "F";
+ else if (rank == 1) return "F+";
+ else if (rank == 2) return "E-";
+ else if (rank == 3) return "E";
+ else if (rank == 4) return "E+";
+ else if (rank == 5) return "D-";
+ else if (rank == 6) return "D";
+ else if (rank == 7) return "D+";
+ else if (rank == 8) return "C-";
+ else if (rank == 9) return "C";
+ else if (rank == 10) return "C+";
+ else if (rank == 11) return "B-";
+ else if (rank == 12) return "B";
+ else if (rank == 13) return "B+";
+ else if (rank == 14) return "A-";
+ else if (rank == 15) return "A";
+ else if (rank == 16) return "A+";
+ else if (rank == 17) return "S-";
+ else if (rank == 18) return "S";
+ else return "S+";
+ }
+ }
+
+ class Invader
+ {
+ public int PositionX { get; set; }
+ public int PositionY { get; set; }
+ public char Char { get; set; }
+ public ConsoleColor Color { get; set; }
+ public double MoveSpeedInSeconds { get; set; }
+
+ private Stopwatch moveTimer = new Stopwatch();
+
+ public Invader(int posX, int posY, char character, ConsoleColor color, double moveSpeedInSeconds)
+ {
+ PositionX = posX;
+ PositionY = posY;
+ Char = character;
+ Color = color;
+ MoveSpeedInSeconds = moveSpeedInSeconds;
+ moveTimer.Start();
+ }
+
+ public void Move(int Level)
+ {
+ double reductionPercentage = 0.20;
+ double MaxReductionLimit = MoveSpeedInSeconds / 5;
+ double adjustedMoveSpeed = MoveSpeedInSeconds * Math.Pow(1 - reductionPercentage, Level - 1);
+ adjustedMoveSpeed = Math.Max(adjustedMoveSpeed, MaxReductionLimit);
+ if (moveTimer.Elapsed.TotalSeconds >= adjustedMoveSpeed)
+ {
+ PositionY++;
+ moveTimer.Restart();
+ }
+ }
+ }
+}
\ No newline at end of file
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..16fc6bb
--- /dev/null
+++ b/README.md
@@ -0,0 +1,92 @@
+# ASCII-Orbit - Terminal Shooter
+
+**ASCII-Orbit** is a console-based C# game that transforms a simple console window into a battlefield. In this game, players navigate an ASCII-rendered universe, dodging and destroying waves of alphabetical invaders as they descend toward the bottom of the screen.
+
+Players control an arrow symbol, tasked with defending against enemies represented by letters of the alphabet. As players progress through levels, the speed of the enemies increases, ramping up the challenge. The objective is to shoot down these invaders before they reach the bottom of the screen, as each enemy that gets through costs the player a life. The game continues to escalate in difficulty, testing your reflexes constantly more.
+
+At the end of the game, your performance is evaluated based on your final score, with rankings ranging from **S+** to lower grades.
+
+## **Technical Details**
+
+- **Platform:** Windows
+- **Development Environment:** Visual Studio 2022
+- **Framework:** [.NET Framework 4.7.2](https://dotnet.microsoft.com/en-us/download/dotnet-framework/net472) or higher
+- **Compatibility:** The game is developed exclusively for `Windows`. However, with Mono, it may run on `Linux`, though with some limitations:
+ - Sound effects are not supported on Linux.
+ - Console size adjustments might be required for optimal gameplay.
+
+## Running ASCII-Orbit
+
+To start playing **ASCII-Orbit**, you have two options: download the game directly from the releases or run it manually via the command line.
+
+### **Option 1: Download and Play (Recommended)**
+
+1. **Download the Game**: Go to the [Releases page](https://github.com/BerndHagen/ASCII-Orbit-Terminal-Shooter/releases) and download the latest version of the game as a **ZIP** file.
+
+2. **Extract the ZIP File**: Once downloaded, extract the contents of the ZIP file to your desired location.
+
+3. **Run the Game**: Double-click `ASCII Orbit.exe` to start the game.
+
+### **Option 2: Run with Command Line (For Developers or Advanced Users)**
+
+For users who prefer to clone the repository and run the game from their desktop via the command line, follow these steps:
+
+1. **Open Command Prompt**: Open Command Prompt as an administrator.
+
+2. **Clone the Repository**:
+ ```bash
+ git clone https://github.com/BerndHagen/ASCII-Orbit-Terminal-Shooter.git
+
+2. **Navigate to the Release Folder**:
+ ```bash
+ cd ASCII-Orbit-Terminal-Shooter\release
+
+2. **Run the Application**:
+ ```bash
+ start cmd /k ".\ASCII Orbit.exe"
+
+Make sure you launch the game in a **new** CMD window to prevent buffer overflow exceptions.
+
+## Rank Requirements
+
+In **ASCII-Orbit**, your performance at the end of the game is ranked based on your final score. Additionally, players earn `Extra Lives` by reaching specific score milestones, beginning at **10,000**. Each subsequent milestone doubles the previous one, progressing to **20,000**, **40,000** and so forth.
+Below is the list of score thresholds required to achieve each rank:
+
+| Rank | Score Required (Pts.) | Rank | Score Required (Pts.) |
+|------|-----------------------|------|-----------------------|
+| F | 0 Pts. | C+ | 63750 Pts. |
+| F+ | 3000 Pts. | B- | 74250 Pts. |
+| E- | 6750 Pts. | B | 85500 Pts. |
+| E | 11250 Pts. | B+ | 97500 Pts. |
+| E+ | 16500 Pts. | A- | 110250 Pts. |
+| D- | 22500 Pts. | A | 123750 Pts. |
+| D | 29250 Pts. | A+ | 138000 Pts. |
+| D+ | 36750 Pts. | S- | 153000 Pts. |
+| C- | 45000 Pts. | S | 168750 Pts. |
+| C | 54000 Pts. | S+ | 185250 Pts. |
+
+Players score points by hitting invaders. Each invader hit grants the player **50 points**. As players advance through levels, the points earned per hit increase by an additional **50 points** for each new level. To reach the next level, players must defeat a specific number of invaders, which increases with each level by 2
+
+For example:
+- To progress from Level 1 to Level 2, a player needs to defeat **5** invaders.
+- To progress from Level 2 to Level 3, a player needs to defeat **7** invaders.
+- To progress from Level 3 to Level 4, a player needs to defeat **9** invaders.
+
+## License Information
+
+ASCII-Orbit is licensed under the MIT License. You are granted permission, free of charge, to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of this project and its associated documentation files, under the following conditions:
+
+1. **Copyright Notice:** The above copyright notice and this permission notice must be included in all copies or substantial portions of the project.
+
+2. **Attribution:** If you use this project, you should credit the original creator in your work, documentation, or any materials that incorporate or use this project. Additionally, please include a link to the original repository created by the author when giving attribution.
+
+3. **No Warranty:** This project is provided "as is," without any warranties, whether express or implied, including but not limited to implied warranties of merchantability, fitness for a particular purpose, or non-infringement. In no case shall the author or copyright holder be liable for any claims, damages, or other liabilities, whether in a contract, tort, or otherwise, arising from the use of this project or any other dealings with the Software.
+
+For complete license details, please refer to the [MIT License](LICENSE).
+
+## Screenshots
+Before downloading the project, you can review the screenshots below to preview its appearance. Each image displays a different screen of the Windows console application. Be aware that future updates may introduce additional features.
+
+| ASCII-Orbit - Titlescreen | ASCII-Orbit - In Game | ASCII-Orbit - Game Over |
+|------------------------------|------------------------------|------------------------------|
+| 
| 
| 
|
diff --git a/img/v1.0.0-ascii-orbit-game.png b/img/v1.0.0-ascii-orbit-game.png
new file mode 100644
index 0000000000000000000000000000000000000000..8f274ae94415a125ba94e2e50cb4630d3ab69a89
GIT binary patch
literal 9319
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
literal 0
HcmV?d00001
diff --git a/img/v1.0.0-ascii-orbit-title.png b/img/v1.0.0-ascii-orbit-title.png
new file mode 100644
index 0000000000000000000000000000000000000000..2db431adece934588b4a0b9cb7a897a003517b1c
GIT binary patch
literal 9732
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