Suikamon AI documentation

# Suikamon

> Suikamon is a free virtual pet game you play in your browser — no signup and no payment to start. Pick a free Common starter, raise it with daily care (feed, clean, train, rest), watch it evolve, and battle other trainers in turn-based PvP. Every other Suikamon — Rare, Epic and Legendary — is discovered in eggs found at level milestones, and in Soul Shards paid by ranked trophy tiers. Sign in with email to keep your progress.

GENERATED FILE — built from the game's own configuration by the prerender-seo plugin
(see suikamon-web/src/data/llmsTxt.ts). Every number and name below is read from the
code the game runs on, so it cannot describe a version of the game that no longer exists.

## Key facts

- Free to play in the browser. Training battles need no account.
- Free play: pick a starter, full care loop, no login needed. Guest pets are capped at level 3 (XP keeps accruing) and at the end of the first campaign zone; signing up free with email lifts both caps and carries all progress over on the same pet.
- Pets evolve through six stages; the level cap is 100.
- Website: https://suikamon.com

## Campaign — "The Last Souls" (PvE story)

A ten-world single-player campaign spanning levels 1 to 100, told in two acts of five worlds. The island's Soul, a great shining crystal on its oldest hearth, broke into 19 shards, each hidden inside one species: the Last Souls. Each waits at a soul node, and winning its trial earns its Soul Shard. All 19 together make the island whole again. Clan Z cage the carriers, and the Soul-Eater walks in the gray dust they leave behind.

Act I, The Five Guardians (worlds 1–5), gives each of the island's Guardians back what it lost. Act II, The First Keeper (worlds 6–10), reveals that the Soul-Eater is the First Keeper himself and pursues him past the island's edge.

- World 1: **Verdant Forest** (levels 1–10)
- World 2: **Sunken Bay** (levels 11–20)
- World 3: **Cinder Pass** (levels 21–30)
- World 4: **Storm Summit** (levels 31–40)
- World 5: **Mirror Isle** (levels 41–50)
- World 6: **Champion Road** (levels 51–60)
- World 7: **Ash Fields** (levels 61–70)
- World 8: **Storm Vault** (levels 71–80)
- World 9: **Pale Coast** (levels 81–90)
- World 10: **First Shore** (levels 91–100)

Squad battles ramp 1v1 → 2v2 → 3v3, and a player's pets are capped at each world's finale level.

## Care, minigames and bonding

Daily care — feed, clean, train, rest — is the heart of the game and the main way a pet earns XP and evolves. Each action has its own cooldown, and hunger, happiness and energy decay over time.

- **Care minigames**: thirteen optional skill games (Fruit Catch, Fruit Slice, Recipe Tap, Snack Sort, Memory Flip for feeding; Rhythm Training, Reflex Blocks, Balance Beam, Block Drop for training; Bubble Scrub, Mud Swipe, Sparkle Polish, Pest Whack for cleaning). Playing well reaches a tier (Bronze/Silver/Gold/Perfect) that adds bonus XP and happiness. They only amplify the care action — skipping is one tap and never penalised — and scores are validated server-side, so they cannot mint currency.
- **Companion greetings**: every Suikamon has one of four personalities (Sunny, Sage, Rascal, Champion) and speaks at meaningful moments — its monthly hatch-day, a return after a break, a care-streak milestone. Pure bonding: no stats, no cost.
- **Rival of the Day**: a once-per-day rematch against a campaign rival already beaten, worth bonus XP for the whole squad.

## How a battle works

Each round both trainers commit to one of four moves — attack, magic, dodge or recover — and may back it with cards from a hand of 5. A player may play a meld of up to 4 copies of one card of the move they committed to, or play the move bare; only cards of the committed move count towards the exchange. The cards decide who wins the exchange; the move decides what winning it does. Elements (Fire, Water, Nature, Thunder) counter each other, so the matchup shifts the odds.

Move legality is the same in every mode and the server owns all randomness. Modes: Training (free, no account), Trial (your own pet, XP only), Ranked (Trophies), Squad Ranked (3v3, Trainer ELO), and the PvE campaign.

## Currencies and discovery

- **Suika** — a pet's energy, earned in battles and refilled free when low; spent in the Skill Store on battle skills. Buying a skill you already own adds a copy; enough copies raise it from Common to Rare to Epic.
- **Scrolls** — earned from campaign wins and the daily ladder, spent on skills.
- **Soul Shards** — dropped by battle wins and saved Guardians, one kind per species, rarer for rarer Suikamon; enough of a species' shards recovers its soul (its egg) in Recovered Souls on the profile. Shards of a Suikamon you already own become Suika.
- **Daily reward** — open the game once a day for Trainer Suika on a 10-day streak.
- **Discovery** — one free Common starter per trainer; every 10 levels a Suikamon finds an egg and ranked trophy tiers pay Soul Shards toward more — the only way to meet Rare, Epic and Legendary species.

## Species (19)

Every species evolves through six stages and has its own element, rarity and signature magic skill. Stats below are the live values from the game's configuration.

