Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
25 commits
Select commit Hold shift + click to select a range
b11485e
Replace bit.ly URLs
akleemans Oct 30, 2025
f57d528
Adapt pt/ docs to changes in main hash-labels.md
akleemans Oct 30, 2025
4f746db
Replace links to badges with local images
akleemans Oct 30, 2025
c7b693f
Add mario_time.png
akleemans Oct 30, 2025
f924678
Rename badges
akleemans Oct 30, 2025
bf02d09
Add DevQuests, update badge casing
akleemans Oct 30, 2025
bb166f7
Replace imgur links
akleemans Nov 1, 2025
80d4ecf
Update image descriptions
akleemans Nov 1, 2025
14eb431
Add some github-userimages, add image descriptions
akleemans Nov 1, 2025
e553beb
Move some more images from githubusercontent, fix "Let's" typo
akleemans Nov 1, 2025
28e8f24
Refactor image names to consistent use of "-"
akleemans Nov 1, 2025
80aef8c
Clean up devquest image names
akleemans Nov 1, 2025
9d877f9
Add more images from githubusercontent
akleemans Nov 1, 2025
c995847
Replace rest of githubusercontent images
akleemans Nov 1, 2025
251cdea
Fix image links
akleemans Nov 1, 2025
cbea604
Revert typo fixes, focus on image replacement
akleemans Nov 2, 2025
cbec1fc
Update RP casing for pt version
akleemans Nov 2, 2025
cdd803b
Fix image link for mario-time
akleemans Nov 2, 2025
9e22f2b
Fix image link (...-png)
akleemans Nov 2, 2025
e7ec28f
Add missing badge
akleemans Nov 2, 2025
254ba07
Fix image link to reset_password.png
akleemans Nov 2, 2025
d60fc64
Clean up echo-ram duplicate
akleemans Nov 2, 2025
cbc6b1c
Remove remaining duplicate images
akleemans Nov 2, 2025
ffb5cb1
Update image links by removing /public
akleemans Jan 19, 2026
f247d2f
Update contributing-to-the-docs.md and add explanation for image links
akleemans Jan 19, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/developer-docs/achievement-development-overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ Page is heavily WIP, but the goal is to dive deep into achievement creation. Wil

There are several tools and options available to a developer. Knowing how to properly utilize them will improve the quality of your sets. These tools/options can be used in the Achievement Editor:

