🐾 Tamalama (Tamagotchi)

Tamalama is an interactive desktop virtual pet simulator built with C# and WPF. Inspired by the classic Tamagotchi, this project features a dynamic pet growth system, life-status management, and a variety of arcade mini-games to earn in-game currency.

---

🌟 Key Features

• Dynamic Lifecycle: Start your journey with an egg and watch your pet hatch and grow into a baby llama.
• Vital Stats Management: Monitor and maintain five core attributes:
  • 🍖 Hunger: Feed your pet to keep it full.
  • 😊 Happiness: Play games to keep your pet's spirits high.
  • ❤️ Health: Administer medicine when your pet falls ill.
  • 🧼 Cleanliness: Keep your pet and its environment tidy.
  • 💤 Sleep: Let your pet rest to recover energy and health.
• Economy System: Earn money through mini-games to buy essential items in the shop.
• Customizable Experience: Adjustable difficulty levels (Easy, Medium, Hard) that affect how fast stats deplete.

---

🎮 Integrated Mini-Games

The "Mini-Game Hub" allows you to earn coins through five different activities:

1. 🦖 Dino Game: A classic side-scrolling runner. Jump over obstacles and survive as long as possible.
2. 🐍 Snake: The legendary arcade game. Eat food to grow longer, but don't hit the walls or yourself!
3. 🌿 Plant Game: A gardening simulator. Help a seed grow into a beautiful flower through various growth stages.
4. 🦙 Clean Llama: An interactive cleaning task where you manually scrub spots off your pet.
5. 👿 Devil Evil Game: A hardcore platformer featuring "Weird Modes" like inverted controls, gravity shifts, and portals.

---

🛠 Technical Overview

• Language: C#
• Framework: .NET Framework 4.8
• UI Technology: WPF (XAML)
• Architecture:
  • Pet.cs: Contains the core logic for stat degradation and recovery.
  • GameSettings.cs: Implements the Singleton pattern and INotifyPropertyChanged for global application settings.
  • DispatcherTimer: Used for real-time game loops and status updates.

---

🚀 Installation & Setup

1. Requirements: Visual Studio 2022 (with ".NET desktop development" workload).
2. Clone the Repository:

   git clone [https://github.com/maxos-pl/tamalama.git](https://github.com/yourusername/tamalama.git)

3. Open Solution: Launch tamagoci.sln in Visual Studio.
4. Run: Press F5 to build and start the application.
   • Note: In DEBUG mode, the hatching process is significantly faster for testing purposes.

---

📂 Project Structure

• MainWindow.xaml — Main menu and navigation.
• GameWindow.xaml — Primary pet interaction screen.
• MiniGamesWindow.xaml — Gateway to the arcade modules.
• Pet.cs — Business logic for the pet's behavior.
• Images/ — Graphic assets including pet states (egg, baby, sick, sad).

---

📝 License

Developed as an educational project. Feel free to use and modify for learning purposes!

---

Created in 2025. Versions: v1.0