Difference between pages "Kahvibreak" and "Dummies Guide: RetroArch"

From Emulation General Wiki
(Difference between pages)
Jump to navigation Jump to search
(Download: perhaps we should stop linking to it directly)
 
(Ricing RetroArch)
 
Line 1: Line 1:
{{Infobox emulator
+
If someone linked you here, they probably thought you were being a dummy.  
|title        = Kahvibreak
+
So go ahead, take your time, and start from the top.
|logo          = Kahvibreak.png
 
|logowidth    = 155
 
|developer    = BlueMaxima's<br/>Kahvibreak Team, Nokia64
 
|version      = {{Kahvibreak}}
 
|active        = Yes
 
|platform      = [[Emulators on PC|Windows]]<br/>Linux<small> (Beta)</small>
 
|architecture  =
 
|target        = [[Cellphone_emulators#J2ME (Java 2 Micro Edition)|J2ME Games]]
 
|compatibility =
 
|accuracy      =
 
|website      = [https://bluemaxima.org/kahvibreak Kahvibreak]
 
|prog-lang    =
 
|support      =
 
|license      = MIT (Launcher)
 
|source        = [https://bluemaxima.org/kahvibreak/KBLSources.7z Source] (Launcher)
 
}}
 
  
'''Kahvibreak''' is a [[Preservation projects|preservation project]] and collection of [[Cellphone_emulators#J2ME (Java 2 Micro Edition)|Java 2 Micro Edition]] mobile phone games, presented using the [[Flashpoint|Flashpoint Launcher]] and emulated via the J2ME emulators <i>[[KEmulator]]</i> and <i>[[FreeJ2ME]]</i>.
+
==Downloading RetroArch==
 +
The latest stable version of RetroArch can be found on the libretro site, [http://buildbot.libretro.com/stable/]. Or the latest experimental build from [http://buildbot.libretro.com/nightly/]
  
==Overview==
+
For Linux intructions read [[Using RetroArch#Installing RetroArch on Linux|Using RetroArch]].
  
* The launcher for BlueMaxima's Kahvibreak (the J2ME preservation project).
+
Open the .7z file with [http://www.7-zip.org/download.html 7zip] or WinRAR, or the archiver of your choice and extract the files to where you want to install RetroArch, or if on console/phone, install it using the standard method for that system.
  
* Kahvibreak uses the same workflow as Flashpoint. Games are curated in the same way, and each game has the same set of metadata (publisher, developer, logo, screenshot, etc).
+
==Controls==
 +
The menu is controlled mainly by the RetroPad, which is libretro's gamepad abstraction that uses SNES-style face buttons and PlayStation DualShock-style shoulder buttons and analog sticks. The default keybinds for the RetroPad are as follows:
 +
{| class="wikitable" style="float:right; text-align:center;"
 +
!scope="col"|RetroPad
 +
!scope="col"|Keyboard
 +
!scope="col"|PlayStation
 +
!scope="col"|Xbox
 +
|-
 +
|[[File:Retro_Dpad.png|48px]]
 +
|[[File:Key_Arrow-Up.png|48px]]<br>[[File:Key_Arrow-Left.png|48px]][[File:Key_Arrow-Down.png|48px]][[File:Key_Arrow-Right.png|48px]]
 +
|[[File:PS3_Dpad.png|48px]]
 +
|[[File:360_D-pad.png|48px]]
 +
|-
 +
|[[File:Retro_A_Round.png|48px]]
 +
|[[File:Key_X.png|48px]]
 +
|[[File:PS3_Circle.png|48px]]
 +
|[[File:360_B.png|48px]]
 +
|-
 +
|[[File:Retro_B_Round.png|48px]]
 +
|[[File:Key_Z.png|48px]]
 +
|[[File:PS3_Cross.png|48px]]
 +
|[[File:360_A.png|48px]]
 +
|-
 +
|[[File:Retro_X_Round.png|48px]]
 +
|[[File:Key_S.png|48px]]
 +
|[[File:PS3_Triangle.png|48px]]
 +
|[[File:360_Y.png|48px]]
 +
|-
 +
|[[File:Retro_Y_Round.png|48px]]
 +
|[[File:Key_A.png|48px]]
 +
|[[File:PS3_Sqaure.png|48px]]
 +
|[[File:360_X.png|48px]]
 +
|-
 +
|[[File:Retro_L1.png|48px]]
 +
|[[File:Key_Q.png|48px]]
 +
|[[File:PS3_L1.png|48px]]
 +
|[[File:360_Left-Bumper.png|48px]]
 +
|-
 +
|[[File:Retro_R1.png|48px]]
 +
|[[File:Key_W.png|48px]]
 +
|[[File:PS3_R1.png|48px]]
 +
|[[File:360_Right-Bumper.png|48px]]
 +
|-
 +
|[[File:Retro_Start.png|48px]]
 +
|[[File:Key_Enter.png|96px]]
 +
|[[File:PS3_Start.png|48px]]
 +
|[[File:360_Start.png|48px]]
 +
|-
 +
|[[File:Retro_Select.png|48px]]
 +
|[[File:Key_Shift.png|96px]]
 +
|[[File:PS3_Select.png|48px]]
 +
|[[File:360_Back.png|48px]]
 +
|-
 +
|[[File:Retro_Menu.png|48px]]
 +
|[[File:Key_F1.png|48px]]
 +
|[[File:PS3_Home.png|48px]]
 +
|[[File:360_Guide.png|48px]]
 +
|}
 +
The R2, L2, R3, and L3 buttons, and left/right analog sticks are not mapped to the keyboard by default.
 +
Gamepads can be mapped manually in the menu under ''Settings'' → ''Input'' → ''Input User 1 Binds'' → ''User 1 Bind All'', but automatic configuration is possible with [https://github.com/libretro/retroarch-joypad-autoconfig autoconfig profiles]. On Windows, all XInput and some DirectInput gamepads will be mapped automatically when detected to the RetroPad using the included autoconfig profiles.
 +
Touchscreen controls and light gun peripherals use the mouse.
 +
 
 +
In the menu, the following buttons are used:
 +
 
 +
*A button = Confirm
 +
*B button = Cancel
 +
*X button = Search prompt
 +
*Y button = Delete input bind
 +
*D-Pad = Navigation
 +
*Start button = Reset option to default
 +
*Select button = Show tooltip for a particular option
 +
*R and L buttons = Fast scrolling through files by jumping to the next letter.
 +
 
 +
By default, the keys used to navigate the menu are the following:
 +
 
 +
*Enter = Confirm
 +
*Backspace = Cancel
 +
*Slash = Search prompt
 +
*Delete = Delete input bind
 +
*Arrow keys = Navigation
 +
*Spacebar = Reset option to default
 +
*Right Shift = Show tooltip for a particular option
 +
*Page Up and Page Down = Fast scrolling through files by jumping to the next letter.
 +
 
 +
If "Unified Menu Controls" are enabled under ''Settings'' → ''Input'' , then the keybinds for the RetroPad are used instead for menu control; this was the original behavior before v1.4.1.
 +
 
 +
There are also various hotkeys that are mapped by default. The most important ones to remember are the following:
 +
 
 +
*Quit = Escape
 +
*Menu toggle = F1
 +
*Save State = F2
 +
*Load State = F4
 +
*Fullscreen toggle = F
 +
*Fast-Forward toggle = Spacebar
 +
*Screenshot = F8
 +
 
 +
All hotkey binds can be viewed and changed at ''Settings'' → ''Input'' → ''Input Hotkey Binds''. Additionally, if you map Enable Hotkeys to a keyboard key, it will require that key to be held in order to trigger any hotkeys, which may be needed for cores that use the keyboard for input. Hotkeys can also be mapped to RetroPad buttons as well.
 +
 
 +
Some people may not like having Escape key quit the program instantly and are used to having Escape bring up a menu instead. Since the hotkeys are configurable, you can change behavior of the Escape key in your config:
 +
 
 +
<pre style="width:250px;">input_exit_emulator = "nul"
 +
input_menu_toggle = "escape" </pre>
 +
 
 +
The quit hotkey will be unmapped, and the menu toggle hotkey will become Escape instead of F1.
 +
 
 +
==Downloading Cores==
 +
RetroArch doesn't come with emulation cores, so you have to download them yourself. However, RetroArch does have a built-in updater. So to download up to date cores, scroll down to ''Online Updater'', and select ''Core Updater''. RetroArch will download a list of available cores to download, and you can individually download them. To see what core does what, see [[Libretro#Cores|this list.]]
  
* Games are double click to play, with all the difficult parts taken care of. Install is easy; just extract the ZIP file after you download it.
+
If for whatever reason RetroArch can't download cores, or won't display a list of available cores for download, you can get them from the buildbot [http://buildbot.libretro.com/nightly/ here.]
  
* A version of the Java software is included alongside Kahvibreak and the emulators run through it, so you don't need to install Java to play.
+
==Running a Game==
 +
After downloading a core you can run a game by selecting ''Load Content'' → ''Select File And Detect Core'' and selecting your game.
  
You will need a full-sized keyboard to play.  
+
If you have only have 1 core that can run the selected game, then RetroArch will automatically load that core. If you have multiple cores that are capable of running the game you'll be given the choice between them.
  
==Controls==
+
==BIOS and System files==
 +
Some emulation cores require special system files or BIOSes. These can be downloaded [[Emulator_Files#Multi-System|here.]] Extract the ''system'' folder in that archive to where you installed RetroArch (the folder where the retroarch program is. retroarch.exe on Windows).
  
The numpad is laid out like a phone keypad (with the 7/8/9 and 1/2/3 key rows reversed).
+
If it doesn't find the BIOS, go to ''Settings'' → ''Directory'' → ''System/BIOS Dir'' (or find <code>system_directory</code> in the config file) and make sure it points to the ''system'' folder.
Q and W are soft keys, E and R serve as * and #, and you can navigate with the arrow keys and Enter.
 
Both emulators use the same control scheme.
 
  
==Kahvibreak Curation Tutorial==
+
==Core Options, Core Specific Settings==
[https://bluemaxima.org/flashpoint/datahub/Kahvibreak_Curation_Tutorial Tutorial]
+
To edit options or settings specific to a core, you must start a game with that core. After loading a game, press F1 or the Home/Guide button on your 360/PS3 controller to get back to RetroArch's menu. From there you can change ''Core Options'', set core specific input options, cheats, and change shader settings.
These are added to the collection by curators on our Discord server. Curation consists of picking out best version(s) of a game and packaging it with a logo, gameplay screenshot and metadata (essentially information such as its developer, publisher, genre, platform and release date) and choosing one of included emulators which works best with it.
 
  
==Download==
+
==Shader Settings==
 +
Shaders usually either come in single .cg files or as a group of files controlled by a .cgp preset file. If you want to use a preset, like CRT-Royale or Super-XBR, simply select ''Load Shader Preset'' under ''Shader Options'' and select a .cgp file. If you want to select individual .cg files, increase the ''Shader Passes'' and select a .cg file through ''Shader #0'' (or #1, #2, etc.).
  
{| cellpadding="2"
+
After selecting your shader setup, hit ''Apply Shader Changes''.
|-
 
|align=center|{{Icon|Win-big}}
 
|'''[https://bluemaxima.org/kahvibreak/Kahvibreak%201.5.zip Stable Build]'''<br/>
 
'''[https://bluemaxima.org/kahvibreak/Kahvibreak%20Brewer%201.5.11.zip Dev Build]'''
 
|-
 
|align=center|{{Icon|Lin-big}}
 
|'''[https://bluemaxima.org/kahvibreak/linux-testing/index.html Linux Build]'''<small> Beta version</small>
 
|}
 
  
==Games list==
+
==Saves and Saving Settings==
 +
By default, RetroArch will save settings when it closes and will do so unless you put RetroArch in a directory that needs elevated privileges without running as administrator/root. ''Save New Config'' will save a ''new'', different, config that won't be loaded the next time RetroArch starts.
  
* <b>[https://bluemaxima.org/flashpoint/datahub/Kahvibreak_Game_List Kahvibreak Games List]</b><br/>
+
It's probably a good idea to enable ''SaveRAM Autosave Interval'' (under ''Settings'' → ''Saving'') so game saves will be written to your hard drive while RetroArch is running.
<small> (nearly 2000 new games and plenty of minor fixes)</small>
 
* <b> [https://bluemaxima.org/flashpoint/datahub/Kahvibreak_Wanted_Games Kahvibreak Wanted Games]
 
<br/>
 
  
==Related projects==
+
==Mednafen PSX==
 +
This particular core requires some specific care. You should have the correct BIOS (if not follow the [[Dummies_Guide:_RetroArch#BIOS_and_System_files|BIOS and System files]] section), you'll also need to make sure your game has a metadata file in the form of a .cue, .toc, .ccd, or .m3u file. The most common metadata people use is .cue, and if your PS1 game lacks a metafile, you can [[Cue_sheet_(.cue)|create one.]]<br>An easier way to get around metadata issues is to get your games from a better source. Redump PS1 games come in .bin/.cue format and work on mednafen without issue, but other sets that come in .bin/.cue/.mp3 format might need editing their cue file with Notepad with the correct filenames for them to work correctly.
  
* [[Flashpoint]]
+
==Ricing RetroArch==
 +
There are 4 different menu drivers for RetroArch to choose from, RGUI, GLUI, Ozone and the default XMB. To switch between them go ''Settings'' → ''Driver Settings'' and switch ''Menu Driver''. You'll need to restart RetroArch for changes to take effect.
  
==See also==
+
You can change your wallpaper, text color settings, text size (DPI Override, GLUI only), toggle mouse support, and whether to display the boxart in the ''Menu Settings''.
  
* [[J2ME Loader]] - J2ME Emulator for Android
+
You can change RetroArch's menu font, but it'll only work for the GLUI menu driver (only on 1.2.2, newer builds have changed GLUI significantly and it no longer uses the OSD font). To change it, under ''Onscreen Display Settings'' hit ''OSD Message Font'' and select a .ttf font file.<br>Should be noted that Onscreen Display Settings are for the yellow popup messages that RetroArch displays and GLUI happen to use fonts from it, all of the other settings here only change the popup message.
* [[FreeJ2ME]]
 
* [[KEmulator]] - J2ME Emulator for Windows
 
  
 +
XMB loads its font from <code>$assets_directory/xmb/monochrome/font.ttf</code>, so you can replace the default font .ttf with a custom one. The same can be done with the default backgrounds and icons.
  
==External links==
+
==Cheats==
* [https://discord.gg/8TgbHAG Official Discord server]
+
Not all cores support cheats, you can check the [http://wiki.libretro.com/index.php?title=Main_Page#Core_Software_Library Libretro wiki] for which cores do. By default RetroArch comes with a fairly large cheat database, so to make a new cheat file, you can find files in the ''cheats'' folder of RetroArch's install directory for reference. To enable cheats, load the game, toggle RetroArch's menu, load a cheat file in the ''Core Cheat Options'' and you'll get a list of cheats available which you can toggle. After setting your cheats, hit ''Apply Cheat Changes''. Some cheats may require you to ''Restart Content'' to take effect.
  
[[Category:Not really emulators]]
+
[[Category:FAQs]]
 +
[[Category:RetroArch]]

Revision as of 06:45, 21 October 2021

If someone linked you here, they probably thought you were being a dummy. So go ahead, take your time, and start from the top.

Downloading RetroArch

The latest stable version of RetroArch can be found on the libretro site, [1]. Or the latest experimental build from [2]

For Linux intructions read Using RetroArch.

Open the .7z file with 7zip or WinRAR, or the archiver of your choice and extract the files to where you want to install RetroArch, or if on console/phone, install it using the standard method for that system.

Controls

The menu is controlled mainly by the RetroPad, which is libretro's gamepad abstraction that uses SNES-style face buttons and PlayStation DualShock-style shoulder buttons and analog sticks. The default keybinds for the RetroPad are as follows:

RetroPad Keyboard PlayStation Xbox
Retro Dpad.png Key Arrow-Up.png
Key Arrow-Left.pngKey Arrow-Down.pngKey Arrow-Right.png
PS3 Dpad.png 360 D-pad.png
Retro A Round.png Key X.png PS3 Circle.png 360 B.png
Retro B Round.png Key Z.png PS3 Cross.png 360 A.png
Retro X Round.png Key S.png PS3 Triangle.png 360 Y.png
Retro Y Round.png Key A.png PS3 Sqaure.png 360 X.png
Retro L1.png Key Q.png PS3 L1.png 360 Left-Bumper.png
Retro R1.png Key W.png PS3 R1.png 360 Right-Bumper.png
Retro Start.png Key Enter.png PS3 Start.png 360 Start.png
Retro Select.png Key Shift.png PS3 Select.png 360 Back.png
Retro Menu.png Key F1.png PS3 Home.png 360 Guide.png

The R2, L2, R3, and L3 buttons, and left/right analog sticks are not mapped to the keyboard by default. Gamepads can be mapped manually in the menu under SettingsInputInput User 1 BindsUser 1 Bind All, but automatic configuration is possible with autoconfig profiles. On Windows, all XInput and some DirectInput gamepads will be mapped automatically when detected to the RetroPad using the included autoconfig profiles. Touchscreen controls and light gun peripherals use the mouse.

In the menu, the following buttons are used:

  • A button = Confirm
  • B button = Cancel
  • X button = Search prompt
  • Y button = Delete input bind
  • D-Pad = Navigation
  • Start button = Reset option to default
  • Select button = Show tooltip for a particular option
  • R and L buttons = Fast scrolling through files by jumping to the next letter.

By default, the keys used to navigate the menu are the following:

  • Enter = Confirm
  • Backspace = Cancel
  • Slash = Search prompt
  • Delete = Delete input bind
  • Arrow keys = Navigation
  • Spacebar = Reset option to default
  • Right Shift = Show tooltip for a particular option
  • Page Up and Page Down = Fast scrolling through files by jumping to the next letter.

If "Unified Menu Controls" are enabled under SettingsInput , then the keybinds for the RetroPad are used instead for menu control; this was the original behavior before v1.4.1.

There are also various hotkeys that are mapped by default. The most important ones to remember are the following:

  • Quit = Escape
  • Menu toggle = F1
  • Save State = F2
  • Load State = F4
  • Fullscreen toggle = F
  • Fast-Forward toggle = Spacebar
  • Screenshot = F8

All hotkey binds can be viewed and changed at SettingsInputInput Hotkey Binds. Additionally, if you map Enable Hotkeys to a keyboard key, it will require that key to be held in order to trigger any hotkeys, which may be needed for cores that use the keyboard for input. Hotkeys can also be mapped to RetroPad buttons as well.

Some people may not like having Escape key quit the program instantly and are used to having Escape bring up a menu instead. Since the hotkeys are configurable, you can change behavior of the Escape key in your config:

input_exit_emulator = "nul"
input_menu_toggle = "escape" 

The quit hotkey will be unmapped, and the menu toggle hotkey will become Escape instead of F1.

Downloading Cores

RetroArch doesn't come with emulation cores, so you have to download them yourself. However, RetroArch does have a built-in updater. So to download up to date cores, scroll down to Online Updater, and select Core Updater. RetroArch will download a list of available cores to download, and you can individually download them. To see what core does what, see this list.

If for whatever reason RetroArch can't download cores, or won't display a list of available cores for download, you can get them from the buildbot here.

Running a Game

After downloading a core you can run a game by selecting Load ContentSelect File And Detect Core and selecting your game.

If you have only have 1 core that can run the selected game, then RetroArch will automatically load that core. If you have multiple cores that are capable of running the game you'll be given the choice between them.

BIOS and System files

Some emulation cores require special system files or BIOSes. These can be downloaded here. Extract the system folder in that archive to where you installed RetroArch (the folder where the retroarch program is. retroarch.exe on Windows).

If it doesn't find the BIOS, go to SettingsDirectorySystem/BIOS Dir (or find system_directory in the config file) and make sure it points to the system folder.

Core Options, Core Specific Settings

To edit options or settings specific to a core, you must start a game with that core. After loading a game, press F1 or the Home/Guide button on your 360/PS3 controller to get back to RetroArch's menu. From there you can change Core Options, set core specific input options, cheats, and change shader settings.

Shader Settings

Shaders usually either come in single .cg files or as a group of files controlled by a .cgp preset file. If you want to use a preset, like CRT-Royale or Super-XBR, simply select Load Shader Preset under Shader Options and select a .cgp file. If you want to select individual .cg files, increase the Shader Passes and select a .cg file through Shader #0 (or #1, #2, etc.).

After selecting your shader setup, hit Apply Shader Changes.

Saves and Saving Settings

By default, RetroArch will save settings when it closes and will do so unless you put RetroArch in a directory that needs elevated privileges without running as administrator/root. Save New Config will save a new, different, config that won't be loaded the next time RetroArch starts.

It's probably a good idea to enable SaveRAM Autosave Interval (under SettingsSaving) so game saves will be written to your hard drive while RetroArch is running.

Mednafen PSX

This particular core requires some specific care. You should have the correct BIOS (if not follow the BIOS and System files section), you'll also need to make sure your game has a metadata file in the form of a .cue, .toc, .ccd, or .m3u file. The most common metadata people use is .cue, and if your PS1 game lacks a metafile, you can create one.
An easier way to get around metadata issues is to get your games from a better source. Redump PS1 games come in .bin/.cue format and work on mednafen without issue, but other sets that come in .bin/.cue/.mp3 format might need editing their cue file with Notepad with the correct filenames for them to work correctly.

Ricing RetroArch

There are 4 different menu drivers for RetroArch to choose from, RGUI, GLUI, Ozone and the default XMB. To switch between them go SettingsDriver Settings and switch Menu Driver. You'll need to restart RetroArch for changes to take effect.

You can change your wallpaper, text color settings, text size (DPI Override, GLUI only), toggle mouse support, and whether to display the boxart in the Menu Settings.

You can change RetroArch's menu font, but it'll only work for the GLUI menu driver (only on 1.2.2, newer builds have changed GLUI significantly and it no longer uses the OSD font). To change it, under Onscreen Display Settings hit OSD Message Font and select a .ttf font file.
Should be noted that Onscreen Display Settings are for the yellow popup messages that RetroArch displays and GLUI happen to use fonts from it, all of the other settings here only change the popup message.

XMB loads its font from $assets_directory/xmb/monochrome/font.ttf, so you can replace the default font .ttf with a custom one. The same can be done with the default backgrounds and icons.

Cheats

Not all cores support cheats, you can check the Libretro wiki for which cores do. By default RetroArch comes with a fairly large cheat database, so to make a new cheat file, you can find files in the cheats folder of RetroArch's install directory for reference. To enable cheats, load the game, toggle RetroArch's menu, load a cheat file in the Core Cheat Options and you'll get a list of cheats available which you can toggle. After setting your cheats, hit Apply Cheat Changes. Some cheats may require you to Restart Content to take effect.