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.4%
  • C 3.4%
  • Python 2.8%
  • C++ 0.8%
  • JavaScript 0.3%
  • Other 0.2%
Find a file
Fredrik Ljungdahl 9a1ef8ad77 Fix #1669
Assisted-by: Codex:GPT-6 [vibeEmu]
2026-10-21 20:07:54 +02:00
.github/workflows Build with RGBDS v1.0.4 2026-09-22 14:13:22 -04:00
audio Use five custom cries by Regen from Pokémon Orange 2026-09-23 17:04:25 -04:00
bsp patchbros... we are so back 2023-05-10 18:38:30 -04:00
constants bump save version 2026-10-17 22:47:44 -05:00
data Edit path in front of Celadon University 2026-10-20 21:49:02 -04:00
docs Replace lzcomp with lzpcompress (#1574) 2026-06-11 13:42:26 -04:00
engine Fix #1669 2026-10-21 20:07:54 +02:00
gfx Fix monochrome build 2026-09-29 12:02:18 -04:00
home Save one byte of ROM0 (#1661) 2026-10-21 09:33:56 -05:00
macros Show actual ball used for trade mons 2026-09-05 17:38:44 -04:00
maps Edit path in front of Celadon University 2026-10-20 21:49:02 -04:00
material Remove some material/ graphics that won't be used 2026-06-20 21:40:59 -04:00
patches Fix corrupt .ips files 2019-03-11 15:23:45 +01:00
ram Fix link party corruption from unescaped trainer ID bytes (#1634) 2026-10-01 11:30:54 -04:00
screenshots Update Documentation (#1172) 2025-10-12 21:05:15 -05:00
tools Simplify make_patch to not have case and modifier handling 2026-08-13 17:52:08 -04:00
utils Remove commented-out unused memory game code 2026-09-01 13:48:12 -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 with RGBDS v1.0.4 2026-09-22 14:13:22 -04:00
audio.asm Use five custom cries by Regen from Pokémon Orange 2026-09-23 17:04:25 -04:00
CHANGELOG.md Strip trailing spaces 2026-03-19 18:49:00 -04:00
CONTRIBUTING.md Rename CONTRIBUTIONS.md to CONTRIBUTING.md 2026-10-01 08:45:41 -05:00
CREDITS.md Use five custom cries by Regen from Pokémon Orange 2026-09-23 17:04:25 -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
home.asm Merge the two gfx.asm files 2026-09-03 10:40:24 -04:00
includes.asm Remove the "predef" system, replacing predef/predef_jump with farcall/farjp (#1518) 2026-03-30 13:56:10 -04:00
INSTALL.md Build with RGBDS v1.0.4 2026-09-22 14:13:22 -04:00
layout.link Remove the unused WRAM0 section 2026-09-03 10:55:49 -04:00
main.asm Improve overworld performance (#1622) 2026-09-05 17:44:24 -04:00
Makefile Show actual ball used for trade mons 2026-09-05 17:38:44 -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!

What’s 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, you’ll 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