Skip to content
An upgrade to Pokémon Crystal. Brings features and content up to date, and adds some original content.
Branch: master
Clone or download
Latest commit c4ba267 Mar 18, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
audio Better fix to music player handler Mar 4, 2019
constants Merge remote-tracking branch 'upstream/master' Mar 16, 2019
contents Defragment battle_tower_inside and ice_path tilesets Mar 17, 2019
data Defragment battle_tower_inside and ice_path tilesets Mar 17, 2019
engine Fix PCItems wram labels Mar 18, 2019
gfx Defragment battle_tower_inside and ice_path tilesets Mar 17, 2019
home Minor optimization Mar 17, 2019
macros Remove some reliance on EGG Mar 17, 2019
maps Remove some reliance on EGG Mar 17, 2019
patches Fix corrupt .ips files Mar 11, 2019
tools Improve SGB border Mar 15, 2019
.gitignore Fix naming screen sprite copy. Sep 10, 2017 RSE Surf music by Monstarules Feb 12, 2019 'make noir' for a grayscale look Mar 4, 2019
Makefile You can fall off bridges in Lightning Island Feb 17, 2019
macros.asm Remove seperation of battle_commands.asm and effect_command_pointers.asm Mar 9, 2019
ram.asm ram/ subdirectory Jan 25, 2018
roms.md5 Defragment battle_tower_inside and ice_path tilesets Mar 17, 2019

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 most recent version is 2.2.0 as of September 20, 2016. The changelog lists all changes since then.

To play, download the .ips patch file, and use a tool like Lunar IPS (for Windows), MultiPatch (for OS X), or UniPatcher (for Android) to apply the patch to a default Crystal ROM.

This is the ROM you should use:

  • Pokémon - Crystal Version (UE) (V1.0) [C][!].gbc
    (md5: 9f2922b235a5eeb78d65594e82ef5dde)

It's identical to the one built by the pokecrystal project.

If you want to do a Nuzlocke Challenge, check out Nuzlocke mode in the Option menu!

There are two patches for Polished Crystal. The "faithful" patch does not change any Pokémon base stats or move attributes beyond the updates in Gen VI. The regular patch has some custom changes for more diverse and viable Pokémon.


A full list of features is in Some highlights:

  • 253 Pokémon, including some new evolutions.
  • 48 new moves.
  • 65 TMs and 21 move tutors.
  • Many new mechanics, including the Fairy type, Physical/Special split, Natures, unlimited TMs, Running Shoes, and continuous Repel.
  • New maps: some restored from R/B/Y, some devamped from HG/SS, and some original.
  • New characters, including Lorelei and Agatha from R/B/Y, Lyra and the Team Rocket Executives from HG/SS, and others.
  • More post-game content, like Gym Leader rematches and an event after the battle with Red.
  • An improved level curve with steadily increasing challenges throughout the game.
  • Music and graphics devamped from other versions.
  • Nuzlocke mode in the Option menu, enabling the basic rules of the Nuzlocke Challenge.


You can post questions or comments on any of these sites. But please read the FAQ first if you have a question.


title-screen running-shoes town-map lyra

cherrygrove-city pokemon-center nuzlocke-mode oaks-aide

elder-li move-tutor moss-rock rich-boy

tm58 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 stats

sitrus-berry weavile move-reminder moves

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

celadon-city fly-to-rock-tunnel viridian-forest mismagius

fighting-dojo silph-co new-balls rock-tunnel

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

You can’t perform that action at this time.