https://github.com/zpg6/asm-galacta
Extensions to a game I wrote in Assembly back in college. Uses MARS (MIPS Simulator). Inspired by the classic arcade game Galaga.
https://github.com/zpg6/asm-galacta
Last synced: about 1 year ago
JSON representation
Extensions to a game I wrote in Assembly back in college. Uses MARS (MIPS Simulator). Inspired by the classic arcade game Galaga.
- Host: GitHub
- URL: https://github.com/zpg6/asm-galacta
- Owner: zpg6
- License: mit
- Created: 2024-12-07T19:19:22.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-12-08T14:56:51.000Z (over 1 year ago)
- Last Synced: 2025-02-09T16:36:50.247Z (over 1 year ago)
- Language: Assembly
- Homepage:
- Size: 9.02 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# asm-galacta
This was probably my favorite Computer Science project in college, and I have been wanting to revisit it for a while.
It is a simple game written in MIPS Assembly Language, runnable cross-platform using a Java runtime. The player controls a spaceship that can move left/right/up/down (arrow keys), and shoot projectiles at the enemies (B). It is loosely based on the classic arcade game [Galaga](https://en.wikipedia.org/wiki/Galaga).
Building this game was a great learning experience, and I am proud of the result to this day. About a year later was when I began learning app development in native iOS, and I can see now how this project was a stepping stone to that type of thinking.
## Features
- Welcome screen with animated rainbow border
- Keyboard input for player movement and shooting
- Enemy spawning locations and timing randomized
- HUD with ammo, score, and lives
- Explosion animations when an enemy is hit
- Health drops to restore lives
- Game over screen with final score
## Running the game
### Prerequisites
- Java 8+ (I used [Liberica JDK 21 LTS](https://bell-sw.com/pages/downloads/#jdk-21-lts))
- Clone this repository:
```
git clone https://github.com/zpg6/asm-galacta.git
```
### 1. Open the JAR for the MIPS Simulator (`tools/Mars.jar`) and open the `src/game.asm` file.
### 2. Be sure to select "Assemble All Files" in the Settings menu.
### 3. Click the "Assemble" button and then the "Run" button.
### 4. Open the "Keypad and LED Display Simulator" and click the "Connect to MIPS" button.
### 5. Play the game!
Use the arrow keys to move the spaceship and the B key to shoot. Try to get the highest score you can!
If you lose a life, collect a falling health orb to restore one.
