> For the complete documentation index, see [llms.txt](https://zoomiescore.gitbook.io/zoomiescore-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://zoomiescore.gitbook.io/zoomiescore-docs/docs/features/pets.md).

# pets

Adopt, feed, train, battle and trade pets. Fully per-guild.

## Getting started

```
/adopt species:<name> name:<display name>   → get your first pet
/pets                                        → see everyone you've adopted
```

`species` autocompletes from the current pet catalog. Names are cosmetic — you can `/rename-pet` any time.

## Care loops

| Command             | What it does                                                              |
| ------------------- | ------------------------------------------------------------------------- |
| `/feed pet_id food` | Restore hunger; some foods buff stats                                     |
| `/play pet_id toy`  | Play session — mood + XP boost                                            |
| `/collect`          | Collect passive currency your pets have generated since your last collect |

Neglecting hunger or mood too long drops the pet's stats until you recover them.

## Battles

```
/pet-battle              → pit one of your pets vs another's
```

Battles use per-species base stats + XP + food buffs. Winner earns XP + a small coin payout.

## Trading

```
/pet-trade user pet_id      → propose a trade
/pet-trade-accept trade_id  → the target confirms
```

Trades are atomic — either both sides swap or neither does. No half-completed trades are possible.

## Marketplace

```
/market                          → browse pet listings
/market-list pet_id price        → list one of your pets for sale
/market-buy listing_id           → purchase
```

## Cosmetics

```
/pet-skin pet_id skin_name       → apply a purchased skin
```

Skins are unlocked from the shop and applied per-pet.

## Rename

```
/rename-pet pet_id name          → change display name (cosmetic only)
```

## Per-guild isolation

Pets live in the guild you adopted them in. Moving to another server means starting fresh — a design choice to keep economies from being gamed across communities.