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

Collecting Earnings

All your pets passively earn tokens every hour based on their rarity. Run pz collect to claim everything at once. Earnings cap at 7 days — after that they stop accumulating until you collect.

Rarity	Base Earn Rate	Default Cap
⚪ Common	15 tokens/hr	7 days
🔵 Rare	45 tokens/hr	7 days
🟣 Epic	120 tokens/hr	7 days
🔴 Mythic	300 tokens/hr	7 days
🟡 Legendary	750 tokens/hr	7 days
🟢 Limited	225 tokens/hr	7 days

Use pz collect info to view rates in Discord. MEC Collect upgrades can increase both the earn rate and extend the cap beyond 7 days — see the MEC Upgrades section.

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.xyz/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

Pet Building

Mains Season II

Mains are your active pet roster — up to 4 pets whose upgrades actually affect your gameplay. Only a Main's MEC effects are applied. The rest of your collection sits idle (still collecting, just not boosting).

Think of Mains as your starting lineup. You pick the 4 pets you've invested in the most, and they work for you while you play.

pz mainsView your current 4 Main slots and their MEC levels.

pz main add <petId>Add a pet to your Mains. Triggers a 24h swap cooldown.

pz main remove <petId>Remove a pet from your Mains.

There is a 24 hour cooldown on swapping Mains. Choose carefully — you can't swap in and out on a whim.

Pet Building

MEC Upgrades Season II

