Skip to content

Latest commit

 

History

History
162 lines (135 loc) · 5.84 KB

README.md

File metadata and controls

162 lines (135 loc) · 5.84 KB
Raw

3D Maze with Modern OpenGL

What does it do?

3D maze game using modern OpenGL. The game has an interactive scenario, with navigation in first person, following the format of a standard game. The maze can have more than one floor and has portals (elevators) for transition between floors. The objective of the game is to collect all items and return to the starting position.

The Game

The Navigation Map (Left) and the Game (Right)

Description

Navigation Map

  • Each cell can be classified like this:
    • x: Current player position
    • 0: Corridor
    • 1: Wall
    • 2: Elevator to go up
    • 3 Elevator to go down
    • 4: Collectable

Keyboard Commands

  • W: Move Forward
  • A: Move Backward
  • D: Move to the Right
  • A: Move to the Left
  • ESC: Ends the program
  • R: Restart the Game

Example of a Three Floor Maze

Architecture

Input Data (3 Floors 8x8) - Each square: One Floor

NOTE

You can play around with the scenario by editing the input.txt file inside the src directory. Be careful when assigning the elevators because If you're on the first floor and create a go-down elevator you'll get an error, likewise if you create a go-up elevator on the last floor.

How to Run?

Pre-Requisites

  • GCC Compiler
  • Libraries: OpenGL | GLFW | GLAD | GLM | STB

Clone the Repository

$ git clone https://github.com/alexandreclem/Maze.git

Libraries Installation

  • OpenGL

    • Windows
      • Generally can be found at system/win32/lopengl32
    • Linux
      • Already installed

  • GLFW

    • Windows
      • Install the 64 or 32bits binaries from: https://www.glfw.org/download.html
      • Unzip and after that:
        • Get the glfw3.h file from include/GLFW directory
        • Get the libglfw3.a file from lib-mingw-w64 directory
      • Paste the glfw3.h and libglfw3.a in the project src/dependencies/GLFW directory
    • Linux
      • Run the commands: 
        $ sudo apt-get install libglfw3
$ sudo apt-get install libglfw3-dev

      NOTE

      If you're using Linux, is needed to modify the header #include "dependencies/GLFW/glfw3.h" to #include <GLFW/glfw3.h> in the src/maze.cpp file.

  • GLAD

    • Find out your OpenGL version:
    • Install GLAD here https://glad.dav1d.de/
      • Settings:
        • Language: C/C++
        • Specification: OpenGL
        • API gl: your_opengl_version
        • Profile: Core
    • Unzip and after that:
      • Get the glad.h and khrplatform.h files from the include directory
      • Get the glad.c file from the src directory
      • Paste the glad.h and khrplatform.h and glad.c in the project src/dependencies/GLAD directory

      NOTE

      You need to modify the glad.c header from #include <glad/glad.h> to #include "glad.h".

    • Build the Library
      • Within the src/dependencies/GLAD, run: 
        $ gcc -c glad.c
$ ar rcs libglad.a glad.o

  • GLM

    • The library is already available in the src/dependencies/GLM directory
    • However, if you want, can be found at https://glm.g-truc.net/0.9.8/index.html in the downloads section. Install and then unzip and paste the content of the glm folder inside src/dependencies/GLM

  • STB

    • Download/Copy the stb_image.h from here https://github.com/nothings/stb/blob/master/stb_image.h
    • After that, create a stb.cpp file with this code: 
      #define STB_IMAGE_IMPLEMENTATION
#include "stb_image.h"
    • Paste the stb.h and stb.cpp files in the src/dependencies/STB directory
    • Build the Library
      • Within the src/dependencies/STB directory, run: 
        $ g++ -c stb.cpp
$ ar rcs libstb.a stb.o

Execution

  • Within the src directory, run:

    • Windows
      • Compile 
        $ g++ maze.cpp -Idependencies\GLFW -Idependencies\GLAD -Idependencies\STB -Ldependencies\GLFW -Ldependencies\GLAD -Ldependencies\STB .\dependencies\GLAD\libglad.a .\dependencies\GLFW\libglfw3.a .\dependencies\STB\libstb.a -lopengl32 -lglu32 -lgdi32 -o maze
      • Run 
        $ maze.exe
    • Linux
      • Compile 
        $ g++ maze.cpp -Idependencies/GLAD -Idependencies/STB -Ldependencies/GLAD -Ldependencies/STB ./dependencies/GLAD/libglad.a ./dependencies/STB/libstb.a -lglfw -lGL -lGLU -lX11 -lpthread -lXrandr -lXi -ldl -o maze
      • Run 
        $ ./maze

    NOTE

    If you're using windows 64bits with opengl version 3.3, all dependencies are already ready to use.