An upgrade to Pokémon Crystal. Brings features and content up to date, and adds some original content.
Assembly Python Other
Clone or download
Latest commit c34c754 Jun 9, 2018
Failed to load latest commit information.
audio Hidden Grotto theme by Mmmmmm Mar 5, 2018
constants All journals can be read Jun 8, 2018
contents All journals can be read Jun 8, 2018
data All journals can be read Jun 8, 2018
engine Fix item icons in Marts Jun 10, 2018
gfx Show color-coded pocket names in Bag May 29, 2018
home Fix NPCs showing through map name signs due to invalid gfx loading Mar 27, 2018
macros Fix "Left shift of negative value" warnings from rgbds 0.3.7 May 7, 2018
maps All journals can be read Jun 8, 2018
material Update notes May 23, 2018
patches Add patches and documentation for 2.2.0. Sep 20, 2016
ram Tweak museum tiles; optimize always-0 scenes Feb 8, 2018
screenshots Add patches and documentation for 2.2.0. Sep 20, 2016
tools Imakuni moonwalks (thanks to Crystal_ for the idea) Feb 22, 2018
utils Add a PC just before Victory Road; improve Karen's room Mar 27, 2018
.gitattributes Fix marts using hard-coded bank number Jan 27, 2016
.gitignore Remove dependency on pret/pokemontools submodule Aug 20, 2017 30 numbers, not 20 Jan 26, 2018 Fix InitBattleDisplay flash in VBA May 10, 2018 Copy much of pokecrystal's 2018 reorganization Jan 25, 2018 Fix dashes Aug 13, 2017 rgbds 0.3.3 support: replace negative offsets with unions Nov 15, 2017
Makefile Convert some 2bpp to 1bpp; Rearrange gfx like pokecrystal Feb 7, 2018 New Discord invite Sep 20, 2017 TODO May 7, 2018
audio.asm Hidden Grotto theme by Mmmmmm Mar 5, 2018
charmap.asm Add painting frames Feb 8, 2018
constants.asm Fix some Pokédex mistakes Mar 7, 2018 Remove pokemontools from subdirectory Dec 2, 2017
home.asm Use item params for more data Feb 6, 2018
macros.asm More copying pokecrystal organization Feb 4, 2018
main.asm Convert some 2bpp to 1bpp; Rearrange gfx like pokecrystal Feb 7, 2018
ram.asm ram/ subdirectory Jan 25, 2018
roms.md5 All journals can be read Jun 8, 2018

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