https://github.com/thatsinewave/fluffbot
A web app where users can adopt and care for a virtual pet. Users can interact with their pet by feeding it, playing with it, and watching it grow.
https://github.com/thatsinewave/fluffbot
good-first-contribution good-first-issue good-first-issues good-first-pr good-first-pr-first-contribution good-first-prs html-css-javascript html-css-js pet pet-project pet-simulator pets thatsinewave virtual-pet virtual-pet-simulator virtual-pets virtualpet
Last synced: 13 days ago
JSON representation
A web app where users can adopt and care for a virtual pet. Users can interact with their pet by feeding it, playing with it, and watching it grow.
- Host: GitHub
- URL: https://github.com/thatsinewave/fluffbot
- Owner: ThatSINEWAVE
- License: mit
- Created: 2025-03-12T02:20:17.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2025-03-12T03:26:52.000Z (about 1 month ago)
- Last Synced: 2025-03-12T03:28:58.491Z (about 1 month ago)
- Topics: good-first-contribution, good-first-issue, good-first-issues, good-first-pr, good-first-pr-first-contribution, good-first-prs, html-css-javascript, html-css-js, pet, pet-project, pet-simulator, pets, thatsinewave, virtual-pet, virtual-pet-simulator, virtual-pets, virtualpet
- Language: JavaScript
- Homepage: https://thatsinewave.github.io/FluffBot/
- Size: 16.6 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# [FluffBot - Your ASCII Virtual Pet](https://thatsinewave.github.io/FluffBot)
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](https://thatsinewave.github.io/FluffBot)**
## 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
## ☕ [Support my work on Ko-Fi](https://ko-fi.com/thatsinewave)
## 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:
```bash
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
## [Join my Discord server](https://discord.gg/2nHHHBWNDw)
## Contributing
Feel free to submit issues or contribute improvements via pull requests.
## License
This project is open-source and available under the [MIT License](LICENSE).