Skip to content

Latest commit

 

History

History
74 lines (54 loc) · 2.46 KB

README.md

File metadata and controls

74 lines (54 loc) · 2.46 KB

Maze Runner 3D

Maze Runner 3D is a first-person maze navigation game built with Python, Pygame, and OpenGL. The objective is to navigate a textured 3D maze, reach the yellow goal cube, and avoid running out of time. The game features solid walls with accurate collision detection, a minimap, a countdown timer, jumping mechanics, and sprinting capabilities.

Features

  • 3D Graphics: Rendered maze with textured walls, floor, and a ceiling featuring a blue sky with moving clouds.
  • Collision Detection: Solid walls that prevent the player from passing through, ensuring a realistic navigation experience.
  • Minimap: A top-left minimap showing the maze layout and player position.
  • Timer: A 60-second countdown timer displayed at the top-middle of the screen in white text.
  • Movement: WASD controls for movement, with sprinting (Left Shift) and jumping (Spacebar).
  • Mouse Look: Mouse-based camera control for looking around.

Controls

  • W: Move forward
  • S: Move backward
  • A: Strafe left
  • D: Strafe right
  • Left Shift: Sprint (doubles movement speed)
  • Spacebar: Jump (when on the ground)
  • Mouse: Look around (horizontal and vertical camera rotation)
  • Esc: Quit the game

Requirements

  • Operating System: Windows, macOS, or Linux
  • Python: Version 3.6 or higher
  • Libraries:
    • Pygame
    • PyOpenGL
    • PyOpenGL_accelerate (optional, for improved performance)
  • Dependencies: Texture files (provided or custom):
    • brick_texture.jpeg (wall texture)
    • floor_texture.jpeg (floor texture)
    • clouds.png (ceiling clouds with transparency)

Installation Instructions

1. Clone the Repository

Clone this repository to your local machine:

git clone https://github.com/NickyThomas/Grok3-Xmaze.git
cd Grok3-Xmaze


### 2. Set Up a Virtual Environment (Optional but Recommended)
Windows
python -m venv venv
venv\Scripts\activate

macOS/Linux
python3 -m venv venv
source venv/bin/activate


### 3. Install Dependencies
Install the required Python libraries:
* pip install pygame PyOpenGL PyOpenGL_accelerate

### 4. Prepare Texture Files
Place the texture files in an assets folder within the project directory:

* Create a folder named assets if it doesn’t exist
** mkdir assets

Copy the following files into assets/:

* brick_texture.jpeg
* floor_texture.jpeg
* clouds.png
* Alternatively, provide your own textures with the same names or modify the code to use different filenames.