MEC stands for Mine, Economy, Collect — three upgrade paths you can invest in per pet. Each path has 6 levels. Upgrades are permanent, sequential (you can't skip), and paid in Bolts.

Effects only apply when the pet is in a Main slot. All 4 Mains stack their effects together — so 4 fully upgraded Mains is a significant advantage over 1.

MEC upgrades are permanent and cannot be undone. If you sacrifice a pet through Rebirth, those upgrades are lost with it.

⛏️ Mine Path

Reduces your mining cooldown and increases ore quantity per session.

Level	Effect	Bolt Cost
M1	−3% mining cooldown	3 bolts
M2	+4% ore quantity	8 bolts
M3	−6% cooldown total	18 bolts
M4	+9% ore quantity total	40 bolts
M5	−9% cooldown total	85 bolts
M6 (MAX)	+15% ore quantity total	160 bolts

💰 Economy Path

Boosts token earnings from selling ores and adds a passive trickle even when you're not collecting.

Level	Effect	Bolt Cost
E1	+5% token sell bonus	3 bolts
E2	+3 tokens/hr passive	8 bolts
E3	+9% sell bonus total	18 bolts
E4	+8 tokens/hr total	40 bolts
E5	+15% sell bonus total	85 bolts
E6 (MAX)	+15 tokens/hr total	160 bolts

🐾 Collect Path

Increases how much each pet earns per hour and extends how long earnings accumulate before capping.

Level	Effect	Bolt Cost
C1	+6% collect rate	3 bolts
C2	Collect cap → 8 days	8 bolts
C3	+13% collect rate total	18 bolts
C4	Collect cap → 9 days	40 bolts
C5	+21% collect rate total	85 bolts
C6 (MAX)	Collect cap → 10 days	160 bolts

pz upgrade <petId> <m|e|c>Upgrade the next level of a pet's Mine, Economy, or Collect path.

pz prestige <petId>View full MEC breakdown and prestige score for a pet.

Cost to fully max one pet: 314 bolts per path × 3 paths = 942 bolts total. Four fully maxed Mains = 3,768 bolts — a serious long-term investment.

Pet Building

Prestige Score Season II

Every pet has a Prestige Score from 0 to 100. It's a single number that reflects how invested a pet is — combining its rarity, MEC upgrade levels, and visual customization.

Rarity	Base Score	Max with Full MEC
⚪ Common	5	~41
🔵 Rare	20	~56
🟣 Epic	35	~71
🔴 Mythic	50	~86
🟡 Legendary	60	~96
🟢 Limited	70	100

MEC levels contribute 1 prestige point each. Trails and glow effects add a small bonus on top. Only Limited pets can reach a perfect 100.

pz prestige <petId>Full prestige breakdown for a specific pet.

pz prestige topGlobal leaderboard of the highest prestige score pets across all players.

Pet Building

Trails Season II

Trails are animated background patterns that appear on your pet's profile card. They're purely cosmetic — but they also contribute +2 to your pet's Prestige Score and make your pets visually distinct from everyone else's.

Trails are earned by opening a Vault. The tier of trail you receive matches the rarity of the pet you pull — better rarity means a better trail pool.

Trail Tier	How to Get	Examples
Epic	Vault — Epic pet drop	Batthern, Swirl, Lined Paper, Pinstripe
Mythic	Vault — Mythic pet drop	Connected, Cubes, Worn Dots
Legendary	Vault — Legendary pet drop	Stardust, Woven, Axiom Pattern, Snow

A trail is automatically attached to the pet it came with. It displays whenever that pet's page is viewed on the website. Trails are kept if a pet is sold — they transfer to the new owner along with the pet.

Trails are tied to the pet, not the player. A Legendary trail on a pet you sell is gone from your collection permanently.

Progression

Rebirth Season II

Rebirth is the prestige system — a deliberate full reset that makes your next run permanently faster. You sacrifice everything you've built in exchange for a rebirth level that stacks on top of your account forever.

What you lose

All Common, Uncommon, Rare, Epic, Mythic, and Legendary pets (deleted)
Tokens reset to 1,000
Tools reset to Rusty
All ores wiped
Active marketplace listings cancelled

What you keep

Limited pets — they go dormant (stop collecting) until sold to a new owner, at which point they reactivate
Bolts
Season Pass
Your rebirth level

Requirements

1,000+ non-Limited pets
Drill tier tools (both shovel and pickaxe)
Token threshold for the target rebirth level

Level	Token Cost
Rebirth I	1,000,000
Rebirth II	2,500,000
Rebirth III	5,000,000
Rebirth IV	10,000,000
Rebirth V	25,000,000 — Maximum prestige

pz rebirthView your current rebirth level and requirements for the next one.

pz rebirth confirmExecute a rebirth after reviewing what you'll lose.

Rebirth is irreversible. A confirmation screen shows exactly what will be deleted before anything happens.

Progression

Vault Season II

The Vault is a premium chest that costs Bolts and always drops a high-rarity pet. Unlike the standard chest which can drop Commons, the Vault floor is Epic — every single time.

What's inside every Vault

One guaranteed Epic, Mythic, or Legendary pet
A Trail matching the pet's rarity — auto-attached to the pet
A 12-hour MEC-type boost (Mine Surge, Economy Surge, or Collect Surge)

Rarity	Drop Chance
🟣 Epic	40%
🔴 Mythic	40%
🟡 Legendary	20%

Vault Costs by Gear Tier

Gear Tier	Bolt Cost
Rusty	15 bolts
Iron	25 bolts
Steel	40 bolts
Reinforced	65 bolts
Mythic	100 bolts
Groundbreaker	150 bolts
Drill	220 bolts

The 12h boost is applied to your account immediately. If you already have an active boost of the same type, it gets replaced with a fresh 12 hours. Check active boosts with pz effect.

Progression

Coin Flip Season II

The simplest risk in the game. Bet any amount of tokens on a 50/50 flip — win and your bet is doubled, lose and it's gone.

pz cf <amount>Flip a coin. Minimum 100 tokens, maximum 500,000.

pz cf allBet your entire token balance.

pz cf halfBet half your token balance.

Win streaks are tracked and displayed. Consecutive wins build a 🔥 flame counter next to your result.

Progression

Marriage Season II

A social feature — propose to another player and build a history together. Marriage is purely cosmetic and shows on both players' profiles.

pz marry @userSend a marriage proposal. The other player has 60 seconds to accept or decline via buttons.

pz divorceEnd the marriage. Costs 5,000 tokens. Shows how many days you were together.

You can only be married to one person at a time. Divorce before proposing to someone else.

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.xyz/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.xyz/seasons/terrarium.