Documentation

Welcome to Petzilla

Petzilla is an idle Discord bot game where you mine ores, collect pets, and build a passive income empire. Pets earn tokens 24/7 while you're offline, creating a hands-off progression system that rewards patience.

This documentation covers all core mechanics, commands, and systems. Use the sidebar to navigate to specific topics.

Getting Started

Starter Pack

Begin your journey with /starter. This gives you:

Rusty Pickaxe (12× ore multiplier)
Rusty Shovel (max depth: 16)
1,000 starting tokens
10 pet collection slots

The starter pack is a one-time claim. After claiming, you can begin mining with pz mine.

Getting Started

Command Prefix

All text commands use the prefix pz followed by the command name. For example:

pz mine
pz balance
pz help

Slash commands use Discord's native command system and begin with / (e.g., /starter, /chest).

Run pz help for a quick start guide or pz help all to see all available commands.

Core Gameplay

Mining

Use pz mine to dig for ores. Each mine session finds 1-3 ores based on your current depth and pickaxe tier. Mined ores go into your inventory and can be sold for tokens with pz sell all.

You can specify a depth with pz mine [depth], but it must be within your shovel's max depth. Premium subscribers always mine at maximum depth automatically.

Mining has a 5-minute cooldown (2.5 minutes for premium users).

Core Gameplay

Ores & Depth Ranges

Different ores appear at different depth ranges. The deeper you mine, the rarer (and more valuable) the ores become. Use pz ores info to see depth charts in Discord.

Ore Categories

0-8 depth: Stone, Coal, Quartz (starter ores)
8-20 depth: Copper, Agate, Iron
20-50 depth: Topaz, Silver, Amethyst, Emerald, Ruby
50-95 depth: Sapphire, Alexandrite, Zircon, Sunstone
90-200 depth: Aetherstone, Void Quartz, Prismalite
200-256 depth: Chronogem, Astralite (endgame)
256-512 depth: Obsidian, Painite, Hazenite, Kyawthuite (Terrarium only)

Core Gameplay

Gear & Upgrades

Gear determines how deep you can mine and how many ores you extract per swing. There are two tool types:

Shovel: Determines max mining depth
Pickaxe: Multiplies the number of ores found

Both must be upgraded together to progress. You cannot skip tiers.

Tier	Max Depth	Ore Multiplier	Pet Capacity	Upgrade Cost
Rusty	16	12×	10	Free (starter)
Iron	32	24×	20	2,000 tokens
Steel	64	48×	40	7,000 tokens
Reinforced	128	96×	70	20,000 tokens
Mythic	256	132×	120	60,000 tokens
Groundbreaker	384	186×	200	180,000 tokens
Drill	512	248×	350	500,000 tokens

Upgrade with pz upgrade shovel or pz upgrade pickaxe. You must upgrade in order — you can't skip tiers. Pet collection capacity increases with your highest gear tier.

Core Gameplay

Pets Overview

Pets are companions that passively earn tokens over time. Open a chest with /chest (costs 500 tokens) to receive a random pet. Each pet has a species, color, and rarity that determines its base earning rate.

Use pz pets to see your 5 most recent pets, or pz pet <id> to view a specific one with full stats including level, XP progress, and earning multipliers.

Pet collection is capped by your gear tier. Upgrade tools to collect more pets.

Core Gameplay

Pet Leveling System v2.0

Pets can now be leveled from 1 to 100 using XP and Bolts. Higher levels increase both token earnings and XP gain rate, creating a powerful progression loop.

How Pets Gain XP

Pets gain XP passively every hour based on rarity
XP is awarded when you run pz collect
Higher level pets gain XP faster (Level 50 = 2× XP rate, Level 100 = 3× XP rate)

Leveling Up Pets

Use pz level <bolts> <petId> to level up a pet. The command will consume as many levels as possible with your provided Bolts and the pet's current XP.

Rarity	XP Per Hour	Level 1 Earnings	Level 100 Earnings
⚪ Common	2 XP/hr	15 tokens/hr	60 tokens/hr (4×)
🔵 Rare	5 XP/hr	45 tokens/hr	180 tokens/hr (4×)
🟣 Epic	12 XP/hr	120 tokens/hr	480 tokens/hr (4×)
🔴 Mythic	25 XP/hr	300 tokens/hr	1,200 tokens/hr (4×)
🟡 Legendary	50 XP/hr	750 tokens/hr	3,000 tokens/hr (4×)
🟢 Limited	15 XP/hr	225 tokens/hr	900 tokens/hr (4×)

