____                           _     _____ _     _       __ 
|  _ \ _ __ ___  ___  ___ _ __ | |_  |_   _| |__ (_) ___ / _|
| |_) | '__/ _ \/ __|/ _ \ '_ \| __|   | | | '_ \| |/ _ \ |_ 
|  __/| | |  __/\__ \  __/ | | | |_    | | | | | | |  __/  _|
|_|   |_|  \___||___/\___|_| |_|\__|   |_| |_| |_|_|\___|_|  

Present Thief is a blazingly fun, retro-style stealth platformer where you infiltrate the North Pole to recover stolen presents. Built with Rust and the Turbo Game Engine for maximum festive chaos in a beautiful 256×144 pixel experience.

🚀 Why Present Thief?

Stop playing boring platformers. Whether you're dodging guards, hacking security doors, or chaining present collections for massive combo bonuses, Present Thief delivers holiday heist excitement with zero compromise.

• 🔥 Blazing Fast - Rust-powered performance running at buttery smooth 60fps
• 🎯 Smart AI - Guards with patrol routes, detection meters, and hive-mind alerts
• 🌈 Beautiful Pixels - Retro 256×144 resolution with snow particles and festive themes
• 🔄 10 Levels - Progressively challenging stages from tutorial to ultimate heist
• 🎮 Smooth Controls - Wall jumps, double jumps, slides, and precision platforming
• 🎵 Full Audio - Festive BGM and satisfying sound effects

✨ Features

• High Performance - Native Rust with WebAssembly target for browser play
• Stealth Mechanics - Crouch for silence, time your moves, avoid detection
• Hacking Minigame - Simon-says style puzzles to bypass security doors
• Combo System - Chain collections for up to 2.5x score multipliers
• Dynamic Difficulty - Game adapts based on your performance
• Adaptive AI - Guards share alerts via radio, coordinate searches
• Score Tracking - Stealth bonuses, speed bonuses, ghost mode rewards
• 100% Offline - No internet required, pure local gaming fun

⚡ Installation

Quick Install (Recommended)

cargo install turbo --locked
git clone https://github.com/GauravS13/Present-Thief.git
cd Present-Thief
turbo run -w .

From Source

git clone https://github.com/GauravS13/Present-Thief.git
cd Present-Thief
cargo build --release
turbo run -w .

Play in Browser

turbo build --release
# Open www/index.html in your browser

🏁 Quick Start

# Run the game
turbo run -w .

# Controls while playing:
# WASD/Arrows = Move
# SPACE = Jump (double jump in air!)
# S = Crouch (quieter movement)
# E = Hack nearby doors
# ESC = Pause
# R = Restart level

💫 Gameplay Guide

The Basics

# Your Mission:
- Collect all presents in each level
- Avoid detection by patrolling guards
- Hack security doors to access new areas
- Complete levels as fast and stealthily as possible

Stealth Moves

# Movement Options:
- Walk normally = standard speed, some noise
- Crouch (S) = slower but much quieter
- Slide (Run + Crouch) = fast and low profile
- Wall Jump = reach higher platforms
- Double Jump = extra air mobility

Pro Tips

# Maximize Your Score:
- Ghost Bonus = complete with zero alerts triggered
- Stealth Collect = grab presents while undetected (+500)
- Combo Chain = collect quickly for up to 2.5x multiplier
- Speed Run = faster times mean bigger bonuses

🎯 Controls Reference

Action	Keyboard	Gamepad
Move	WASD / Arrows	D-PAD
Jump	SPACE	A
Double Jump	SPACE (in air)	A (in air)
Crouch	S / Down	Down
Slide	Run + S	Run + Down
Hack	E	B
Restart	R	-
Pause	ESC	Start
Help	H	-

🏆 Scoring System

Bonus Type	Points	How to Earn
Base Present	+1000	Collect any present
Stealth Bonus	+500	Collect while undetected
Hack Bonus	+500	Successfully bypass a door
2x Combo	+1000	2nd quick collection
3x Combo	+2000	3rd quick collection
2.5x Combo	+2500	4th+ quick collection

📊 Real-World Impact

Before Present Thief:

• 🎮 Boring platformers → 😴 Slow, repetitive gameplay
• 🤖 Dumb AI → 🙄 Predictable, easy enemies
• 🎨 Generic graphics → 😑 Forgettable visuals

After Present Thief:

• 🎮 Stealth + Action → ⚡ Heart-pounding heist moments
• 🤖 Smart Guards → 🧠 Adaptive AI that coordinates
• 🎨 Pixel Perfect → ❄️ Beautiful festive atmosphere

🛠️ System Requirements

• Rust: 2024 Edition (for building from source)
• Turbo CLI: Latest version
• Platforms: Windows, macOS, Linux, Web (WASM)
• Resolution: 256 × 144 pixels (scaled)
• Memory: Minimal - runs on almost anything

📁 Project Structure

Present-Thief/
├── src/
│   ├── lib.rs        # Main game loop and state
│   ├── entities.rs   # Player, guards, presents
│   ├── physics.rs    # AABB collision detection
│   ├── stealth.rs    # Detection mechanics
│   ├── ai.rs         # Guard AI + difficulty director
│   ├── hacking.rs    # Simon-says minigame
│   ├── levels.rs     # 10 handcrafted levels
│   ├── themes.rs     # Visual themes per level
│   └── sprites.rs    # Drawing utilities
├── audio/            # BGM + SFX (wav files)
├── assets/           # Images and graphics
├── www/              # Web build output
├── Cargo.toml        # Rust dependencies
└── turbo.toml        # Turbo engine config

🎄 Level Progression

1. Tutorial - Learn the ropes (no guards)
2. First Guard - Introduction to stealth
3. Adding a Door - Hacking 101
4. Two Guards - Double trouble
5. Vertical Challenge - Master the platforms
6. Two Doors - Multiple hacks required
7. Three Guards - Patrol coordination
8. Tight Corridors - Limited escape routes
9. Complex Maze - Navigation nightmare
10. Final Challenge - Everything at once!

🌟 Created By

GauravS13 - Building games that bring holiday joy.

• 🐙 GitHub: @GauravS13
• 🚀 Project: Present-Thief

🤝 Contributing

Found a bug? Have a cool feature idea? Contributions make the holidays brighter!

1. Fork the repo
2. Create your feature branch (git checkout -b amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin amazing-feature)
5. Open a Pull Request

📄 License

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

---

Made with ❤️ and lots of 🎄 by GauravS13

If Present Thief brought you holiday joy, consider giving it a ⭐ on GitHub!

🎅 PRESS START TO STEAL CHRISTMAS BACK 🎅