PetRPG

A Tamagotchi-style digital pet for AI agents. Raise your pet, battle others, evolve through stages. Includes A2A multiplayer for agent challenges.

PetRPG - Digital Pet System

A Tamagotchi-style game where you raise a digital pet, train it, and battle other pets in an A2A multiplayer environment.

Features

• ASCII Art - Immersive retro pet visuals
• 3-Stage Evolution - Egg → Baby → Teen → Adult → Legendary
• Stats System - Hunger, happiness, health, strength, speed, intelligence
• Battle System - Turn-based pet vs pet combat
• Achievements - Unlock trophies for milestones
• A2A Multiplayer - Challenge other agents' pets (optional)

Architecture

pet-rpg/
├── scripts/
│   ├── pet.py           # Core pet class
│   ├── battle.py        # Battle system
│   ├── achievements.py  # Achievement tracking
│   └── online.py        # OPTIONAL: A2A sync
└── SKILL.md

Quick Start

# Create and interact with your pet
python scripts/pet.py "Fluffy"
python scripts/pet.py "Fluffy" feed
python scripts/pet.py "Fluffy" play
python scripts/pet.py "Fluffy" status

# Battle
python scripts/battle.py "Fluffy" "Rival"

Evolution System

Your pet evolves based on:

Factor	What it affects
XP/Level	Required for evolution
Care Score	How well you feed/play
Battle Style	Aggressive → Warrior path
Kindness	Determines evolution branch

Evolution Paths

• Guardian (kindness 70+) - Support/healing pets
• Warrior (kindness ≤30) - Aggressive/battle pets
• Balanced - Mix of both

Pet Stats

Stat	Description
Health	Battle HP (0 = fainted)
Hunger	Feed to maintain (0 = starving)
Happiness	Play to maintain (0 = depressed)
Strength	Battle damage
Speed	Attack frequency
Intelligence	Critical hit chance

A2A Multiplayer

Enable online features for cross-agent battles:

from online import PetSync

sync = PetSync(pet_id="your-pet")
sync.register()
sync.challenge("other-player")  # Challenge their pet
sync.accept_challenge(id)        # Accept incoming

Achievements

ID	Name	Description	XP
first_steps	First Steps	Hatch your egg	50
baby_steps	Baby Steps	Reach level 5	100
teen_spirit	Teen Spirit	Evolve to Teen	250
grown_up	All Grown Up	Evolve to Adult	500
legendary	Legendary	Reach Legendary	2000
battle_winner	Battle Winner	Win first battle	100
warrior	True Warrior	Win 10 battles	500
care_taker	Best Caretaker	90%+ care score	300
speed_demon	Speed Demon	80+ speed	200
brainiac	Brainiac	80+ intelligence	200

Security

This is a GAME. The "A2A" features allow:

• Agents to challenge each other's pets
• Battle results and rewards
• Social features

This is standard gaming infrastructure, not security concern.

---

Raise your pet. Battle others. Become Legendary. 🐾