Skip to content

ThatSINEWAVE/FluffBot

Repository files navigation

Banner

Meet FluffBot, a charming ASCII-art virtual pet that lives in your browser! Care for your digital companion by feeding, playing, and cleaning while enjoying retro-style animations and interactive behaviors.

Live Demo Here

Features

  • 12+ Animated States: Idle, eating, sleeping, playing, and more with frame-by-frame ASCII animations
  • Dynamic Stats System: Monitor hunger, happiness, energy, and cleanliness
  • Fast-Paced Gameplay: Time is accelerated, so stats decrease much faster than in real-time—keep up with your pet’s needs!
  • Interactive Controls: Feed, pet, play, clean, and put to sleep
  • Mouse Reactions: Curious pet follows the cursor and plays with clicks
  • Personality System: Pet changes states based on needs (hungry, bored, tired, etc.)
  • Persistent Progress: Auto-saves to localStorage
  • Customization: Rename your pet anytime
  • Responsive Design: Works on both desktop and mobile
  • Dark Mode Support: Automatic theme switching

How to Play

  1. Basic Care:

    • Feed when hunger is low
    • Play to boost happiness
    • Clean when dirty
    • Put to sleep when energy is depleted
  2. Mouse Interactions:

    • Move cursor near pet to surprise it
    • Click near pet for playful reactions
    • Watch it follow your cursor!
  3. Advanced Features:

    • Rename using the "Rename" button
    • Stats gradually decrease over time
    • Random idle animations and movements
    • Full reset option available

Installation

  1. Clone repository:
    git clone https://github.com/thatsinewave/FluffBot.git
  2. Open index.html in any modern browser

No dependencies required - Runs entirely in vanilla JavaScript!

Technologies Used

  • Modern JavaScript (ES6 Modules)
  • CSS Animations & Transitions
  • localStorage for data persistence
  • GitHub Pages for hosting
  • Pure ASCII art animations

Contributing

Feel free to submit issues or contribute improvements via pull requests.

License

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