| Both sides previous revision Previous revision Next revision | Previous revision |
| retroachievements_settings [2021/09/15 11:35] – added Duckstation to supported emulators atari | retroachievements_settings [2022/07/16 14:25] (current) – Added clarification about FBNeo and lack of MAME support superchooch |
|---|
| ~~NOTOC~~ | ====== RetroAchievements ====== |
| ===== RetroAchievements ===== | |
| |
| ====What is it?==== | RetroAchievements allows you to earn achievements on old retro games like Mario, Sonic, etc. on several home gaming systems, as well as some arcade games using FBNeo (RetroAchievements are not supported in MAME). This is very similar to Xbox 360 or PS3/PS4 achievements or successes and you’re able to keep track of what you’ve unlocked from [[http://retroachievements.org|their website]]. The best thing about this: it’s a free service. |
| This allows you to earn achievements on old retro games like Mario, Sonic, etc. on several home gaming systems, as well as some arcade games (like Neo Geo or some MAME games). This is very similar to Xbox 360 or PS3/PS4 achievements or successes and you’re able to keep track of what you’ve unlocked from [[http://retroachievements.org|RetroAchievements]]. The best in this: it’s a free service. | |
| |
| ====Settings==== | Configuration is through **GAMES SETTINGS** -> **RETROACHIEVEMENTS SETTINGS** |
| Configuration is through **GAMES SETTINGS** -> **RETROACHIEVEMENTS SETTINGS**: | |
| |
| * **RETROACHIEVEMENTS** {{:switch-button.png?20|}} | Batocera **v30** introduced an updated look and feel for the RetroAchievements screen. You can select each game to have more details, including each RetroAchivement for each game, and you can even launch the game from this screen! |
| * **HARDCORE MODE** {{:switch-button.png?20|}} with this mode on, special Libretro features like rewind, fast forward or cheat codes are disabled. Very much the real "console" experience, for hardcore fans. | |
| * **LEADERBOARDS** {{:switch-button.png?20|}} some games keep a ranking of all RetroAchievements players. Compete with the best players on the Internet! | |
| * **VERBOSE MODE** {{:switch-button.png?20|}} when you unlock an achievement, get details about the achievement you have unlocked, with a cute little badge in the upper left corner of your screen. | |
| * **AUTOMATIC SCREENSHOT** {{:switch-button.png?20|}} do you want to keep a screenshot of the moment you unlocked a RetroAchievement? They are stored in the Batocera screenshot directory. | |
| * **UNLOCK SOUND** if you want to play a sound, like the classic PS3 or Xbox360 success unlock sound. You have a selection of retrogaming-oriented sounds, but you can also add your own unlock sounds in ''/userdata/sounds/retroachievements/'' as long as they are in the **.ogg** format. | |
| * **USERNAME** and **PASSWORD** are the ones you have set up on [[https://www.retroachievements.org|the RetroAchievements website]]. | |
| * **SHOW IN MAIN MENU** {{:switch-button.png?20|}} if you want a shortcut to the RetroAchievement screen from the main menu (see the screenshot below) | |
| * **FIND ALL/NEW GAMES** in order to show a little icon in the Batocera menu for the games that have RetroAchievements, you have to use this option to calculate the MD5 checksums of your ROM files and make sure they match what [[https://www.retroachievements.org|the RetroAchievements database]] is expecting. You can do that for all games in your library, or games that haven't been indexed yet. | |
| |
| Batocera v30 introduced an updated look and feel for the RetroAchievements screen. You can select each game to have more details, including each RetroAchivement for each game, and you can even launch the game from this screen. | {{ :retroachievements_v30.png?nolink&720 |}} |
| |
| {{ :retroachievements_v30.png?nolink&600 |}} | <WRAP center round tip> |
| | For the adventurous, you can enable the **HARDCORE MODE** to <wrap em>disable rewind and loading save states</wrap>. Keep this in mind if you do turn it on if you want to utilize save states in the future! |
| | </WRAP> |
| |
| | ===== Custom achievement unlock sound ===== |
| |
| ====System-specific information==== | Batocera comes with an assortment of custom sounds for achievement unlocks (some you may already be very familiar with), but it is also possible to add your own custom sounds to it. They must be in the OGG format in order to work. |
| RetroAchievements are only available on certain Libretro cores (and from **v31** DuckStation). If you play a system that has both standalone and Libretro cores, make sure you selected a Libretro core. Not all Libretro cores are compatible with RetroAchievements. To see whether or not you can use RetroAchievements for a particular game, hold {{:wiki:south.png?nolink&20|South button (B SNES)}} (in **v30** and prior, press {{:wiki:north.png?nolink&20|North button (X SNES)}}) and look at the top of the per-game settings. Batocera tells you what core is currently configured, and which one is compatible with achievements (if there is one). | |
| |
| {{ :retroachievements_details.png?nolink&600 |}} | Place your sound files in ''sounds/retroachievements/'', they will then appear next time you open **GAMES SETTINGS** -> **RETROACHIEVEMENTS SETTINGS** -> **UNLOCK SOUND**. |
| |
| Also, achievements can depend on the ROM format you are using. For example, for Playstation 1, make sure you are using CUE+BIN or CHD format as they're the only formats supported with RetroAchievements, and **not** the PBP format (may change in the future). | ===== System-specific information ===== |
| |
| ====Wanna play with us?==== | RetroAchievements are only available on certain Libretro cores (and from **v31** DuckStation). If you play a system that has both standalone and Libretro cores, make sure you select the compatible emulator/core. Not all Libretro cores are compatible with RetroAchievements. To see whether or not you can use RetroAchievements for a particular game, hold {{:wiki:south.png?nolink&20|South button (B SNES)}} (in **v30** and prior, press {{:wiki:north.png?nolink&20|North button (X SNES)}}) and look at the top of the per-game settings. Batocera tells you what core is currently configured, and which one is compatible with achievements (if there is one). |
| | |
| | {{ :retroachievements_details.png?nolink&720 |}} |
| | |
| | Also, achievements can depend on the ROM format you are using. For example, for [[systems:psx|PlayStation 1]], make sure you are using ''*.cue'' + ''.bin'' or ''*.chd'' format as they are the only formats supported with RetroAchievements, and **not** the ''*.pbp'' format (may change in the future). For [[systems:psp|PlayStation Portable]] only pure ''*.iso'' is supported. |
| | |
| | ===== Wanna play with us? ===== |
| |
| Finally, if you want to compete with fellow Batocera users, you can find a list of Batocera RetroAchievements players [[https://batocera.org/retroachievements|on this page from the web site]]. | Finally, if you want to compete with fellow Batocera users, you can find a list of Batocera RetroAchievements players [[https://batocera.org/retroachievements|on this page from the web site]]. |
| Go to the [[https://discord.gg/ndyUKA5|Discord channel]] and ask moderators to be added to the list! | Go to the [[https://discord.gg/ndyUKA5|Discord channel]] and ask moderators to be added to the list! |
| |
| ====Add RetroAchievements support for custom systems==== | ===== Add RetroAchievements support for custom systems ===== |
| |
| If you add a custom system, for example MSU1, and you know that some games support RetroAchievements, by default the RetroAchievements will NOT be unlockable. This is because your custom system is not referenced by Batocera as available for RetroAchievements. If you have Batocera **v32** or later, you can add a manual ''*.cheevos_force'' option to ''batocera.conf''. | If you add a custom system, for example MSU1, and you know that some games support RetroAchievements, by default the RetroAchievements will NOT be unlockable. This is because your custom system is not referenced by Batocera as available for RetroAchievements. If you have Batocera **v32** or later, you can add a manual ''*.cheevos_force'' option to ''batocera.conf''. |
| |
| For example, setting ''msu1.cheevos_force=true'' in ''batocera.conf'' enables that custom system to have RetroAchievements. | For example, setting ''msu1.cheevos_force=true'' in ''batocera.conf'' enables that custom system to have RetroAchievements. |
| | |
| | This can also be used for games on systemss that say they support achievements in EmulationStation but don't actually login when launched. For example, if this is what you can see in EmulationStation when going into a game's achievements: |
| | |
| | {{:achievements_in_es.jpg?direct&600|Screenshot showing the achievements in ES.}} |
| | |
| | but when in game going to the quick menu's achievements section: |
| | |
| | {{:retroarch_not_sign_into_retroachievements.jpg?direct&600|Screenshot showing the achievements menu in RetroArch saying "No achievements to Display."}} |
| | |
| | Then adding ''n64.cheevos_force=true'' to ''batocera.conf'' would fix it. If this is the case, let the devs in the Discord server know, as this is usually an easy fix. |
| | |
| | ===== Manually adjusting RetroAchievement settings ===== |
| | |
| | Although most everything related to RetroAchievements can be adjusted from within ES's settings menus, such settings can still be adjusted from ''batocera.conf'': |
| | |
| | <code> |
| | ## Enable retroarchievements (0,1) |
| | ## Set your www.retroachievements.org username/password |
| | ## Escape your special chars (# ; $) with a backslash : $ => \$ |
| | global.retroachievements=0 |
| | global.retroachievements.hardcore=0 |
| | global.retroachievements.leaderboards=0 |
| | global.retroachievements.verbose=0 |
| | global.retroachievements.screenshot=0 |
| | global.retroachievements.username= |
| | global.retroachievements.password= |
| | ## Show badges in Retroarch cheevos list and color them when they're win like on the web site |
| | global.retroarch.cheevos_badges_enable=true |
| | ## Show all achievements as if they were already unlocked. |
| | global.retroachievements.encore=true |
| | </code> |
| | |