An upgrade to Pokémon Crystal. Brings features and content up to date, and adds some original content. https://www.pokecommunity.com/threads/pok%C3%A9mon-polished-crystal-update-3-1-1.373172/
Find a file
2025-11-17 17:47:17 +01:00
.github/workflows Use RGBDS 1.0.0 features (#1295) 2025-11-14 05:54:35 -06:00
audio Replace ldi [hl] with ld [hli] 2025-10-03 09:52:51 -04:00
bsp patchbros... we are so back 2023-05-10 18:38:30 -04:00
constants Embiggen Dance Theater 2025-11-04 14:36:43 -06:00
data Use RGBDS 1.0.0 features (#1295) 2025-11-14 05:54:35 -06:00
docs Fix minor newbox documentation issue 2025-10-25 16:13:48 +02:00
engine Fix base exp initialization 2025-11-17 17:47:17 +01:00
gfx slight correction to wooper's sprite 2025-11-13 09:42:42 +00:00
home Use RGBDS 1.0.0 features (#1295) 2025-11-14 05:54:35 -06:00
macros Use RGBDS 1.0.0 features (#1295) 2025-11-14 05:54:35 -06:00
maps Fix Route43 overcast map missing sign 2025-11-09 15:41:29 -06:00
material Revise list of slicing moves 2022-11-27 17:36:26 -05:00
patches Fix corrupt .ips files 2019-03-11 15:23:45 +01:00
ram Move wPrinterConnectionOpen and Disable Serial IE in SummaryScreen 2025-11-04 18:53:42 -06:00
screenshots Update Documentation (#1172) 2025-10-12 21:05:15 -05:00
tools Support overriding RGB programs individually 2025-10-03 11:50:28 -04:00
utils Add build & release util 2025-10-13 12:20:16 -05:00
.gitattributes Virtual Console patch for Polished Crystal (#684) 2022-06-06 19:10:00 -04:00
.gitignore add .ips files to .gitignore 2025-02-02 09:46:32 -06:00
.rgbds-version Use RGBDS 1.0.0 features (#1295) 2025-11-14 05:54:35 -06:00
audio.asm Require rgbds 0.6.0 2022-10-02 20:17:11 -04:00
CHANGELOG.md Move wPrinterConnectionOpen and Disable Serial IE in SummaryScreen 2025-11-04 18:53:42 -06:00
CREDITS.md Update Documentation (#1172) 2025-10-12 21:05:15 -05:00
FAQ.md Bump title screen&version to 3.2.1 2025-10-23 15:44:35 -05:00
FEATURES.md Update Documentation (#1172) 2025-10-12 21:05:15 -05:00
gfx.py gfx.py needs to use Python 2 2021-08-29 17:41:12 -04:00
home.asm Run utils/unreferenced.py and do some cleanup/optimization 2025-04-09 20:47:09 -04:00
includes.asm Fix make monochrome 2025-09-30 21:30:40 -04:00
INSTALL.md Use RGBDS 1.0.0 features (#1295) 2025-11-14 05:54:35 -06:00
layout.link New Pokemon sprites and animations (#1164) 2025-10-10 18:52:27 -05:00
main.asm New Pokemon sprites and animations (#1164) 2025-10-10 18:52:27 -05:00
Makefile Use RGBDS 1.0.0 features (#1295) 2025-11-14 05:54:35 -06:00
ram.asm Misc Refactors/Ports (#762) 2022-12-10 19:23:41 -05:00
README.md Bump title screen&version to 3.2.1 2025-10-23 15:44:35 -05:00
rgbdscheck.asm Use RGBDS 1.0.0 features (#1295) 2025-11-14 05:54:35 -06:00
TODO.md Update TODO.md 2024-12-29 16:25:19 -05:00
vc.patch.template Fix VC patches, label must be <32 chars 2025-10-13 23:14:57 -05:00

Pokémon Polished Crystal

This is a custom Pokémon game based on the Pokémon Crystal disassembly.

My goal is to create what the title says: an improved, polished version of Pokémon Crystal. It fixes bugs, takes into account the official game changes since 2001, and adds some new ideas of my own. Many features restore what was removed from R/B/Y, or original to HG/SS.

I've had vague plans to make a Pokémon game for years. I'm very impressed by the effort that's gone into disassembling Pokémon Crystal and making the code so well-organized. Thanks to making it open-source (and to the ROM hackers that inspired me), I'm finally making this game a reality.

There are many ways to create games but the way we work at Game Freak may be a little different from other companies. That is, we constantly change and tweak what we have come up with. To make a fun game even more fun and polish it up, we take what we have made and start thinking about it from scratch. And to make the game the most fun to play we make endless changes and tweaks no matter how long it takes. It may not be the best way, but I think these tweaks are important to make our games fun and better.

— Junichi Masuda, "HIDDEN POWER of masuda No. 7"

Download and Play

The current official release is v3.2.1 (the “Polished Crystal” release). It's fully playable from start to finish and includes major overhauls to gameplay, mechanics, and quality of life. A more detailed changelog is forthcoming, but you can find the major highlights below.

The previous official version was v3.1.1 (February 1, 2025).

If you have any questions about playing or patching, read the FAQ!

Whats New in v3.2.1

Below is a brief summary of the major changes and additions. A more detailed changelog will be released soon.

  • Customizable New Game Setup: You can now toggle Natures and Abilities on/off, choose how EVs work (classic no-limit, modern 510 limit, or disabled), and configure various other gameplay options before starting a new adventure.
  • DVs No Longer Determine Natures/Shininess/Gender/Unown Form: DVs still affect color variation (slightly different hues for the same species), but everything else is now handled separately.
  • Overhauled Battle Engine and HUD:
    • Abilities are now supported.
    • Moves have been updated to behave more like their modern counterparts.
    • Minor HUD improvements make battles more streamlined.
  • Revamped Move Animations: Many moves have updated animations.
  • Optimized Engine and 60fps Overworld: The game engine has been heavily optimized for smoother performance, and the overworld now runs at 60 frames per second.
  • Storage System Redesign: The PC storage interface is more like modern Pokémon games. You can switch boxes, move Pokémon around, and manage your party with minimal saving hassles.
  • HGSS-Inspired Pokédex: The new Pokédex includes base stats, egg groups, and a more comprehensive encounter map showing all methods of obtaining Pokémon.
  • Enhanced Overworld Weather: Instead of just darkening the screen, youll now see proper rain, snow, or sandstorms in applicable areas.
  • Revamped Summary Screen: Replaces the vanilla stats screen. Shows nature, abilities, seen and caught data, and more.

Features

A full list of features is in FEATURES.md. Some highlights:

  • 289 Pokémon species, including some new evolutions, plus 56 cosmetic forms (e.g., Magikarp patterns, Pikachu Fly/Surf, Arbok patterns, Unown Forms) and 46 variants (Alolan, Galarian, Hisuian, etc.)—for a total of 391 unique Pokémon.
  • 73 new moves (72 on faithful builds), 75 TMs, and 31 move tutors.
  • Modern mechanics, such as the Fairy type, Physical/Special split, Natures, Abilities, and more.
  • Unlimited TMs and quality-of-life features like Running Shoes and continuous Repel.
  • New/Revamped Maps: Some from R/B/Y, some devamped from HG/SS, plus original locations.
  • New Characters including Lorelei and Agatha (R/B/Y), Lyra and the Team Rocket Executives (HG/SS), and others.
  • More Post-Game Content: Gym Leader rematches, a new event after battling Red, and more.
  • Improved Level Curve with steadily increasing challenges.
  • Music and Graphics devamped from newer generations.

Discussion

If you have questions or comments, please check or post on any of these sites. (Read the FAQ first if you have general questions!)

Additional resource:

  • PolishedDex — An online companion for Polished Crystal. PolishedDex provides a searchable Pokédex, move list, item list, locations, abilities, special events, and a team builder. It also includes a FAQ and links to the official ROM releases, making it a convenient reference while playing.

Screenshots

title-screen which-photo running-shoes town-map

lyra cherrygrove-city pokemon-center bag

oaks-aide move-tutor moss-rock rich-boy

tm43 game-corner-prizes goldenrod-move-tutor eviolite

wonder-trade ecruteak-shrine cowgirl olivine-city

remoraid team-rocket steelix custom-map

ice-rock hex-maniac route-45 summary

leppa-berry regional-forms move-reminder moves

sylveon-moonblast togetic-fairy-wind aerodactyl-fossil cerulean-city

celadon-city weather viridian-forest mismagius

fighting-dojo silph-co stormy-beach rock-tunnel

safari-zone soul-house cinnabar-island seafoam-islands