Virtual Pet System

Adopt companions, spin the gacha machine, train your pet through battles, and collect rare creatures across four rarity tiers.

Kythia's Virtual Pet system is a fully featured companion game built into your Discord server. Adopt a creature, keep it fed and happy, level it up through play, and use the gacha system to roll for rarer pets — all without leaving Discord.

Getting Started — Adoption

Before anything else, you need a pet! Use the adoption command to pick your first companion:

/pet adopt

This opens an interactive menu showing all available pets. Once you choose one, give it a name and it becomes yours.

Each user can own one pet at a time. To get a different pet, you can sell yours or use the Gacha system to roll for a new one.

Rarity System

There are four rarity tiers, each with different base stats and visual flair:

Rarity	Stars	Drop Rate	Notes
Common	⭐	Very High	Easy to obtain, good for getting started
Rare	⭐⭐	High	Noticeably stronger stats
Epic	⭐⭐⭐	Medium	Rare drops, harder to get
Legendary	⭐⭐⭐⭐	Very Low	The top tier — impressive power

The Gacha System

The gacha machine lets you trade in your current pet for a randomly rolled replacement. The new pet's rarity is influenced by the rarity of the pet you're rolling with.

/pet gacha

Rarity Probability Table:

Your Current Pet	Same Rarity	Higher Rarity
Common	90%	10%
Rare	75%	10%
Epic	50%	10%
Legendary	10%	N/A (already max)

Gacha replaces your current pet permanently. Your pet's name carries over, but your new pet starts at 40% of your previous pet's level. Plan your rolls strategically!

Cooldown: The gacha machine has a 24-hour cooldown by default (configurable by the bot owner).

Keeping Your Pet Happy

Your pet has core stats that you must manage:

Feeding

/pet feed

Restores your pet's hunger stat. A hungry pet will be unhappy and may perform worse in play sessions. Feed regularly to keep your companion in peak condition.

Playing

/pet play

Engages your pet in an activity session. Playing raises happiness, grants the pet experience points, and may trigger level-ups. This is the primary way to grow your pet's level.

Both Feed and Play have cooldowns. Check /pet info to see your pet's current hunger, happiness, and when you can next interact.

Items & Skills

Using Items

/pet use item: <item-name>

Apply a consumable item to your pet. Items can restore stats, temporarily boost performance, or trigger special events.

Checking Your Pet's Info

/pet info [user]

Displays a full profile of your pet (or another user's), including:

Pet name, species, icon, and rarity
Current level and experience
Hunger and happiness bars
Last gacha timestamp

Selling Your Pet

/pet sell

Sells your current pet for KythiaCoins (the global economy currency). The sell price scales with your pet's level and rarity. Once sold, you're free to adopt a new pet.

Leaderboard

/pet leaderboard

See who has the highest-level pet in the server. Compete with your friends to raise the most powerful companion.

Admin Controls

Server admins and bot owners have access to special management commands:

/pet admin add     # Add a new pet species to the pool
/pet admin delete  # Remove a pet species
/pet admin list    # View all pet species in the database

The add and delete commands allow full customization of which pets are available on your server, including their name, icon, rarity, and base stats.

Configuration

pet: {
  active: true,
  gachaCooldown: 86400, // Seconds between gacha rolls (default: 24 hours)
},