Achievement Set Revisions
Any changes to a set with existing achievements is considered a revision. They typically happens after someone present a plan in the game's forum topic and in the
#revision-voting channel on Discord and the plan is approved by the achievement creators community.
There are three types of revisions:
- Standard Revisions - Changes to an achievement set that affect another developer's work. These include adding achievements, removing achievements, and reworking existing achievements.
- Rescores - Changes to the point value of an achievement.
- Icon-Gauntlet - Changes to a game page's icon that is awarded upon mastering a set and changes to the individual achievement badges.
Each are assigned their own Discord role:
|Type||Role||Getting the role||Who can get the role|
||React with 🗳️ here||achievement creators|
||React with 💯 here||achievement creators|
||React with 🎨 here||any verified discord user|
Any developer wanting to revise a set need to:
Prepare a plan for each (where you're not the original author)
- Achievement rework
If the original set developer(s) are still active, inform them of your plans. Not only would this be a "courtesy call," they may have valuable insight or resources that you can utilize to help your revision.
Present the plan in the game's forum topic. NOTE: Be as specific as possible, but if you have only a vague plan, provide a general idea of what you want to do and don't go too far from that idea.
Post a link to that topic in
#revision-voting. If you're not on Discord, another developer can do it for you.
Once a revision vote is posted, the developer can address any comments, concerns, and objections the community may have to the plan. The vote is approved/rejected after 24 hours and is pass/fail by simple majority.
Note: Anonymous revision proposals - If desired, a developer can choose to propose a revision plan while remaining anonymous throughout the voting process. Simply contact a mod or admin to request that the plan be presented on your behalf.
When Making a Revisionlink
Try to avoid making copies of existing achievements, or clone and demote existing copies. If there are issues with current achievements make fixes to the existing ones.
Resolve any open tickets for achievements that will be kept in the set. Tickets for achievements that are being demoted can simply be closed with the demotion cited. In cases where the revision is simply the demotion of one or more achievements, the developer does not need to handle the tickets for other achievements in the set.
If you are adding a similar concept to one found in the set, where possible reuse the old concept and update it rather than make a new one. This prevents players from having to unnecessarily re-earn achievements, restricts needless changes to sets, and preserves good quality developer work and concepts.
Since revisions vary in the amount of adjusted content, they are treated the same as an achievement set reservation. If three months have passed since your revision plan was approved, you will need to provide an update that details the current progress. Not doing so will invalidate the revision and the plan will need to be approved again with a new vote.
No Need for Approvallink
- Making changes to an achievement or to an achievement set where you are the original author and no other developer has revised it; it is still a good idea to post the plan for your changes in the forum.
- Resolving tickets or bugs on achievements made by developers who are listed as inactive in the list of developers. In these cases you're only allowed to fix the achievement to match the description; do not change the intention of the achievement without going through the revision process above. If you find a problem with an achievement that has an active developer either create a ticket or contact them to assist in resolution.
- Adding battery save, cheat code, or password protections to achievements where the developer is inactive. (be sure to properly test your changes). If they are active, either create a ticket or contact them to assist applying the improvements.
- Fixing misspellings, grammatical errors, and other typos in the achievement names or descriptions. In some cases, these are intentional, so be sure to make note of it in the forum.
- Making updates to game page information and title / screenshot / box art images.
In the event that a revision includes merging two sets together (e.g. the Pokemon Red/Blue merge), the developer who does the revision needs to keep track of achievements in the demoted set and their equivalent achievements in the set it is being merged with. If the revision vote passes, this information must be sent to an admin so the achievements from the merged set can be manually awarded to the earners of the demoted set.
Respecting Revision Planslink
If you are one of or the original set developer(s) for a set that is currently undergoing a revision, you must communicate with the developer carrying out the revision before making changes to the set. This is to prevent potential extra work for the revision, overlapping or redundant changes, etc.
Up until June 2019, RetroAchievements sets had a cap of 400 points, with no restrictions on individual achievements. The set cap was removed to focus less on overall set totals and more on the achievements themselves. This initiative was also meant to eliminate the misconception that a set worth 400 points is a "complete" set, but is also an ongoing community effort to promote fairness across the board. Information on the scoring process can be found here.
Anyone wanting to rescore a set needs to:
Prepare a rescore plan that shows the original scores and the proposed scores. A quick and easy way to do this is by utilizing this sheet; you can enter the Game ID in F2 to bring up a full list of that game's achievements and scores.
Post the plan in the game's forum topic.
Post a link to the topic in the
#revision-votingchannel on Discord.
Prepare to do some negotiating with other users and try to find a good middle-ground.
Voting will be active for 24 hours. If a rescore passes, you can make the necessary changes.
No Need for Approvallink
Some achievement sets can be rescored without going through the voting process:
If you are the only credited author of an achievement set being rescored and no other developer has rescored it.
If a co-author you collaborated with on an achievement set gives you their blessing to do a rescore and no other developer has rescored it.
The Icon Gauntlet is used to vote for new game icons or new badges for a set. With the vote it is checked which version is preferred by the community.
Any user wanting to change the game icon or badges of a set need to:
Create the game icon or new badges. For more info, see Badge and Icon Creation.
Upload the work on an image sharing site.
Post your images in the correct forum topic.
[game=GameID]tag and insert the Game ID which can be found in the URL of the game's page.
[img=http://YourImageURL.png]tag and insert the URL from your image into it along side the one which should be replaced and mark which of them is the new one.
An example of a typical game icon vote can be seen here.
An example of a typical badge vote can be seen here.
Post links to the old icon/badges and their contenders in the
#revision-votingchannel on Discord by using the following template:
Discord Templates📊 1 vs. 1 proposal:
`?quickpoll (game/hub page link) | Current (current icon/badges link) | Contender (contender icon/badges link)`
📊 1 vs. 2 or 3 proposal:
`?quickpoll (game/hub page link) | Current (current icon link) | Contender 1 (contender 1 icon link) | Contender 2 (contender 2 icon link) | Contender 3 (contender 3 icon link)`
Discord only embeds 4 images at maximum in a single post (current icon vs. 3 contenders), so if there's at least 5 images required (current icon vs. 4+ contenders), you'll have to do a montage with all icons:
📊 1 vs. 4+ proposal:
`?quickpoll (game/hub page link) | Current | Contender 1 | Contender 2 | Contender 3 | Contender 4 | Contender 5 | Contender 6 (single image montage link with all icons)`
- Voting will be active for 24 hours. If the voting passes, a developer can replace the Icon/Badges.
- In cases where there are several designs, the contender list can be extended. Remember to add the letter emojis, in alphabetical order, as soon as you post the proposal so people can vote by clicking on them.
- If you are not active on Discord, you may have someone else post the vote on your behalf.
No Need for Approvallink
The game does not have an achievement set, nor is it reserved by a developer.
The entry has no game icon or badges.
The new icon/badge(s) display the same content, but are of better quality.
You are the existing set's sole developer and no other developer has changed the icon/badge(s).
You are one of the existing set's original developers as part of a collaborative set, all parties agree to the change, and no other developer has changed the icon/badge(s).
Voting and Discussionlink
Revision voting is currently dev-only. While voting is exclusive to Discord, please remember that anyone can express their comments, questions, concerns, criticisms, etc. in the forum thread in which the plan was posted. The issues regarding Discord exclusivity will be addressed in a future version of the website.
If you vote against changes in an achievement set, please state your reasoning in the discussion channel. This is so potential compromises can be made for a broader acceptance of the changes.
Hijacking revision, rescore, or icon-gauntlet votes will not be tolerated. Votes from alt accounts will be discarded if discovered and repeated occurrences will result in the alt account being removed from the server. If the alt's primary account is confirmed, they will have their vote(s) discarded and may face suspension from future votes.
If a revision plan that involves the demotion of achievements is proven to contain misleading or false information regarding the in-game requirements, the current proposal will be considered invalid. If evidence of this is found after a vote has already passed, the demoted achievements must be reinstated until a new vote is held.
Last 10 changes on this page:
[2021-07-28 10:11] televandalist:Added point about misleading or false information in revision proposals to "Voting and Discussion" section.
[2021-07-10 01:57] televandalist:Fix image links and remove mention of lensdump.
[2021-05-28 22:10] Hotscrock:Removing the part that says non-devs are allowed to vote on revisions.
[2021-05-12 20:00] televandalist:Icon Gauntlet - 4 was listed as 5. Added point 5 regarding collabs.
[2021-05-12 19:54] televandalist:Updated Discord template for Icon-Gauntlet
[2021-05-12 19:33] televandalist:Added section about respecting revision plans
[2021-05-09 07:36] televandalist:For rescores, removed bit about pre-June 2019 sets since it's no longer relevant.
[2021-05-09 07:28] televandalist:Expanded bit about resolving open tickets for sets during a revision.
[2021-05-09 06:50] televandalist:Changed the merged set example from LoZ to Pokemon Red/Blue. Removed mention of the vote-ban role since it's no longer used.
[2021-02-18 06:33] televandalist:I forgot to add the part about contacting the original dev(s) back in when I rewrote most of this about a year ago. Added it back in as point 2 under Standard Revisions. :facepalmsf: