Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
23 commits
Select commit Hold shift + click to select a range
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](/public/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](/public/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](/public/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](/public/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](/public/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](/public/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](/public/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](/public/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](/public/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](/public/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](/public/badge-59919.png)
![Mega Man 64, 3](/public/badge-59912.png)
![Tiny Toons Adventures, 1](/public/badge-72006.png)
![Tiny Toons Adventures, 2](/public/badge-71983.png)
![Metal Slug 3, 1](/public/badge-69785.png)
![Metal Slug 3, 2](/public/badge-69837.png)
![Legend of Zelda, 2](/public/badge-62775.png)
![Banjo Tooie, 1](/public/badge-71126.png)
![Banjo Tooie, 2](/public/badge-71179.png)
![Pokemon Pinball, 1](/public/badge-58812.png)
![Pokemon Pinball, 2](/public/badge-58803.png)
![ToeJam and Earl, 1](/public/badge-76075.png)
![ToeJam and Earl, 2](/public/badge-76072.png)
![Super Mario World, 1](/public/badge-46601.png)
![Super Mario World, 2](/public/badge-46760.png)
![Mario Party, 1](/public/badge-54915.png)
![Mario Party, 2](/public/badge-54669.png)
![Harry Potter and The Chamber of Secrets, 1](/public/badge-73534.png)
![Harry Potter and the Chamber of Secrets, 2](/public/badge-73519.png)
![Pokemon Prism, 1](/public/badge-70787.png)
![Pokemon Prism, 2](/public/badge-70432.png)
![Super Mario World Bonus, 1](/public/badge-47080.png)
![Super Mario World Bonus, 2](/public/badge-47077.png)
![Tails Adventure](/public/badge-62326.png)
![Sonic the Hedgehog Chaos](/public/badge-64969.png)
![Kirby's Dream Land 3, 1](/public/badge-60799.png)
![Kirby's Dream Land 3, 2](/public/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](/public/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](/public/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](/public/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](/public/achievement-badge-locked.png)

### Badge Server Files

Expand Down
Loading