Development
This project, produced by icecapi, started as a simple venture into revisiting the "Pikachu Tamagotchi" idea, but has thoroughly developed into an HTML care/battle simulator (remake/demake?) of Pokémon RGB. Powered through Java, the game runs on an expansive number of scripts and modules that flow together to create a robust gaming experience.

Developer Note:
"I really hope you enjoy the game! It will bug, it will break, and it will probably make you very upset if I accidentally do something that affects your save data, so be sure to frequently back it up, as the game is frequently being patched into a more playable, stable state."

Credits
Original project direction and production: icecapi
Built as a fan game experience for learning, creativity, and community-driven iteration.

User Contribution
You can contribute by adding custom sprite files, icon packs, move/balance suggestions, bug reports, and new content ideas (areas, events, trainers, achievements).

Recommended workflow: export save/sprite maps before major edits, patch, test battles/saves, then keep backups.

Community portrait contributor directory:
PMD Portrait Repository - Contributors

General Pokédex and game data (reference):
Pokémon Database

Extra sprite resources (reference):
The Spriters Resource

Sprite Database

Version
Current in-game version: 0.9a

SPECIAL THANKS to
Nintendo
GameFreak
Creatures Inc.
Chunsoft
The Greater Pokémon Fan Community
My Good Friend, Zawa (Support)

and, most importantly,
YOU!

Goal
Raise your Pokémon partner: keep care stats healthy, build trust and level, earn money and badges, explore areas, battle wild Pokémon and trainers, and expand your collection. If trust hits zero, your run can end—treat your partner well.

First minutes
Professor Oak’s intro sets the tone: read his words, enter your name, then your rival’s name (Oak’s grandson in the story), then pick a starter. You begin in 🏠 Pallet Town—the classic Kanto home town—then branch out across the map. After that, use care actions when cooldowns allow, then EXPLORE (costs energy) for battles, items, and events. Heal at POKé CENTER when hurt; buy balls and medicine at POKé MART (purchases use wallet money only). Open 🎯 RIVAL anytime to see your next big fights. After the story league, 📞 PHONE lets you rematch trainers you have already defeated.

👩 Mom & money
Tap 👩 MOM to open your home “bank”: move Pokédollars between your wallet (used in shops and casinos) and Mom’s savings (safe storage). Deposit, withdraw, or use ALL shortcuts. Combined total is shown for planning.

Care & cooldowns
Use FEED, PLAY, SLEEP, CLEAN, GROOM, CUDDLE, POOP to fix hunger, boredom, sleep, cleanliness, and mess. Actions grant XP and affect trust. Many actions have cooldowns—watch the bottom status line and messages. The red status box under your HUD shows tutorials and tips; toggle MSG LOG to review past lines. While this HELP screen, 👩 MOM, 📊 INFO, or a full-screen evolution is open, passive care decay and the 5-second game tick pause—your partner’s stats won’t drain from time passing until you close that window. Care button cooldowns still use real time, so they keep counting down while a window is open.

HUD & party
Stat tiles show hunger, energy, money, wins, items, day/night, streaks, etc. 📊 INFO opens moves, battle status, routine, and run rules (e.g. Nuzlocke). You can run a 3-slot party (or 6 in Nightmare Nanny)—swap partners when prompted; fainted partners need care or swaps. Click your trainer name for your trainer card.

World & activities
Click the location badge on the HUD to open the map and travel. EXPLORE spends energy and rolls events by area: in towns you won’t get wild Pokémon battles (you can still get trainers, money finds, and other events); routes, forests, caves, and similar spots are where wild battles happen. FISH only where the area has water; SAFARI, GYM, POKé MART, CASINO, and POKé CENTER (heal + cooldown) use money and items. After all 8 Gym badges, GYM becomes the Elite Four (in order), then your Rival as Champion—then post-game exploration. Weather can affect play—see the weather badge. More Kanto-inspired areas (including cities and routes) unlock as you earn badges and levels; mart stock tiers follow how far you’ve opened the map.

🗝️ Dungeon Discovery
Sometimes EXPLORE reveals a hidden dungeon—you’re asked first whether to enter. If you go in: advance through chambers for loot, money, traps, and lore, then battle a strong boss Pokémon (defeat or catch—catching counts as clearing). You cannot RUN from the guardian—use an Escape Rope from the dungeon screen to leave before winning. If you get a wild battle from EXPLORE while a dungeon run is active, RUN returns you to the dungeon. While a dungeon run is active, passive care decay (hunger, boredom, trust drip from neglect, etc.) is frozen like during battles—your partner’s needs won’t tick down from time. A white-out still applies normal defeat penalties (trust hit, energy loss, etc.), then ejects you from the dungeon like any other loss. From Lv.8 at marts outside Pallet Town, you’ll always see Escape Ropes, Repel Spray, Trail Rations, Luminous Moss, and Sturdy Charms for ruins and traps.

Battles
Pick moves or items, run when allowed, and use SWAP for party members. Move buttons show type effectiveness chips (2×, ½×, 0×) and a PP bar (warns when low). Damage and healing pop up above the HP bars. HP uses numbers + percent + a bar; the foe’s type appears under their name. Keyboard (battle open): 1–4 = moves, I/B = items, M = moves panel, R = run / link forfeit, S = swap, L = toggle log. BATTLE LOCK (top bar) keeps you in a fight across refreshes until it resolves—don’t refresh to escape. Shiny Pokémon can appear (rare). Catching may send extras to the PC when your party is full. Evolution from leveling or stones opens a full-screen moment so you don’t miss it.

Rival & league
At each level milestone (10, 20, …) your rival may challenge you during EXPLORE. Track what is next under 🎯 RIVAL. Gyms require minimum levels; Elite Four and Champion require higher levels—check the GYM button prompts if you are blocked.

Difficulty & challenges
Open DIFFICULTY for presets and modifiers. Nuzlocke and other challenge options can permanently affect your run—read the panel before enabling.

Saves
The game auto-saves on a timer (toggle with AUTO-SAVE). Toggle TIPS to turn hover hints on or off. Use EXPORT / IMPORT to back up your save file. Clearing browser data can erase local saves—export first.

Two-player link
🔗 LINK uses the same dev passphrase as 🧪 CHEATS. Run START-LINK-SERVER.bat or npm start on one PC; both players enter the same ws:// URL. Same room: at most two trainers—chat, trade (host finalizes), link battles.

Held items
Open 🧺 CARE BAG — each party Pokémon can hold one item from your bag (EXP. Share, Lucky Egg, Amulet Coin, Leftovers). Buy held gear at the Poké Mart when unlocked. EXP. SHARE is expensive and only appears in the shop after you become Champion.

ℹ️ INFO = credits & project details (opening it pauses passive decay like HELP/Mom). 🧪 CHEATS = dev tools (passphrase). This HELP screen is the player-facing rules summary.

Choose a preset or fine-tune modifiers. Changes apply immediately after saving.

Presets

Nightmare Nanny (6-slot party)

Challenge Toggles

Nuzlocke (Poké Perfect)

Weather Source

CLEAR CLOUDY RAIN SNOW STORM HEATWAVE FOG

Sound Effects Enabled

Master Volume: 70%

🔊 Test Sound

Note: Audio is automatically muted when the game is paused.