Grok Space Shooter

Welcome to Space Shooter, a thrilling vertical scrolling space shooter game built with HTML5 and JavaScript! Take control of a spaceship, fend off waves of alien enemies, collect power-ups, and aim for the top of the leaderboard. Play it now at fubak.github.io/grok-space-shooter/!

Gameplay

• Objective: Destroy waves of alien ships while dodging their attacks to achieve the highest score.
• Controls:
  • WASD: Move your spaceship (up, left, down, right).
  • Esc: Pause the game.
  • Your ship fires automatically—focus on dodging and aiming!
• Features:
  • Levels: Each wave cleared advances you to a new level with faster, more numerous enemies.
  • Power-Ups: Collect icons to upgrade your speed or weapons (single, double, spread, missile).
  • Enemies: Four unique alien ship designs that shoot back, increasing in frequency per level.
  • Top Scores: Compete to be among the top 10 players (stored locally for now).

How to Play

1. Visit fubak.github.io/grok-space-shooter/ in your browser.
2. Use WASD to navigate your ship across the bottom half of the screen.
3. Shoot down enemies and grab power-ups to survive longer.
4. When the game ends, enter your name to save your score and try to beat the top 10!

Hosting

Space Shooter is hosted on GitHub Pages, a free static hosting service. The game runs entirely in your browser with no external dependencies.

• URL: fubak.github.io/grok-space-shooter/
• Source: All code is in index.html, a single file containing HTML, CSS, and JavaScript.

Development

Built from scratch using:

• HTML5 Canvas: For rendering the game.
• JavaScript: Core game logic and mechanics.
• CSS: Basic styling for the canvas.

Running Locally

1. Clone this repository:

   git clone https://github.com/fubak/grok-space-shooter.git
   

2. Open index.html in a web browser: On Windows/Mac: Double-click the file. Or use a local server (e.g., python -m http.server in the directory, then visit localhost:8000).

Current Features

• Dynamic canvas scaling to fit browser windows (minimum 480x640).
• Enemy waves with increasing speed and numbers.
• Power-ups with unique icons (speed, spread, double, missile).
• Local top 10 scoreboard (stored in localStorage).

Planned Enhancements

• Global leaderboard using a backend (e.g., Firebase).
• Sound effects and music.
• Mobile touch controls.

About

Enjoy this space shooter generated by Grok, an AI assistant by xAI! Developed by Brad Shannon with inspiration from classic shooters like Space Invaders and Radiant Silvergun.

Contributing

Love the game and want to help improve it? Contributions are welcome!

1. Fork this repository.
2. Create a branch:

git checkout -b feature/your-idea

3. Commit your changes:

git commit -m "Add your feature"

4. Push to your branch:

git push origin feature/your-idea

5. Open a Pull Request:

Suggestions? Open an Issue!

Credits

• Developer: Brad Shannon
• AI Assistance: Grok by xAI

License

This project is open-source under the MIT License. Feel free to use, modify, and share it!