A Tamagotchi-style virtual pet that lives in your terminal with tmux integration.
🖤 Lifecycle Mechanics
- 3 Life Stages: Baby (0-24h), Child (24-48h), Adult (48h+)
- Natural aging with eventual death from old age (~3 days)
- 4 Death Causes: Neglect, Starvation, Sickness, Old Age
- Random illnesses requiring medicine
- Permanent death state
📊 Core Stats System
- Health: Combined metric affected by all stats
- Hunger: Drains faster when awake (5%/hr vs 3%/hr sleeping)
- Happiness: Affected by other stats and interactions
- Energy: Recovers while sleeping, drains when playing
- Age: Tracks lifespan in hours
💊 Care System
- Feed (🍗 +30% Hunger)
- Medicine (💊 Cure sickness +30% Health)
- Play (🎾 +30% Happiness)
- Discipline (🪄 Prevent bad behavior)
- Sleep (😴 Energy recovery)
Displays one of these statuses:
😸 Happy | 🙀 Hungry | 😾 Tired | 😿 Sad | 😴 Sleeping | 💀 Dead
# 1. Clone repo
git clone https://github.com/yourusername/vpet.git
cd vpet
# 2. Build binary
go build -o vpet main.go
## Tmux
The tmux integration is pretty hacky for now.
Update VPET_DIR in vpet.tmux and run `bash vpet.tmux` once tmux is running.
## Gameplay
```bash
# Start interactive mode
vpet
# Update stats without UI (for tmux)
vpet -u
# Check current status
vpet -status| Stat | Awake Rate | Sleeping Rate | Care Action |
|---|---|---|---|
| Health | -5%/hr* | -3%/hr* | Medicine +30% |
| Hunger | -5%/hr | -3%/hr | Feed +30% |
| Energy | -5%/2hrs | +10%/hr | Sleep |
| Happiness | -2%/hr** | -2%/hr** | Play +30% |
*When any stat <30%
**When Hunger/Energy <30%
↑/↓ Navigate menu
Enter Select action
q Quit and save
Your pet continues aging even when closed! Stats save to:
~/.config/vpet/pet.json