Rust Game Project

A simple 2D game built with ggez game engine, demonstrating practical Rust concepts for game development.

Concepts Covered

This project demonstrates several important Rust concepts for game development:

1. Game Engine Usage with ggez
2. 2D Graphics Programming
3. Game Loop Implementation
4. Input Handling with keyboard events
5. Vector Mathematics with glam crate
6. Random Number Generation with rand crate
7. State Management in games
8. Collision Detection

Project Structure

game/
├── Cargo.toml
├── src/
│   └── main.rs
└── resources/
    └── (optional asset files)

Setup

1. Make sure you have Rust and Cargo installed:

   curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

2. Navigate to the project directory:

   cd rust-tutorial/projects/game

3. Build and run the project:

   cargo run

Game Mechanics

This is a simple "dodge the enemies" game where:

• You control a green square at the bottom of the screen
• Red squares fall from the top of the screen as enemies
• You move left and right to avoid the enemies
• Your score increases the longer you survive
• If an enemy touches you, the game ends
• Press 'R' to restart after game over
• Press 'Escape' to quit the game

Controls

• Left Arrow Key: Move player left
• Right Arrow Key: Move player right
• R Key: Restart game (when game over)
• Escape Key: Quit game

How It Works

The game uses ggez as the game engine which provides a simple game loop and graphics rendering capabilities.

Key Components

1. GameState struct - Manages the game state including player position, enemies, score, and game over status
2. Enemy struct - Represents enemies with position and velocity
3. Game Loop - Implements the update and draw methods for the game loop
4. Input Handling - Processes keyboard input for player movement and game controls
5. Graphics Rendering - Draws the player, enemies, and score to the screen
6. Collision Detection - Checks for collisions between player and enemies

Game Loop

The game loop consists of two main methods:

• update() - Updates game logic (enemy movement, collision detection, etc.)
• draw() - Renders graphics to the screen

Running Tests

To run the tests for this project:

cargo test

Building for Release

To build an optimized version for release:

cargo build --release

The executable will be in target/release/rust-tutorial-game.

Extending the Project

Possible extensions for this project:

1. Add sound effects using ggez audio capabilities
2. Implement different enemy types with varying behaviors
3. Add power-ups and collectibles
4. Implement a high score system
5. Add more complex graphics with sprites
6. Implement multiple levels with increasing difficulty
7. Add a main menu and game states
8. Implement particle effects for explosions