https://github.com/algosup/2023-2024-project-2-x86-retrogaming-team-5

This repository focuses on recreating the classic Pac-Man game in x86 assembly language, tailored for DosBox.
https://github.com/algosup/2023-2024-project-2-x86-retrogaming-team-5

assembly assembly-x86 dosbox pac-man-game

Last synced: about 5 hours ago
JSON representation

This repository focuses on recreating the classic Pac-Man game in x86 assembly language, tailored for DosBox.

• Host: GitHub
• URL: https://github.com/algosup/2023-2024-project-2-x86-retrogaming-team-5
• Owner: algosup
• Created: 2023-10-31T11:30:14.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2023-12-21T17:38:50.000Z (11 months ago)
• Last Synced: 2023-12-26T17:31:52.300Z (11 months ago)
• Topics: assembly, assembly-x86, dosbox, pac-man-game
• Language: Assembly
• Homepage:
• Size: 577 KB
• Stars: 1
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Prototype Launch Instructions

Thank you for your interest in trying out our prototype! Follow the steps below to get started.

## Step 1: Download DOSBox

Download and install DOSBox, a DOS emulator that allows you to run our prototype on modern systems.

- **Download Link:** [DOSBox](https://www.dosbox.com/download.php?main=1)

## Step 2: Install DOSBox

Follow the installation instructions provided on the DOSBox website for your specific operating system.

``If you already have dosbox installed on your machine, we recommend you to reinstall it to be able to launch the game correctly.``

## Step 3: Clone our project

Clone our project.

## Step 4: Build the project

Go in the main folder using the followings commands:

`cd algosup-workshop-master`

`cd srcs`

`cd main`

Then build the `build-main.cmd`

This will create an executable in the `bin` folder.

## Step 5: Launch DOSBox

Click on the `launch-dosbox.cmd` to open DOSBox. Enter the following commands on the DOSBox window:

```c:```

```main2.com```

Then you can play.

# Pac-Man - Rules of the Maze

## Introduction

Welcome to our Pac-Man game, a tribute to the real Pac-Man game! Navigate the maze, gobble up those pellets, and outsmart the ghosts to become the ultimate Pac-Master.

## Objective

Your mission is to guide Pac-Man through the maze, eating all the pellets in sight while avoiding the relentless ghosts. Each pellet brings you closer to victory, but beware - the ghosts are hungry for a chase!

## Controls

- Use the arrow keys to navigate Pac-Man through the maze:

  - ↑ : move up

  - ↓ : move down

  - ← : move left

  - → : move right

## Gameplay

- **Pellets**: Consume all the pellets in the maze to advance to the next level.

- **Power Pellets**: Devour these special pellets to turn the tables on the ghosts. When Pac-Man eats a Power Pellet, the ghosts turn blue, and Pac-Man can gobble them up for extra points!

- **Ghosts**: Avoid the colorful ghosts - Blinky, Pinky, Inky, and Clyde. They're out to get you, but watch out! Each ghost has its own unique behavior.

- **Fruits**: Grab the occasional fruit that appears in the maze for bonus points. It's a risk worth taking!

## Points

Rack up points as you navigate the maze and outsmart the ghosts.

- **Pellet**: 10 points

- **Power Pellet**: 50 points

- **Eating Ghosts**: 200, 400, 800, 1600 points (Eat ghosts consecutively for increasing points)

- **Fruits**: Varying points - keep an eye out for these juicy bonuses!

## Lives

Pac-Man starts with 3 lives. Lose a life if caught by a ghost. If you're skilled enough, you might earn extra lives along the way. Use them wisely!

## Game Over

The game ends when Pac-Man runs out of lives. Can you achieve the high score and become the Pac-Master?

**Good luck, and may your Pac-Man skills shine in the maze!**