Skip to content

README.md

Latest commit

 

History

History
85 lines (61 loc) · 2.26 KB

README.md

File metadata and controls

85 lines (61 loc) · 2.26 KB
Raw

pacmango

Classic pacman for the terminal, written in Go

pacmango gameplay demo

Features

  • Authentic Pacman gameplay with pellets, power-ups, ghosts, and scoring
  • 9 challenging levels with progressive difficulty and unique maze layouts
  • Smooth continuous movement with pending direction system for responsive controls
  • Intelligent ghost AI that chases and flees based on power-up state
  • Terminal-optimized UI using goncurses
  • Cross-platform compatibility - runs anywhere Go runs

Installation

Via go install

go install github.com/ashish0kumar/pacmango@latest

Build from Source

# Clone the repository
git clone https://github.com/ashish0kumar/pacmango.git
cd pacmango

# Build the application
go build

# Move to a directory in your PATH
sudo mv pacmango /usr/local/bin/

Usage

# Start the game
pacmango

# Start from a specific level
pacmango --level 5

Controls

  • Arrow Keys or WASD: Move Pacman
  • P: Pause/unpause the game
  • Q: Quit the game

Gameplay

  • Eat all pellets (.) to complete the level
  • Power-ups (*) make you invincible and allow you to eat ghosts
  • Avoid ghosts unless you're invincible
  • Score points by eating pellets and ghosts

Acknowledgements

  • Original Pacman by Namco
  • goncurses for terminal UI capabilities

Contributing

Contributions are welcome! If you have ideas for improvements or bug reports, please feel free to open an issue or submit a pull request.


catppuccin

© 2025-present Ashish Kumar

LICENSE