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/
  • Assembly 92.3%
  • C 3.2%
  • Python 3.2%
  • C++ 0.8%
  • JavaScript 0.4%
  • Other 0.1%
Find a file
2026-03-27 00:27:48 -04:00
.github/workflows Build CI with RGBDS v1.0.1 2026-01-01 01:29:25 -05:00
audio Remove the unused Megalovania song as the music player's final bonus Easter egg 2026-03-24 11:32:50 -04:00
bsp patchbros... we are so back 2023-05-10 18:38:30 -04:00
constants Fix and optimize Copycat scripts 2026-03-26 14:32:35 -04:00
data Bugsy sends out U-Turn Scyther first 2026-03-27 00:27:48 -04:00
docs Add quotes on top of more docs 2026-02-12 18:59:23 -05:00
engine Revise Mystri Stage and Embedded Tower tiles 2026-03-26 22:06:21 -04:00
gfx More sprout_tower tileset tweaks 2026-03-26 22:52:56 -04:00
home Ensure we're loading graphics from the correct bank 2026-03-26 22:16:59 -04:00
macros Shiny star is colored yellow in the naming screen 2026-03-11 13:24:12 -04:00
maps More sprout_tower tileset tweaks 2026-03-26 22:52:56 -04: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 Do not use an intermediate wTileBuffer for ScrollTileRightLeft 2026-03-24 12:47:01 -04:00
screenshots Update Documentation (#1172) 2025-10-12 21:05:15 -05:00
tools Add extended LZ opcodes (packhi0, packlo0, pack16) to save ~23 KB (#1343) 2026-02-08 19:18:48 -05:00
utils Use the Ruins of Alph tiles for the Sinjoh Ruins too 2026-03-26 14:06:13 -04:00
.gitattributes Add extended LZ opcodes (packhi0, packlo0, pack16) to save ~23 KB (#1343) 2026-02-08 19:18:48 -05:00
.gitignore Redesign the Judge Machine more like the Summary pages 2026-03-08 15:41:12 -04: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 Strip trailing spaces 2026-03-19 18:49:00 -04:00
CREDITS.md Use more recent non-Faithful base stat distributions from Blaze Black 2/Volt White 2 Redux 2026-03-10 16:52:10 -04:00
FAQ.md Strip trailing spaces 2026-03-19 18:49:00 -04:00
FEATURES.md Replace Pink Bow with Fairy Feather 2026-02-24 12:11:28 -05:00
gfx.py gfx.py needs to use Python 2 2021-08-29 17:41:12 -04:00
home.asm Add Wind Rider 2026-02-18 23:23:44 +01:00
includes.asm Scrolling initial options, and descriptions for in-game options (#1390) 2026-02-23 23:29:31 -05:00
INSTALL.md Build CI with RGBDS v1.0.1 2026-01-01 01:29:25 -05:00
layout.link Decompress the SGB border tilemap to WRAM0 to save ROM space 2026-03-17 15:08:46 -04:00
main.asm Scrolling initial options, and descriptions for in-game options (#1390) 2026-02-23 23:29:31 -05:00
Makefile Add spotlight to evolution and animation 2026-03-11 22:05:41 -04: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 Remove some TODO.md items already made into GitHub issues 2026-03-04 15:07:20 -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