![achievement_editor](https://user-images.githubusercontent.com/45054151/128662028-74e64baf-46ff-4c9f-9837-3684bfb42ad8.png)
![achievement_editor](/achievement-editor.png)

### Flags

Expand Down
8 changes: 4 additions & 4 deletions docs/developer-docs/alt-groups.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,21 +13,21 @@ When using _Alt groups_, for the achievement to trigger, all the conditions in t

In this dummy example for Contra (NES) the achievement requires, "While on stage look up or crouch." Lets look at what's in the _Core group_ and in the _Alt groups_:

![image](https://user-images.githubusercontent.com/32706333/48969080-7de44b80-efb6-11e8-88f2-92de405fe306.png)
![Alt Groups: Core](/alt-groups-core.png)
In the core group: `0x18 = 5`. This checks that the player is on stage.

![image](https://user-images.githubusercontent.com/32706333/48969094-9eaca100-efb6-11e8-9f8b-4d64a7aff9b0.png)
![Alt Groups: Alt1](/alt-groups-alt1.png)
In `Alt 01`: `0xbc = 1`. This checks that the player is looking up.

![image](https://user-images.githubusercontent.com/32706333/48969096-b4ba6180-efb6-11e8-9c86-2744509fbb5b.png)
![Alt Groups: Alt2](/alt-groups-alt2.png)
In `Alt 02`: `0xbc = 2`. This checks that the player is crouching.

As long as the player is on stage. The core group is true. If the player looks up, Alt 01 is true. If the player crouches, Alt 02 is true. If core + Alt 01 OR Alt 02 are true, the achievement will trigger.

## Facts about Alt Groups

- To add or remove _Alt groups_ click the `+` or `-` button in the bottom left of the achievement editor.
![image](https://user-images.githubusercontent.com/32706333/48969436-bdf9fd00-efbb-11e8-98ab-2cc730026836.png)
![Alt Groups: Add or remove](/alt-groups-add.png)

- If you want to simply test for **this** `OR` **that** you can leave the core group blank and add **this** in `Alt 01`, and **that** in `Alt 02`.

Expand Down
76 changes: 38 additions & 38 deletions docs/developer-docs/badge-and-icon-creation.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ Icons are **user uploaded** images that are used throughout the site to represen

- _Sonic the Hedgehog's game Icon_

![Sonic the Hedgehog Icon](https://retroachievements.org/Images/016743.png)
![Sonic the Hedgehog Icon](/badge-016743.png)

### Designing New Game Icons - Styling Guide

Expand Down Expand Up @@ -45,7 +45,7 @@ Icons are **user uploaded** images that are used throughout the site to represen
- Hacks - Most hacks use the same sprites from its source game. Other art that represents the game in a meaningful way may be used as long as it is not on the excluded list above (such as external fan art). Art by the developer of the hack may also be used.
- Movie-Licensed/Movie Tie-In Games may use artwork that was used to promote the movie.

![mario time](https://user-images.githubusercontent.com/32706333/52103977-93bd5080-25a5-11e9-9226-4f1af1bbfa81.png)
![mario time](/mario-time.png)

### Other Icon Design Tips

Expand All @@ -63,10 +63,10 @@ Icons are **user uploaded** images that are used throughout the site to represen
Achievement Developers are allowed to change game icons freely for entries that do not have achievements. As a Developer if you'd like to post a backup of the previous image there, if there is one, or backup yours in the forum you're free to but not required. As you create a new set of achievements you are free to create or choose the image you'd like to use as the game icon.

To change a game icon first go to the game page and click on the Dev tools:
![change game icon 1](https://camo.githubusercontent.com/cc05291f1f0da98ef8fd429fbdd6f201735c3edb/68747470733a2f2f692e696d6775722e636f6d2f7371784f6a794c2e706e67)
![change game icon 1](/change-game-icon1.png)

Then click the choose file button highlighted. Find the file on your PC, and then press the submit button highlighted:
![change game icon 2](https://user-images.githubusercontent.com/32706333/52103542-62438580-25a3-11e9-8ede-ce5857abd7ce.png)
![change game icon 2](/change-game-icon2.png)

If a game has existing achievements, game icon changes need to go through [revision process](/guidelines/content/achievement-set-revisions).

Expand All @@ -88,42 +88,42 @@ Icons are stored on the site in the following manner and place: `i.retroachievem

Badges are the user created images for individual achievements of a game.

- _Sonic the Hedgehog's first Badge - #00199)_ ![Amateur Collector Badge](https://s3-eu-west-1.amazonaws.com/i.retroachievements.org/Badge/00199.png)
- _Sonic the Hedgehog's first Badge - #00199)_ ![Amateur Collector Badge](/badge-00199.png)

### Badge creation guidelines and tips

- Badges should refer in some way to what the achievement is about - i.e. a picture of the boss, level or collectible that the achievement requires the player to get to.
- Check out the designs of some of your favorite games. Some users go to great effort to make visually appealing badges:

![Mega Man 64, 1](https://s3-eu-west-1.amazonaws.com/i.retroachievements.org/Badge/59919.png)
![Mega Man 64, 3](https://s3-eu-west-1.amazonaws.com/i.retroachievements.org/Badge/59912.png)
![Tiny Toons Adventures, 1](https://s3-eu-west-1.amazonaws.com/i.retroachievements.org/Badge/72006.png)
![Tiny Toons Adventures, 2](https://s3-eu-west-1.amazonaws.com/i.retroachievements.org/Badge/71983.png)
![Metal Slug 3, 1](https://s3-eu-west-1.amazonaws.com/i.retroachievements.org/Badge/69785.png)
![Metal Slug 3, 2](https://s3-eu-west-1.amazonaws.com/i.retroachievements.org/Badge/69837.png)
![Legend of Zelda, 2](https://s3-eu-west-1.amazonaws.com/i.retroachievements.org/Badge/62775.png)
![Banjo Tooie, 1](https://s3-eu-west-1.amazonaws.com/i.retroachievements.org/Badge/71126.png)
![Banjo Tooie, 2](https://s3-eu-west-1.amazonaws.com/i.retroachievements.org/Badge/71179.png)
![Pokemon Pinball, 1](https://s3-eu-west-1.amazonaws.com/i.retroachievements.org/Badge/58812.png)
![Pokemon Pinball, 2](https://s3-eu-west-1.amazonaws.com/i.retroachievements.org/Badge/58803.png)
![ToeJam and Earl, 1](https://s3-eu-west-1.amazonaws.com/i.retroachievements.org/Badge/76075.png)
![ToeJam and Earl, 2](https://s3-eu-west-1.amazonaws.com/i.retroachievements.org/Badge/76072.png)
![Super Mario World, 1](https://s3-eu-west-1.amazonaws.com/i.retroachievements.org/Badge/46601.png)
![Super Mario World, 2](https://s3-eu-west-1.amazonaws.com/i.retroachievements.org/Badge/46760.png)
![Mario Party, 1](https://s3-eu-west-1.amazonaws.com/i.retroachievements.org/Badge/54915.png)
![Mario Party, 2](https://s3-eu-west-1.amazonaws.com/i.retroachievements.org/Badge/54669.png)
![Harry Potter and The Chamber of Secrets, 1](https://s3-eu-west-1.amazonaws.com/i.retroachievements.org/Badge/73534.png)
![Harry Potter and the Chamber of Secrets, 2](https://s3-eu-west-1.amazonaws.com/i.retroachievements.org/Badge/73519.png)
![Pokemon Prism, 1](https://s3-eu-west-1.amazonaws.com/i.retroachievements.org/Badge/70787.png)
![Pokemon Prism, 2](https://s3-eu-west-1.amazonaws.com/i.retroachievements.org/Badge/70432.png)
![Super Mario World Bonus, 1](https://s3-eu-west-1.amazonaws.com/i.retroachievements.org/Badge/47080.png)
![Super Mario World Bonus, 2](https://s3-eu-west-1.amazonaws.com/i.retroachievements.org/Badge/47077.png)
![Tails Adventure](https://s3-eu-west-1.amazonaws.com/i.retroachievements.org/Badge/62326.png)
![Sonic the Hedgehog Chaos](https://s3-eu-west-1.amazonaws.com/i.retroachievements.org/Badge/64969.png)
![Kirby's Dream Land 3, 1](https://s3-eu-west-1.amazonaws.com/i.retroachievements.org/Badge/60799.png)
![Kirby's Dream Land 3, 2](https://s3-eu-west-1.amazonaws.com/i.retroachievements.org/Badge/60800.png)

- Here's a [forum topic](http://retroachievements.org/viewtopic.php?t=4282&o=5) full of great tips.
![Mega Man 64, 1](/badge-59919.png)
![Mega Man 64, 3](/badge-59912.png)
![Tiny Toons Adventures, 1](/badge-72006.png)
![Tiny Toons Adventures, 2](/badge-71983.png)
![Metal Slug 3, 1](/badge-69785.png)
![Metal Slug 3, 2](/badge-69837.png)
![Legend of Zelda, 2](/badge-62775.png)
![Banjo Tooie, 1](/badge-71126.png)
![Banjo Tooie, 2](/badge-71179.png)
![Pokemon Pinball, 1](/badge-58812.png)
![Pokemon Pinball, 2](/badge-58803.png)
![ToeJam and Earl, 1](/badge-76075.png)
![ToeJam and Earl, 2](/badge-76072.png)
![Super Mario World, 1](/badge-46601.png)
![Super Mario World, 2](/badge-46760.png)
![Mario Party, 1](/badge-54915.png)
![Mario Party, 2](/badge-54669.png)
![Harry Potter and The Chamber of Secrets, 1](/badge-73534.png)
![Harry Potter and the Chamber of Secrets, 2](/badge-73519.png)
![Pokemon Prism, 1](/badge-70787.png)
![Pokemon Prism, 2](/badge-70432.png)
![Super Mario World Bonus, 1](/badge-47080.png)
![Super Mario World Bonus, 2](/badge-47077.png)
![Tails Adventure](/badge-62326.png)
![Sonic the Hedgehog Chaos](/badge-64969.png)
![Kirby's Dream Land 3, 1](/badge-60799.png)
![Kirby's Dream Land 3, 2](/badge-60800.png)

- Here's a [forum topic](https://retroachievements.org/viewtopic.php?t=4282&o=5) full of great tips.
- In the cases of low-resolution games' achievements, it can be hard to get a Badge looking good without it looking _blocky_ or _blurry_, in these cases the _blocky_ look is often preferable, so that the images have a _retro_ feel to them.
- You can make each Badge have little rounded borders like an actual Badge or some extra spiky corners for emphasis or a king's crown for difficult ones. Its your design. It should visually represent the achievement itself, or hint at the location in the game for secrets.
- Matching to the game's art style works well. Google Image searches for "Sprite Sheets" is another useful tip to include some game art.
Expand All @@ -139,10 +139,10 @@ Badges are the user created images for individual achievements of a game.
If you are creating new achievements you are free to upload badges for them.

Badges are uploaded from within the emulator developer tools while in the achievement editor:
![image](https://user-images.githubusercontent.com/32706333/52097132-c73cb280-2586-11e9-95ec-ea5e4dc8f9cd.png)
![Upload Badge](/alt-groups-add.png)

Or you can select a prefabricated image or find other images you've uploaded in the drop down box:
![image](https://user-images.githubusercontent.com/32706333/52097145-d1f74780-2586-11e9-8a22-06ceeeb82fe8.png)
![Badge dropdown](/badge-dropdown.png)

Upload `.png` file types.

Expand All @@ -169,11 +169,11 @@ When uploaded, your file is converted into the following:

- 64x64 32-bit colour PNG. Example:

![00136](https://user-images.githubusercontent.com/8508804/37221161-b9b0bb02-23a7-11e8-81b2-3d09fa7456af.png)
![Achievement badge](/achievement-badge.png)

- 64x64 greyscale and blurred PNG. Example:

![00136_lock](https://user-images.githubusercontent.com/8508804/37221162-b9d7a802-23a7-11e8-9b69-3e91594c1ba4.png)
![Achievement badge locked](/achievement-badge-locked.png)

### Badge Server Files

Expand Down
8 changes: 4 additions & 4 deletions docs/developer-docs/console-specific-tips.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ When excavating the memory of these old consoles it helps to know what the origi

### Memory Mirroring

![nes_mem_mirror](/public/nes-memory-mirroring.png)
![nes_mem_mirror](/nes-memory-mirroring.png)

When using the memory inspector to find variables for NES games, there will be 4 copies of everything you find. If you're wondering "which one do I use?" or "should I check for all of them?" it's not as complicated as it seems.

Expand All @@ -40,7 +40,7 @@ For more info see: http://gameboy.mongenel.com/dmg/asmmemmap.html

### ECHO RAM

![gb_echo_ram](/public/game-boy-echo-ram.png)
![gb_echo_ram](/game-boy-echo-ram.png)

Similarly to the NES, certain variables may show up twice when searching in the Memory Inspector. The second result is in what's called the ECHO RAM, which is a mirror of the actual memory. Since some emulators tend to ignore this area or emulate it incorrectly, it's recommended to NOT use it at all and always use the first result.

Expand Down Expand Up @@ -178,10 +178,10 @@ Fortunately, part of UniBIOS data seems to be reflected in two address strings i
To protect achievements from using UniBIOS, all we need to do is to include a simple protection which will reset when `0x00fe30` in 32-bit size is not equal to `0`. This additionally protects the achievement from unlocking during RAM diagnostic process.

**Here is how the protection should look (selected in the Achievement Editor):**
![unineo1](/public/unibiosprotection.png)
![unineo1](/unibiosprotection.png)

**Here is how the same RAM region looks when other BIOS are used (here MSV):**
![unineo2](/public/unibiosp2.png)
![unineo2](/unibiosp2.png)

## PlayStation

Expand Down
12 changes: 6 additions & 6 deletions docs/developer-docs/developer-welcome.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ The web team is working on a new Management page which is where all dev related

This page is used for editing release dates as well as **drag-and-drop reordering**.

![Example of a game page viewed through the Management site](/public/management-site.png)
![Example of a game page viewed through the Management site](/management-site.png)

## Uploading your First Set!

Expand All @@ -32,7 +32,7 @@ To get to this page, go to your game’s page:
5. Click Bulk promote or demote
6. Click Promote selected

![Achievements being promoted through the Management site](/public/management-achievement-promotion.png)
![Achievements being promoted through the Management site](/management-achievement-promotion.png)

## Achievement-News Announcement

Expand Down Expand Up @@ -100,7 +100,7 @@ Further reading:
[Working with the Right ROM](/guidelines/content/working-with-the-right-rom)
:::

![Creating a game page with an unidentified hash](/public/game-page-creation.png)
![Creating a game page with an unidentified hash](/game-page-creation.png)

### Code Notes

Expand All @@ -120,7 +120,7 @@ You now have access to many more tools on the site to help you as a developer.

Developers have the ability to add games to a Want to Develop list. Sets can be added through the Dev dropdown box on the game page.

![Want to Develop Games button](/public/want-to-develop.png)
![Want to Develop Games button](/want-to-develop.png)

### Game Page

Expand All @@ -146,13 +146,13 @@ You now have full access to the Dev dropdown menu.

- **Want to Develop**: Adds/Removes the game on your Want to Develop list

![Dev menu](/public/dev-menu.png)
![Dev menu](/dev-menu.png)

#### Adding Hubs and Related Games

Hubs and related games can be added to game pages by entering the page IDs and clicking “Add”. Hubs managed by the DevCompliance, QA, and Art teams should not be added/removed, send a message to the corresponding team instead.

![Linked hubs and related games](/public/add-related-games.png)
![Linked hubs and related games](/add-related-games.png)

## Discord Channels

Expand Down
Loading