Skip to content
4 changes: 4 additions & 0 deletions docs/.vitepress/config/en.ts
Original file line number Diff line number Diff line change
Expand Up @@ -234,6 +234,10 @@ function sidebarGuidelines(): DefaultTheme.SidebarItem[] {
text: "Player Compatibility Testing",
link: "/guidelines/content/player-compatibility-testing",
},
{
text: "Games With Parallel Releases",
link: "/guidelines/content/games-with-parallel-releases",
},
{
text: "Achievements for ROM Hacks",
link: "/guidelines/content/achievements-for-rom-hacks",
Expand Down
4 changes: 4 additions & 0 deletions docs/.vitepress/config/es.ts
Original file line number Diff line number Diff line change
Expand Up @@ -246,6 +246,10 @@ function sidebarGuidelines(): DefaultTheme.SidebarItem[] {
// text: "Player Compatibility Testing",
// link: "/guidelines/content/player-compatibility-testing",
// },
//{
// text: "Games With Parallel Releases",
// link: "/guidelines/content/games-with-parallel-releases",
//},
{
text: "Logros para ROM Hacks",
link: "/es/guidelines/content/achievements-for-rom-hacks",
Expand Down
4 changes: 4 additions & 0 deletions docs/.vitepress/config/pt.ts
Original file line number Diff line number Diff line change
Expand Up @@ -247,6 +247,10 @@ function sidebarGuidelines(): DefaultTheme.SidebarItem[] {
// link: "/guidelines/content/player-compatibility-testing",
// },
// {
// text: "Games With Parallel Releases",
// link: "/guidelines/content/games-with-parallel-releases",
// },
// {
// text: "Conquistas para ROM Hacks",
// link: "/pt/guidelines/content/achievements-for-rom-hacks",
// },
Expand Down
4 changes: 4 additions & 0 deletions docs/guidelines/content/achievement-set-revisions.md
Original file line number Diff line number Diff line change
Expand Up @@ -45,6 +45,10 @@ Any developer wanting to revise a set needs to:

3. **Post the plan** in the game's forum topic. **NOTE**: Be as specific as possible. The community deserves a good understanding of your intent.

::: danger Un-Merging Parallel Release Sets
Games with parallel releases whose base sets are currently merged together (Example: *Pokémon Red Version | Pokemon Blue Version*) may be un-merged into separate sets, but doing so has additional requirements beyond a standard revision. Please see the full rules in the [Games With Parallel Releases](/guidelines/content/games-with-parallel-releases) document.
:::

4. **Start a Discussion** by creating a new post in `#revision-discussion-forum`.
- Your post title should include the game name and console. Ex: "Revision proposal - Super Mario Bros. (NES)"

Expand Down
32 changes: 32 additions & 0 deletions docs/guidelines/content/games-with-parallel-releases.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
---
title: Games with Parallel Releases
description: Guidelines for handling games with parallel releases on RetroAchievements, including how new achievement sets should be created and how current achievement sets should be revised.
---

# Games with Parallel Releases

Some games have multiple versions that were released simultaneously in parallel and are designed to interact with each other, remaining at their core the same game yet offering differing play experiences. Ex: Mainline Pokemon games.

::: tip Retail Games Only
This policy only applies to licensed retail games. Other categories of games, such as hacks, shall not have separate sets for parallel releases unless there are significant differences, subject to approval by the Developer Compliance team.
:::

[[toc]]

## What Sets Can They Have?

- Each version shall have its own set.
- Each version's set shall have a different author.
- Each version's set must be unique from the others, while still covering all content available, highlighting differences between games with unique and creative achievements.
- Sets whose versions were merged into one base set before this policy entered effect may remain merged.

## Can We Un-Merge Existing Sets?

Unmerging shall be allowed if a game currently has a merged base set, under the following requirements:

- The author(s) of the merged base set shall be given preference as to which version their work shall become.
- If no longer able to be contacted, use best judgment when presenting the unmerge plan, paying attention to any written record that may indicate preference.
- Version-specific achievements in the merged base set shall be transferred with authorship intact to the other version upon unmerge.
- The unmerge plan must be approved by the Developer Compliance team, with input from the QA-Maintainers team.
- A satisfactory plan for how to handle unlocks for players that have earned the merged set achievements must be developed and approved.
- Must pass a standard revision vote.
16 changes: 16 additions & 0 deletions docs/guidelines/developers/claims-system.md
Original file line number Diff line number Diff line change
Expand Up @@ -78,3 +78,19 @@ Each developer is allowed four primary claims. Junior developers are allowed one
## Important Notes

- It is recommended that you post a complete plan in the forum topic. When doing so, be open to suggestions; you can get excellent input and suggestions this way.

## Additional Rules for Specific Types of Sets

### Hacks

Refer to the [Achievements for ROM Hacks](/guidelines/content/achievements-for-rom-hacks) document for full information.

- May not make a set claim for a cosmetic hack; these can likely just be linked to the base set with proper testing.
- May not make a set claim for a simple QOL hack that does not significantly change the gameplay.

### Games with Parallel Releases

Refer to the [Games With Parallel Releases](/guidelines/content/games-with-parallel-releases) document for full information.

- You may not claim a merged set. Example: May not make a claim for *Pokémon Black Version | Pokemon White Version*. These releases must have separate sets.
- You may not claim a parallel version of a game for which you've already made another set. Example: Cannot make a set for [Pokémon White](https://retroachievements.org/game/16211) if you have claim for or already made a set for [Pokémon Black](https://retroachievements.org/game/3887)