Skip to content

Denzelxo/Virtual-Pet-Simulator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

5 Commits
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿพ Virtual Pet Simulator ๐Ÿพ

Welcome to your very own Digital Pet Playground, where cuteness meets code! This Python-based pet emulator lets you care for, play with, and train a virtual buddy โ€” and it's packed with personality. Whether youโ€™re raising a cat, dog, bird, or even a turtle, this project brings your console to life ๐Ÿถ๐Ÿฑ๐Ÿฆ๐Ÿข.


๐ŸŽฏ Objective

To build an interactive terminal-based simulator using OOP concepts in Python. Users can create a pet and interact with it through various actions like feeding, playing, sleeping, and even teaching tricks!


๐Ÿง  Features & Fun Facts

Feature Description
๐Ÿถ name Every pet needs a name! Choose one or get a fun random suggestion.
๐Ÿš hunger Tracks how hungry your pet is (0 = full, 10 = very hungry).
โšก energy Determines how active your pet is (0 = exhausted, 10 = fully rested).
๐Ÿฑ happiness The mood lifter โ€” the higher, the better!
๐ŸŽ“ experience Pets level up as they learn tricks and play games.
๐ŸŽ‚ age Your pet grows over time (especially while sleeping).
๐Ÿง  mood A dynamic attribute calculated from energy and happiness.
๐ŸŽƒ tricks Teach your pet new tricks and see their progress!

๐Ÿ•น๏ธ How It Works

Create your pet and interact through a simple terminal menu:

  1. ๐Ÿ– Feed your pet
  2. โšฝ Play with your pet
  3. โœ๏ธ Teach your pet a trick
  4. ๐Ÿ“ƒ Check your pet's status
  5. ๐Ÿ˜ด Let your pet sleep
  6. ๐ŸŽƒ Show known tricks
  7. ๐ŸŽฎ Play a mini-game
  8. โŒ Exit

---

## ๐Ÿ”ฅ Bonus Features

- ๐ŸŽฎ **Mini-Game**: Number guessing game that boosts happiness and XP!
- ๐ŸŽ“ **Training System**: Teach tricks based on your petโ€™s mood and energy.
- โค๏ธ **Favourite Food**: Feed your pet what it loves most for bonus happiness!
- ๐Ÿ˜ด **Mood Mechanics**: Pet moods dynamically shift based on stats.
- ๐Ÿง  **Randomized Pet Names and Personalities** to keep it fresh every time.

---

## ๐Ÿ Tech Stack

- Python 3.x
- OOP Principles (Classes, Methods, Attributes)
- Random module
- Sleep/time simulation for realism

---

## ๐Ÿš€ Getting Started

1. Clone the repo:
   ```bash
   git clone https://github.com/Denzelxo/Virtual-Pet-Simulator.git
   cd virtual-pet-simulator
  1. Run the simulator:

    python main.py
  2. Enjoy your digital buddy! ๐ŸŽฎ


๐Ÿ“‚ File Structure

โ”œโ”€โ”€ main.py        # Main game loop and user interface
โ”œโ”€โ”€ pet.py         # Pet class definition with all attributes and methods
โ””โ”€โ”€ Readme.md      # Project documentation (this file!)

๐Ÿ‘จโ€๐Ÿ’ป Made with ๐Ÿ’š by

  • Denzel Odhiambo

๐Ÿ“ธ Sneak Peek

"You played with Luna! Luna is ecstatic! ๐ŸŽ‰"
"Luna has learned a new trick: Backflip!"
"Lunaโ€™s current mood: Happy ๐Ÿ˜Š"


๐Ÿ’ก What Youโ€™ll Learn

  • Object-Oriented Programming (OOP)
  • State management in simulations
  • Working with time delays and random events
  • Writing interactive command-line applications

๐Ÿ Future Ideas

  • Save/load pet profiles
  • More interactive games
  • Sound or graphical UI using Pygame

๐Ÿพ Thanks for playing! Your virtual pet says hi! ๐Ÿ‘‹

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages