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.

 

April 24, 2023
Version 2.3.5 will be the last update for this plugin.
As of LaunchBox version 13.2 (Feb. 27, 2023), Achievement Badges are now supported. (Includes RetroAchievements, Steam and GOG achievements)
To enable: click the hamburger menu, select View, Badges, Game Attributes, Enable Achievements.

 

How to install the plugin:

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

Screenshot_2.0.png.15d90f614b43cba91912830a3f804b24.png

 

How to see the badges:

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

badges_2.0.png.cd87f3fd4f424a22618fc34e38eb1e03.png

 

How to add or remove the badge from a game:

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

RightClick_2.0.png.61038e96b30130abf470a6b5b6759ac6.png

 

How to get updates for new games added to RetroAchievements:

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

If you added or removed RetroAchievement badges for specific games, those games will remain added or removed after running the Updater.  To reset the games that have been added/removed, delete the files Added.xml and Removed.xml located in the plugins folder and rerun the Updater.

 

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.

When checking for badges, the plugin will check your Platforms Scrape As setting as well as the Platform name.

Example: If you named your Platform "Game Boy" and Scrape As is set to "Nintendo Game Boy", badges will show for that Platform.

 

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"
"PC-9800"                       "NEC PC-9801"
"PC-FX"                            "NEC PC-FX"
"Dreamcast"                   "Sega Dreamcast"
"PlayStation Portable"  "Sony PSP"
"PC Engine"                    "NEC TurboGrafx-16"



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:.

Updating via the Tools menu may take up to 1 minute to complete.  Though not really an 'issue' perse, but it is a "thing".  So plan your updates around refilling your water glass, grabbing a soda or whatever takes you about 60 seconds to do.

Unknown issues:
Let me know when you find them.

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


 

  • Like 3
  • Thanks 1
Link to comment
Share on other sites

  • 2 years later...

Join the conversation

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

Guest
Unfortunately, your content contains terms that we do not allow. Please edit your content to remove the highlighted words below.
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...