Currently Unnamed 2D Platformer Game Engine

A 2D game engine and platformer built from scratch in C++ using OpenGL. This project demonstrates advanced graphics programming, physics simulation, and game architecture patterns.

🎮 Features

Core Engine Systems

• Custom OpenGL Renderer: Complete 2D rendering pipeline with VAO/VBO management and immediate-mode drawing
• Physics System: Sensor-based collision detection, gravity simulation, and frame-rate independent movement
• Component Architecture: Modular design separating rendering, physics, and game logic
• State Management: Clean state machine handling menu, gameplay, pause, and game-over states
• Debug Visualization: Real-time collision sensor display and performance monitoring

Gameplay Features

• Smooth, acceleration-based player movement
• Tilemap-based world system with custom .tmap file format
• Sensor collision detection between player and world
• AABB collision detection between player and entities
• Game state transitions (Menu → Play → Pause/Dead/Win)

🛠️ Technical Architecture

Graphics Pipeline

Vertex Data → VAO/VBO → Vertex Shader → Fragment Shader → Framebuffer

The engine uses a modern OpenGL approach with:

• Shader Management: Runtime shader compilation and uniform handling
• Matrix Transformations: MVP (Model-View-Projection) matrix pipeline
• Immediate Rendering: Direct draw calls optimized for 2D geometry (batched rendering planned)

Physics System

• Frame-rate Independent: Uses delta-time calculations for consistent movement
• Sensor-based Collision: Player uses collision sensors for ground detection and wall interactions
• AABB Detection: Axis-Aligned Bounding Box intersection tests for entity collisions

Component Design

GameManager
├── Window (GLFW)
├── Renderer2D (OpenGL)
├── Physics (Collision & Movement)
├── Input (Event Handling)
├── Tilemap (World Data)
└── PlayerObject (Game Entity)

🚀 Getting Started

Prerequisites

• C++17 compatible compiler
• OpenGL 3.3+ support

Building

# Clone the repository
git clone https://github.com/MTahaK/platformer_project.git
cd platformer_project

# Build using make
make

# Run the game
./game

Controls

A document describing controls in every game state is available in notes.

🎯 Key Technical Highlights

A key focus in this project is creating highly optimized systems that make conservative use of resources. I have a vendetta against modern video game 'optimization' and I want that to be realized through this project!

🔮 Future Enhancements

• Texture support and sprite rendering
• EXTENSIVE player movement mechanics
• Audio system integration
• Particle effects
• Level editor
• Animation system
• Multiple enemy/obstacle types
• Save/load functionality

🤝 Contributing

This is a personal learning project, but feedback and suggestions are welcome! Feel free to:

• Report bugs or issues
• Suggest architectural improvements
• Propose new features

📝 License

This project is open source and available under the MIT License.

🙏 Acknowledgments

• OpenGL: Graphics API
• GLFW: Window and input handling
• GLM: Mathematics library
• Dear ImGui: Debug interface components

---

This project serves as a comprehensive demonstration of C++ game engine development, graphics programming, and software architecture principles.