- **Bireon** (Nature, Common) — Tiny bird, endless kindness. Base HP 57; magic Sky Talons for 16. https://suikamon.com/bireon
- **Aqua** (Water, Rare) — Graceful waves, cool spirit. Base HP 48; magic Water Lash for 12. https://suikamon.com/aqua
- **Zaricat** (Thunder, Rare) — Lightning that never sleeps. Base HP 51; magic Static Lock for 11. https://suikamon.com/zaricat
- **Hotpaw** (Fire, Rare) — Born from molten laughter. Base HP 60; magic Flame Burst for 13. https://suikamon.com/hotpaw
- **Yeti** (Water, Epic) — Silent strength beneath mountains. Base HP 61; magic Snowball for 17. https://suikamon.com/yeti
- **Toro** (Thunder, Legendary) — A legendary bull with a heart of gold. Base HP 56; magic Wild Charge for 21. https://suikamon.com/toro
- **Kobu** (Nature, Common) — Forest's tiny guardian. Base HP 59; magic Savage Bite for 12. https://suikamon.com/kobu
- **Pinky** (Water, Epic) — A little fairy princess. Base HP 59; magic Wishing Bubble for 19. https://suikamon.com/pinky
- **Pefareon** (Nature, Common) — A sweet little vampire. Base HP 54; magic Blood Drain for 21. https://suikamon.com/pefareon
- **Talion** (Fire, Common) — A cunning little bandit. Base HP 58; magic Immolate for 20. https://suikamon.com/talion
- **Suimon** (Water, Epic) — A mystical sea spirit summoned by the Suimon community. Base HP 50; magic Suiwave for 24. https://suikamon.com/suimon
- **Voltaryx** (Thunder, Legendary) — Storm incarnate, wings of lightning. Base HP 49; magic Thunder Strike for 12. https://suikamon.com/voltaryx
- **Drago** (Fire, Epic) — A legendary fire dragon with an unbreakable will. Base HP 59; magic Inferno Breath for 13. https://suikamon.com/drago
- **Fernail** (Water, Rare) — Slow steps, deep courage. Base HP 56; magic Shell Slam for 19. https://suikamon.com/fernail
- **Sumiya** (Nature, Common) — Tiny wizard, pink mischief. Base HP 53; magic Pink Hex for 23. https://suikamon.com/sumiya
- **Trixon** (Water, Epic) — Elegant blue dragon of the Japanese tides. Base HP 47; magic Hydro Storm for 10. https://suikamon.com/trixon
- **Pikoto** (Nature, Common) — Grumpy farm bird, all about gains. Base HP 62; magic Rage Cluck for 16. https://suikamon.com/pikoto
- **Ray** (Nature, Rare) — Gentle paws, forest soul. Base HP 53; magic Bramble Bite for 17. https://suikamon.com/ray
- **Gorly** (Nature, Rare) — Lazy, hungry, unstoppable. Base HP 57; magic Food Coma for 19. https://suikamon.com/gorly

## Pages

- [Suikamon — adopt, raise and battle a digital pet](https://suikamon.com/): Suikamon is a free browser game about raising a creature of your own.
- [Play Suikamon free](https://suikamon.com/play-free): Pick a starter and start raising it immediately — no account, no download.
- [Meet the Suikamon](https://suikamon.com/adopt): Every species has its own element, rarity, base HP and signature magic skill, and every one grows through six evolution stages as you care for it.
- [PvP Trial Battles](https://suikamon.com/pvp-trial): Trial battles let you fight with your own pet and keep the XP, without putting Trophies on the line.
- [PvP Ranked Battles](https://suikamon.com/pvp-ranked): Ranked is the competitive ladder.
- [Squad Ranked Battles](https://suikamon.com/pvp-squad-ranked): Squad ranked is fought three against three.
- [Campaign Mode — The Last Souls](https://suikamon.com/campaign): The campaign is a ten-world story told in two acts.
- [Battle Cards — how a battle is resolved](https://suikamon.com/battle-cards): This is the reference for every rule a Suikamon battle runs on: the four moves you can commit to each round, the hand of 5 you back them with, how an exchange is decided, and what each card in the deck does..
- [Suikamon Battle Guide](https://suikamon.com/battle-guide): A practical guide to fighting well: what each move is for, which elements beat which, and how to spend a hand of cards so you still have something left when it matters..
- [Suikamon Rankings](https://suikamon.com/rankings): Every ranked battle moves the board.
- [Trainer Leaderboard](https://suikamon.com/trainers): Trainers ranked by what their squads actually did — Trainer ELO from squad ranked play, alongside the pets that earned it..
- [Suikamon Game Guide](https://suikamon.com/help): Everything the game runs on, in one place: how care works and what each action does, how a pet gains XP and evolves, how battles resolve, and what the campaign and the economy expect of you..
- [Suikamon Documentation](https://suikamon.com/whitepaper): The reference document: every rarity tier, what rarity does and does not affect, how your free starter grows, and how Rare, Epic and Legendary Suikamon are found in eggs..
- [Suikamon Changelog](https://suikamon.com/changelog): Every release, newest first — what was added, what was changed and what was fixed, with the version number it shipped in..
- [Suikamon Media Kit](https://suikamon.com/media): Logos, icons and species artwork in the sizes people actually need — for articles, videos, streams and community posts..
- [Daily Rewards](https://suikamon.com/daily-rewards): Every day you open the game pays Suika to spend on care and in the Store.
- [Terms of Service](https://suikamon.com/terms): The rules that apply to playing Suikamon, owning a pet, and using this site..
- [Privacy Policy](https://suikamon.com/privacy): What Suikamon collects, why, and how it is stored..
- [Suikamon AI documentation](https://suikamon.com/ai): The complete plain-text documentation for Suikamon, written for language models and other machine readers..

## Full machine-readable docs

- [AI docs and live metrics](https://suikamon.com/ai): complete, always-current plain-text documentation — the full species catalog with combat stats, care mechanics, PvP and campaign details, supply limits and API endpoints. This page also serves a static copy of this file to clients that do not run JavaScript.
- [Battle rules](https://suikamon.com/battle-cards): how an exchange resolves, rendered from the battle engine's own code.
- [Sitemap](https://suikamon.com/sitemap.xml)