Jump to content
LaunchBox Community Forums

Recommended Posts

RetroAchievement Badges

View File

RetroAchievement Badges

What does this plugin do?
Adds “RetroAchievement” Badges to games that support RetroAchievements.
(See complete list of games here: https://retroachievements.org/gameList.php)

Why?
Because some people wanted it.

How to install the plugin:

  1. Download RetroAchBadge.zip
  2. UnBlock the zip file. (Hint: right click the file, select “Properties” and check the box that says ‘Unblock’ [or something along those lines])
  3. Click OK to close the Properties window
  4. Open the zip file
  5. Copy the folder “RetroAchBadge” into your “/LaunchBox/Plugins/” folder
  6. Start LaunchBox
  7. Select Tools
  8. Select "RetroAchievements Badge Updater" (Internet connection required)
  9. Wait for the Updater to complete.  (This may take up to 10 seconds.)

How to use the plugin:

  1. Start LaunchBox (not necessary if you just completed the Install - steps 1 through 9)
  2. Click “BADGES
  3. 'Check’ “Enable Retroachievements

How to add or remove the badge from a game:

  1. Right click the game and select "RetroAchievements Badge"

How to get updates for new games added to RetroAchievements:

  1. In LaunchBox, Select Tools
  2. Select "RetroAchievements Badge Updater" (Internet connection required)

(Note: Step #2 may take up to 5 seconds to complete.)

A word about Platform names:
Some of the Platform names used by RetroAchievements are different than the default names used in LaunchBox.  When using the Badge Updater, it will ‘convert’ these to the default names.

Examples:  “Mega Drive” gets changed to "Sega Genesis".  “SNES” to "Super Nintendo Entertainment System".  "Game Boy" to "Nintendo Game Boy".

This plugin will not rename any of your existing Platforms.  However if your Platform names are different, the badges for that Platform will not appear.  (i.e. “Mega Drive”, “SNES” and "Game Boy")

The fix (if needed):  Rename your Platforms.
Option 2 is to rename the folder(s) inside “/LaunchBox/Plugins/RetroAchBadge/RetroBadge Files”.  Note: This option will need to be done each time you run the Updater.

Platform names that get changed: 

     From                                   To
"Mega Drive"                "Sega Genesis"
"SNES"                            "Super Nintendo Entertainment System"
"Game Boy"                   "Nintendo Game Boy"
"Game Boy Advance"   "Nintendo Game Boy Advance"
"Game Boy Color"         "Nintendo Game Boy Color"
"NES"                               "Nintendo Entertainment System"
"32X"                               "Sega 32X"
"Master System"           "Sega Master System"
"PlayStation"                  "Sony PlayStation"
"Game Gear"                  "Sega Game Gear"
"Virtual Boy"                  “Nintendo Virtual Boy"
"MSX"                              "Microsoft MSX"
"SG-1000"                       "Sega SG-1000"
"Saturn"                           "Sega Saturn"
"Intellivision"                  "Mattel Intellivision"
"Vectrex"                         "GCE Vectrex"
"PC-8000_8800"            "NEC PC-8801"

Changing the default icon:
If you wish to use a different Badge icon, replace “\LaunchBox\Images\Badges\RABadge001.png” with your own image.

Known Issues:
Game titles are taken directly from RetroAchievements and may differ (slightly or a lot) from yours. So if you have a game that is known to have achievements and the badge isn’t showing, follow all steps under How to add or remove the badge from a game:.

Unknown issues:
Let me know when you find them.

Note to those who installed the beta-release:
Delete it before installing this one!  The whole RetroAchBadge folder. Not just part of it.

Designed for LaunchBox 11.9 and newer.  Major contributors to the plugin are: @jayjay


 

  • Like 2
Link to post
Share on other sites

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.

Guest
Reply to this topic...

×   Pasted as rich text.   Paste as plain text instead

  Only 75 emoji are allowed.

×   Your link has been automatically embedded.   Display as a link instead

×   Your previous content has been restored.   Clear editor

×   You cannot paste images directly. Upload or insert images from URL.

×
×
  • Create New...