Docs

PonsPets is a pixel-art pet battler played entirely from your browser. Your pet is bound to your Ethereum wallet — connect once, hatch once, and that companion is yours forever. Every wallet receives its own unique pet identity, with a species, element, signature ability, and three hand-drawn 16-bit evolution stages.

Everything you do — your pet, its level, XP, win/loss record, and battle cooldown — is stored server-side and tied to your wallet, so your progress follows you across devices and sessions. There is nothing to install and nothing to download.

The loop is simple: hatch a pet, battle other trainers to earn XP, spend that XP to evolve, and climb the leaderboard while your $PP reward tier grows with every evolution.

PonsPets uses your wallet purely as an identity. When you connect MetaMask you are asked to sign a plain text message proving you control the address. This signature happens entirely in your wallet — it is free, instant, and never broadcasts a transaction to any chain.

Because verification is a signature and not a transaction, you never pay gas and never approve any spending. PonsPets cannot move your funds; the signature only proves ownership so your pet and progress can be tied to your address.

Head to the Breed page and connect MetaMask. After you sign the verification message, tap Hatch Egg. The egg wobbles, cracks open, and reveals the level-1 PonsPet assigned to your wallet.

Your species is chosen deterministically from your wallet address. This means every address hatches a different pet, and the same address always hatches the same one — your companion is genuinely, permanently yours. Hatching is idempotent: if you already have a pet, it is simply returned unchanged.

From your dashboard, tap Battle to enter matchmaking. PonsPets scans live for an opponent near your level, streaming in candidate trainers with their region and ping, then locks in a match and drops both pets onto the battlefield side-by-side.

Combat is turn-based. On your turn you choose one of four moves; then the opponent responds. Reduce the opponent's HP to zero to win before they do the same to you. Both pets stand on equal ground at the same scale — this is a head-to-head duel, not a staggered RPG screen.

Matchmaking is balanced so fights stay fair and genuinely winnable. Opponent strength jitters slightly above and below your own, so some foes are tougher than you and some are weaker — outcomes are never scripted.

You have four moves. Tackle and Quick Jab are always available: Tackle is reliable mid-damage, Quick Jab is fast but weak. Your species Signature ability hits hard, and Heavy Blow hits hardest of all but can miss.

The two powerful moves — your Signature and Heavy Blow — carry a cooldown of a few turns after use. While a move recharges it is greyed out with a number showing the turns remaining. This means you cannot win by mashing one button; you rotate through weaker moves while your heavy hitters come back online.

Damage carries a little randomness and every hit has a chance to land a critical for extra damage, so momentum can swing right up to the final blow.

After every battle your pet must rest for 120 seconds before it can fight again. A live countdown appears on both your dashboard and the arena, and the Find Opponent button unlocks automatically when it reaches zero.

This rest timer keeps the arena competitive and prevents endless grinding — each battle is meant to matter. Because the cooldown is enforced server-side against your wallet, you cannot skip it by refreshing the page or reconnecting.

Winning fights awards the most XP; even a loss grants a small amount so time in the arena is never wasted. Your pet evolves in two steps: reach 100 XP to unlock level 2, and 300 total XP to unlock level 3.

Evolution is a manual choice on your dashboard. Once you have enough XP the Evolve button lights up — tap it to advance a stage. Each evolution swaps in a new sprite, raises your pet's Max HP and Attack, and bumps your $PP reward tier.

$PP is the reward token of PonsPets. Holders earn $PP based on the level of the PonsPet they hold: level 1 earns a 1x base share, level 2 earns 2.5x, and level 3 earns 6x. Playing and evolving your pet is how you grow your allocation.

$PP is a rewards layer, not a pay-to-play currency. You never need it to hatch, battle, or evolve — it exists to reward the trainers who invest the most in their companions.

The Store will offer boosts and cosmetics such as XP Boosters, an Evolution Crystal, a Guardian Shield, a Lucky Star, and cosmetic items like the Golden Paw and Mystery Egg. Items are previewed now and marked Coming Soon.

Boosts will be optional quality-of-life and cosmetic extras — they will never make PonsPets pay-to-win. Core progression always comes from battling and evolving.

Near-term: a live, purchasable Store, richer battle effects and hit animations, and additional signature-ability mechanics in combat.

Later: pet trading between trainers, seasonal leaderboards with $PP payouts, cosmetic companion eggs, and continually expanding species lines.