Skip to main content

Play Online

The fastest way to try Procedural Pac-Man 3D is through the live demo:

Play Now

Try the game instantly in your browser

Run Locally

Follow these steps to run the game on your local machine.
1

Clone the Repository

Clone the project repository to your local machine:
git clone https://github.com/gsandoval96/TFG-UGR.git
cd TFG-UGR
2

Navigate to the Game Directory

Navigate to the pacman directory where the game files are located:
cd pacman
3

Start the HTTP Server

Start a local HTTP server using Python. This is required because the game loads resources using JavaScript modules:
python -m http.server
If you have Python 2.x, use python -m SimpleHTTPServer instead.
The server will start on port 8000 by default.
4

Open in Browser

Open your web browser and navigate to:
http://localhost:8000/src/
The game should load and you can start playing immediately!

System Requirements

  • Python: Version 2.7+ or 3.x (for running the local HTTP server)
  • Web Browser: Modern browser with WebGL support
    • Chrome (recommended)
    • Firefox
    • Safari
    • Edge
The game uses Three.js for 3D rendering, which requires WebGL support in your browser. Most modern browsers support this by default.

Browser Compatibility

The game requires:
  • WebGL-enabled browser
  • JavaScript enabled
  • Support for ES6 features

What You’ll See

Once the game loads, you’ll see:
  • A 3D procedurally generated maze
  • Pac-Man character ready to move
  • Ghost enemies with AI pathfinding
  • Score display and game controls
  • FPS counter for performance monitoring

Controls

Use the arrow keys or WASD to move Pac-Man through the maze. The camera follows the player automatically.

What’s Next

Architecture Overview

Learn about the game’s architecture and key components

Procedural Generation

Discover how mazes are procedurally generated

Scene Structure

Understand the 3D scene and camera system

AI & Pathfinding

Explore ghost AI and A* pathfinding

Build docs developers (and LLMs) love