RustyBuddy

🎉 RustyBuddy is a fun and interactive CLI-based pet simulation game written in Rust! Create your virtual pet, take care of it, and watch it grow. Feed, play, and let your buddy sleep while keeping track of its stats and mood.

Features

• 🐾 Create Your Buddy: Choose a name and type (e.g., Cat, Dog, Dragon) for your virtual pet.
• 🎭 Dynamic Moods: Your pet's mood changes based on hunger, happiness, and energy.
• 🍖 Feed Your Pet: Satisfy your pet’s hunger with food.
• 🎾 Play With Your Pet: Increase your pet's happiness by playing games.
• 💤 Let Your Pet Sleep: Restore your pet's energy with rest.
• 🕒 Aging System: Your pet grows older over time.
• 🎨 ASCII Animations: Cute animations for actions like eating, playing, and sleeping.
• 🏆 Achievements: Celebrate milestones like birthdays and achievements.
• 💾 Save and Load: Save your pet’s state and continue later.

Installation

Prerequisites

• Install Rust if you haven't already.

Install via cargo

cargo install rustybuddy

Usage

Run the program from your terminal using the rustybuddy command.

Commands

Examples

Create a New Pet

rustybuddy new --name Fluffy --kind Dragon

View Stats

rustybuddy stats

Feed Your Pet

rustybuddy feed

Play with Your Pet

rustybuddy play

Save and Load

Save the pet state:

rustybuddy save

Load a saved pet:

rustybuddy load

How It Works

RustyBuddy uses a JSON file (pet.json) to save your pet's state. The pet's stats (hunger, happiness, energy, health, and age) decay over time, so regular care is necessary to keep your buddy happy and healthy.

Contributing

Contributions are welcome! If you’d like to improve the game, follow these steps:

1. Fork the repository.
2. Create a new branch:

   git checkout -b feature/awesome-feature
   

3. Commit your changes:

   git commit -m "Add awesome feature"
   

4. Push your branch:

   git push origin feature/awesome-feature
   

5. Open a pull request.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Future Enhancements

• 🐉 Pet Evolution: Unlock new appearances and abilities as your pet grows.
• 🌎 Multiplayer Mode: Let pets interact with each other.
• 📱 Mobile Version: Build a mobile app for RustyBuddy.
• 🎮 Mini-Games: Add fun mini-games to play with your pet.

Author

Created with ❤️ by Krish Maity.