Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision		 Previous revision
systems:easyrpg [2021/05/30 15:24] – ↷ Page moved from emulators:easyrpg to systems:easyrpg igno2ksystems:easyrpg [2021/12/16 09:57] (current) – [Compatibility] Removed mention of Touhou Sequelroku's music based combo softlocking, as it is not an issue with 7.0. fishou
Line 1: Line 1:
 +<WRAP group>
 +<WRAP round box twothirds column>
 +{{ https://raw.githubusercontent.com/fabricecaruso/es-theme-carbon/master/art/logos/easyrpg.svg?nolink&400 }}
 +
 ====== EasyRPG ====== ====== EasyRPG ======
  
 EasyRPG is a free, open source engine to create RPG games, aiming to be also compatible with all RPG Maker 2000 and RPG Maker 2003 games. EasyRPG is a free, open source engine to create RPG games, aiming to be also compatible with all RPG Maker 2000 and RPG Maker 2003 games.
  
-RPG Maker 2000/2003 games tend to have mechanics and visuals similar to 16 bits JRPGs, though custom scripts can be made by the creators to modify how the game feels and looks.+RPG Maker 2000/2003 games tend to have mechanics and visuals similar to 16-bit JRPGs, though custom scripts can be made by the creators to modify how the game feels and looks. 
 + 
 +For more information about EasyRPG itself, check out its [[https://easyrpg.org/|website]]. 
 + 
 +This system scrapes metadata for the "easyrpg" group(s) and loads the ''easyrpg'' set from the currently selected theme, if available. 
 +</WRAP> 
 + 
 +<WRAP third column> 
 +{{ https://raw.githubusercontent.com/fabricecaruso/es-theme-carbon/master/art/consoles/easyrpg.png?nolink&350 |}} 
 +</WRAP> 
 +</WRAP> 
 + 
 +==== Quick reference ==== 
 + 
 +  * **Accepted ROM formats:** ''.easyrpg'', ''.squashfs'', ''.zip'' 
 +  * **Folder:** ''/userdata/roms/easyrpg'' 
 + 
 +^ Emulators ^ 
 +| [[#easyrpg|EasyRPG]] | 
 +| [[#libretro:_easyrpg|libretro: EasyRPG]] | 
 + 
 +===== BIOS =====
  
-For more informations about EasyRPG itself, the website is [[https://easyrpg.org/|here]].+No EasyRPG emulator in Batocera needs a BIOS file to run.
  
-===== Directories =====+===== Game files =====
  
-  * ''/userdata/roms/easyrpg'' : For the games +Place your EasyRPG game files in ''/userdata/roms/easyrpg''.
-  * ''/userdata/saves/easyrpg'' : For the saves+
  
-===== Game structure =====+The EasyRPG engine supports RPG Maker 2000 and 2003 games, you have to put the game's entire folder inside, and add ''.easyrpg'' to its name the game folder is the one containing the ''RPG_RT.ldb'' file.
  
 The games must be put inside ''/userdata/roms/easyrpg'' and respect some rules: The games must be put inside ''/userdata/roms/easyrpg'' and respect some rules:
Line 18: Line 42:
   * The folder of the game's name must end with ''.easyrpg''   * The folder of the game's name must end with ''.easyrpg''
   * The folder of the game has to be an RPG Maker 2000, 2003, or EasyRPG game folder correctly structured((Sometimes, games will be distributed in a slightly different way, in which case, you will need to adapt it)).   * The folder of the game has to be an RPG Maker 2000, 2003, or EasyRPG game folder correctly structured((Sometimes, games will be distributed in a slightly different way, in which case, you will need to adapt it)).
-    * The structure of RPG Maker 2000/2003 or EasyRPG games is mostly the same : a main folder, which will be called ''game.easyrpg'', and inside it several sub-folders (including Title, Music, System, …), as well as a few Map000x.lmu files, an RPG_RT.ldb and RPG_RT.lmt (other files can also be there, typically an RPG_RT.ini and a RPG_RT.exe((This .exe file can be used to gather some data by EasyRPG, however it won't be executed)))+    * The structure of RPG Maker 2000/2003 or EasyRPG games is mostly the same: a main folder, which will be called ''game.easyrpg'', and inside it several sub-folders (including Title, Music, System, …), as well as a few ''Map000x.lmu'' files, an ''RPG_RT.ldb'' and ''RPG_RT.lmt'' (other files can also be there, typically an ''RPG_RT.ini'' and a ''RPG_RT.exe'' (This ''.exe'' file can be used to gather some data by EasyRPG, however it won't be executed)).
  
-The saves of the games will be put in ''/userdata/saves/easyrpg/'', inside a folder with the same name as the game.+New to Batocera **v33**: ZIP file support!
  
 ==== Advanced structure information ==== ==== Advanced structure information ====
Line 52: Line 76:
 Sometimes, games will have strange extensions to their filenames, while their format isn't directly exploitable, they can technically be converted to more common formats. Sometimes, games will have strange extensions to their filenames, while their format isn't directly exploitable, they can technically be converted to more common formats.
  
-  * lmu, lmt, ldb and lsd : can be converted to .xml files +  * ''.lmu'', ''.lmt'', ''.ldb'' and ''.lsd'': can be converted to ''.xml'' files 
-  * xyz : can be converted to .png+  * ''.xyz'': can be converted to ''.png''
  
 Source: [[https://easyrpg.org/tools/|the Tools page of EasyRPG]] Source: [[https://easyrpg.org/tools/|the Tools page of EasyRPG]]
  
-===== Controls =====+===== Emulators =====
  
-EasyRPG only uses a few controls, they are as follow : +==== EasyRPG ====
  
-  * **A** : Accept/Talk (may be referred as ''Enter'' in the games) +=== EasyRPG configuration ===
-  * **B** : Go back/Open Menu (may be referred as ''Escape'' in the games) +
-  * **L** : Shift (may be referred as ''Shift'' in the games, some games use it for various purposes at times; in ''Test-play'' it is also used to skip the text "typewriting" effect) +
-  * **D-Pad/Left stick** : Move +
-  * **R** : Walk through walls + Disable random encounters (Only used in ''Test-play'' mode)+
  
-The following hotkey combos work as well in the standalone version : +Standardized features available to all cores of this emulator: ''easyrpg.videomode''
  
-  * **Hotkey+Start** : Quit the game +^ ES setting name ''batocera.conf_key'' ^ Description => ES option ''key_value'' ^ 
-  * **Hotkey+A** : Restart the game (must be held down 2 seconds) +^ Settings that apply to all cores of this emulator || 
-  * **Hotkey+L** : Take a screenshot +| **TEST PLAY ''easyrpg.testplay''** | Enable the debug menu and the walk-through-walls button\\ => Off ''0'', On ''1''. | 
-  * **Hotkey+Dpad right** : Fast-Forward +| **GAME REGION (ENCODING) ''easyrpg.encoding''** | Needed by some games to use special characters\\ => Autodetect (Recommended) ''autodetect'', European (Western) ''1252'', European (Cent/East) [W-1250] ''1250'', Japanese [Shift-JIS] ''932'', Cyrillic [Windows-1251] ''1251'', Korean ''949'', Chinese (Simplified) ''936'', Chinese (Traditional) [Big5] ''950'', Greek ''1253'', Turkish ''1254'', Baltic ''1257''. | 
-  * **Hotkey+B** : Open debug menu (Only used in ''Test-play'' mode((The debug menu can also be accessed in the pause menu when ''Test-play'' is enabled))) + 
-  * **Hotkey+Y** : Open save menu (Only used in ''Test-play'' mode)+==== RetroArch ==== 
 + 
 +[[https://docs.libretro.com/|RetroArch]] (formerly SSNES), is a ubiquitous frontend that can run multiple "cores", which are essentially the emulators themselves. The most common cores use the [[https://www.libretro.com/|libretro]] API, so that's why cores run in RetroArch in Batocera are referred to as "libretro: (core name)". RetroArch aims to unify the feature set of all libretro cores and offer a universal, familiar interface independent of platform. 
 + 
 +=== RetroArch configuration === 
 + 
 +RetroArch offers a **Quick Menu** accessed by pressing ''[HOTKEY]'' + {{:wiki:south.png?nolink&20|South button (B SNES)}} which can be used to alter various things like [[:advanced_retroarch_settings|RetroArch and core options]], and [[:remapping_controls_per_emulator|controller mapping]]. Most RetroArch related settings can be altered from Batocera's EmulationStation. 
 + 
 +Standardized features available to all libretro cores: ''easyrpg.videomode'', ''easyrpg.ratio'', ''easyrpg.smooth'', ''easyrpg.shaders'', ''easyrpg.pixel_perfect'', ''easyrpg.decoration'', ''easyrpg.game_translation'' 
 + 
 +^ ES setting name ''batocera.conf_key'' ^ Description => ES option ''key_value'' ^ 
 +^ Settings that apply to all cores of this emulator || 
 +| **GRAPHICS BACKEND ''easyrpg.gfxbackend''** | Choose your graphics rendering\\ => OpenGL ''opengl'', Vulkan ''vulkan''. | 
 +| **AUDIO LATENCY ''easyrpg.audio_latency''** | Audio latency in milliseconds, turn it up if you hear crackles\\ => 256 ''256'', 192 ''192'', 128 ''128'', 64 ''64'', 32 ''32'', 16 ''16'', 8 ''8''. | 
 +| **THREADED VIDEO ''easyrpg.video_threaded''** | Improves performance at the cost of latency and more video stuttering. Use only if full speed cannot be obtained otherwise.\\ => On ''true'', Off ''false''. | 
 + 
 +=== libretro: easyrpg === 
 + 
 +== libretro: easyrpg configuration ==
  
 ===== Test-play mode ===== ===== Test-play mode =====
Line 95: Line 133:
  
 ''Call Event'' can be used to trigger various events occurring in game. ''Call Event'' can be used to trigger various events occurring in game.
 +
 +===== Controls =====
 +
 +EasyRPG only uses a few controls, they are as follow : 
 +
 +  * **A** : Accept/Talk (may be referred as ''Enter'' in the games)
 +  * **B** : Go back/Open Menu (may be referred as ''Escape'' in the games)
 +  * **L** : Shift (may be referred as ''Shift'' in the games, some games use it for various purposes at times; in ''Test-play'' it is also used to skip the text "typewriting" effect)
 +  * **D-Pad/Left stick** : Move
 +  * **R** : Walk through walls + Disable random encounters (Only used in ''Test-play'' mode)
 +
 +The following hotkey combos work as well in the standalone version : 
 +
 +  * **Hotkey+Start** : Quit the game
 +  * **Hotkey+A** : Restart the game (must be held down 2 seconds)
 +  * **Hotkey+L** : Take a screenshot
 +  * **Hotkey+Dpad right** : Fast-Forward
 +  * **Hotkey+B** : Open debug menu (Only used in ''Test-play'' mode((The debug menu can also be accessed in the pause menu when ''Test-play'' is enabled)))
 +  * **Hotkey+Y** : Open save menu (Only used in ''Test-play'' mode)
 +
 +Here are the default EasyRPG's controls shown on a [[:configure_a_controller|Batocera Retropad]]:
 +
 +{{ https://raw.githubusercontent.com/batocera-linux/batocera-controller-overlays/master/solid-4k/easyrpg.png }}
  
 ===== Known Issues ===== ===== Known Issues =====
Line 137: Line 198:
   * **Shift-JIS** : 932   * **Shift-JIS** : 932
   * **Big5** : 950   * **Big5** : 950
 +
 ==== Compatibility ==== ==== Compatibility ====
  
 There are a few known compatibility issues with EasyRPG at the time. There are a few known compatibility issues with EasyRPG at the time.
  
-  * Videos files cannot be played inside EasyRPG, multiple games are reliant on this (**Ib** for exemple)+  * Videos files cannot be played inside EasyRPG, multiple games are reliant on this (**Ib** for example) 
 + 
 +===== Troubleshooting ===== 
 + 
 +==== Further troubleshooting ====
  
-Specific game issues:+For further troubleshooting, refer to the [[:support|generic support pages]].
  
-  * **Return of Touhou Mother** (Also known as **Touhou Sequelroku**) : The music-based combo system doesn't work properly, softlocking the game during battles. 
  • systems/easyrpg.1622388293.txt.gz
  • Last modified: 5 years ago
  • by igno2k