Strategy tip: Focus on leveling Legendary and Mythic pets first for maximum return on investment. A Level 100 Legendary earns as much as 40 Level 1 Common pets.

Core Gameplay

Collecting Earnings

All your pets passively accumulate tokens AND XP every hour. Run pz collect to claim everything at once. Token earnings are capped at 7 days worth — after that they stop accumulating until you collect. XP has no cap.

Use pz collect info to view base earning rates and caps in Discord.

Each pz collect awards both tokens (based on time elapsed) and XP (based on time elapsed and pet level). Higher level pets gain XP faster!

Core Gameplay

Rarity & Drop Rates

Each chest has a randomized outcome. Drop rates are fixed and shown below.

⚪ Common

50% chance

🔵 Rare

30% chance

🟣 Epic

15% chance

🔴 Mythic

4% chance

🟡 Legendary

1% chance

Terrarium Chests (opened with Keys) guarantee a Limited rarity seasonal pet with 100% drop rate.

Economy

Tokens

Tokens are the primary in-game currency. Earn them by selling ores, collecting from pets, claiming daily rewards, and trading. Spend them on tool upgrades, chests, and marketplace pets.

Check your balance with pz balance. Send tokens to another player with pz pay <@user> <amount>.

Economy

Bolts v2.0

Bolts are a prestige currency used for pet leveling and purchasing the Season Pass. Convert tokens to Bolts with pz forge [amount].

Action	Rate
Convert tokens to Bolts	1 Bolt = 1,000 tokens
Season Pass purchase	15 Bolts
Level up pet (varies)	1-50 Bolts per level

Check your Bolt balance with pz bolts. Bolts cannot be converted back to tokens.

Economy

Inventory Management v2.0

View your complete inventory with pz inventory or pz inv. This shows your pet collection count, ore storage, tokens, Bolts, and current gear tier.

Pet Collection Capacity

Pet capacity is determined by your highest gear tier. Use pz capacity to view all tiers and their limits.

When you reach your pet capacity, you must either upgrade your gear or sell/trade pets to make space before opening more chests.

Economy

Marketplace

The marketplace lets players list and buy pets from each other. Listings expire after 7 days if not purchased.

pz marketView your active listings (max 5 shown).

pz list <id> <price>List one of your pets for sale.

pz buy <listingId>Purchase a listed pet.

Browse all marketplace listings at petzilla.vercel.app/market.

You cannot buy your own listings. Pets with levels and XP retain their stats when sold.

Economy

Daily Rewards Updated

Run pz daily once every 24 hours to claim free tokens. The reward amount scales with your gear tier:

Gear Tier	Token Reward Range
Rusty	100 - 300 tokens
Iron	300 - 600 tokens
Steel	600 - 1,200 tokens
Reinforced	1,200 - 2,500 tokens
Mythic	2,500 - 5,000 tokens
Groundbreaker	5,000 - 10,000 tokens
Drill	10,000 - 20,000 tokens

Features

Subscription Perks Premium

Subscribing gives you tangible in-game advantages alongside exclusive information displays.

Perk	Free	Premium
Mining depth (unspecified)	Random depth	Always max depth
Mining cooldown	5 minutes	2.5 minutes
Ore yield	Normal	2× multiplier
Terrarium ore bonus	1.5× (if Season Pass)	3× total (2× + 1.5×)
Custom pet names	❌	✅
Profile backgrounds	❌	✅

Subscribe at petzilla.vercel.app/store to unlock these perks instantly.

Features

Season Pass Season I

The Season Pass unlocks access to the Terrarium Sandbox, exclusive seasonal pets, and enhanced ore rewards. Purchase with 15 Bolts using pz buypass.

Season Pass Benefits

🌿 Access to Terrarium Sandbox (0-512 depth)
💰 1.5× ore sell prices (3× total with Premium)
🗝️ 2% chance to find Terrarium Keys while mining
🐾 Exclusive Limited rarity pets (6 variants)
⛏️ Access to rare ores (Obsidian, Painite, Hazenite, Kyawthuite)

Learn more about Season I at petzilla.vercel.app/seasons/terrarium.