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
2026-01-24 21:30:18 -05:00
.github/workflows Build CI with RGBDS v1.0.1 2026-01-01 01:29:25 -05:00
audio Animate the keyboard in the music player (#1325) 2026-01-24 16:38:57 -05:00
bsp patchbros... we are so back 2023-05-10 18:38:30 -04:00
constants Clean up audio channel rest logic (#1328) 2026-01-24 16:14:22 -05:00
data Make Pewter Gym more like FRLG 2026-01-24 21:30:18 -05:00
docs Fix minor newbox documentation issue 2025-10-25 16:13:48 +02:00
engine jp to jmp 2026-01-24 20:06:08 -06:00
gfx Make Pewter Gym more like FRLG 2026-01-24 21:30:18 -05:00
home Animate the keyboard in the music player (#1325) 2026-01-24 16:38:57 -05:00
macros Clean up audio channel rest logic (#1328) 2026-01-24 16:14:22 -05:00
maps Make Pewter Gym more like FRLG 2026-01-24 21:30:18 -05: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 Animate the keyboard in the music player (#1325) 2026-01-24 16:38:57 -05: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 Minor file permissions fix 2025-12-02 17:44:00 +01:00
.gitattributes Virtual Console patch for Polished Crystal (#684) 2022-06-06 19:10:00 -04:00
.gitignore Unowns hover on the title screen 2026-01-19 16:22:33 -05:00
.rgbds-version Build CI with RGBDS v1.0.1 2026-01-01 01:29:25 -05:00
audio.asm Require rgbds 0.6.0 2022-10-02 20:17:11 -04:00
CHANGELOG.md Fix Flare Blitz crashing the game when called by Metronome or Sleep Talk and bump version 2025-12-10 20:39:50 -06:00
CREDITS.md Use JaceDeane's hidden grotto tilesets 2026-01-20 23:46:18 -05:00
FAQ.md Fix Flare Blitz crashing the game when called by Metronome or Sleep Talk and bump version 2025-12-10 20:39:50 -06: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 Make options menu scrollable (#1316) 2026-01-23 18:56:45 -06:00
INSTALL.md Build CI with RGBDS v1.0.1 2026-01-01 01:29:25 -05:00
layout.link Shrink wOverworldMapBlock back to its default ds 1300 2026-01-09 14:40:16 -05:00
main.asm LZ compress map name sign graphics (#1342) 2026-01-24 15:35:10 -05:00
Makefile Don't use tile $1:7F during the title screen animation 2026-01-21 11:23:22 -05:00
ram.asm Misc Refactors/Ports (#762) 2022-12-10 19:23:41 -05:00
README.md Fix Flare Blitz crashing the game when called by Metronome or Sleep Talk and bump version 2025-12-10 20:39:50 -06: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.3 (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.3

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