IMPORTANT NOTE

I'm doing a lot of cleanup and sorting to make this repo easier to navigate. If you come across any broken links in the RA forum, please open an issue here or notify me via Discord @ televandalist#9495 (2022-05-03)

RAPatches

This is a patch repository for RetroAchievements.org. Please open issues for requests and/or error reports. However, please do not make hash-linking requests here; patches in this repo are for hashes that have already been linked.

Goals

• Eliminate the need for referencing GoodTools. It hasn't been updated in years and needs to be phased out.
• Provide patches for various hacks, translations, subsets, bug fixes, etc. This includes older versions or abandoned projects where the patches are no longer available.

Contribution Guidelines

Bases and Formats

• Patches must be intended to be used with No Intro, Redump, or FinalBurn Neo bases.
• Do not submit patches to be used with GoodTools or TOSEC unless there are absolutely no other options. This should only be relevant with very few unlicensed or homebrew games.
• The majority of patches are and should be in BPS format. IPS is allowed for NES due to headers and xDelta is allowed for larger files. DO NOT use any other format without a very good reason for doing so.

Naming Scheme

• Patches for hacks that have their own RetroAchievements entry do not need a special naming scheme, at least until we come up with one.
• Patches for Subsets should be named according to their RetroAchivements entry. For example: Mega Man [Subset - Bonus].
• Patches for translations, bug fixes, etc. should be named after the base ROM with the patch info added. Follow this format (not all tags will be applicable): [MSU-1] -> Title -> (Region) -> (Base ROM Version) -> (Language/Patch Type) -> (Patch Version) -> (Patch Author) For example: ToeJam & Earl (USA, Europe, Korea) (Fr) (v0.9) (sky2048).bps. If something is unknown, then leave it blank. It can always be added later.
• Languages must be abbreviated as so:

En English
Ja Japanese
Fr French
De German
Es Spanish
It Italian
Nl Dutch
Pt Portuguese
Sv Swedish
No Norwegian
Da Danish
Fi Finnish
Zh Chinese
Ko Korean
Pl Polish
El Greek
Ro Romanian
Fl Filipino
Ar Arabic
Tu Turkish
Eo Esperanto
La Latin

Compression

• Patches are then compressed to either .zip or .7z, with those following a GAMEID-GameTitleWithoutSpaces naming scheme for linking purposes.
• Whenever possible, please group similar patches together. If a game has five different Russian translations, we do not need a separate link for each one. Just throw them all into the same .zip/.7z. This applies to language patches as well as patches with various versions.

Readme

• Be sure to include a readme.txt in the .zip/.7z that states which ROM the patch is intended to be used with.
• The readme.txt files should follow this format:
  Use with:

[Group, such as No Intro]
[ROM file name and extension]
[ROM Checksum]
[CRC Checksum]
• For [ROM Checksum], use the MD5 of a file instead of the RA Hash.

Other Info

• While not required, people will forever remember you as a nice person if you include .cue files with patches for disc-based games. Filenames for .cue files should match the name of the patch.