EditRomCollectionLaunchGames
To edit your Rom Collections just fade in the options menu (pressing LEFT in vertical game lists and UP in horizontal game lists) and select "Edit Rom Collection". You can edit all your Rom Collections in this dialog and changes to all Rom Collections will be saved if you select "Save changes".
With the Rom Collection selector you can select which Rom Collection you want to edit. All controls in the dialog will be updated with the data of the selected Rom Collection.
The command that you specify as "Emulator cmd" will be invoked when you launch a game. In this dialog you can directly navigate to the executable.
Android only: On Android devices emulator params might become quite long and tricky to enter. Thats why RCB supports emulator auto configuration. There is a file called "emu_autoconfig.xml" where you can add emulator arguments for all emulators and platforms. There is already a big number of emulators covered in this file, so chances are good that the emulator of your choice is already available. By default this file will be copied to RCBs userdata directory (XBMC/userdata/addon_data/script.games.rom.collection.browser) but you can specify a new path via addon settings. RCB also scans your system to check if the emulators available in autoconfig are installed on your system.
When selecting Emulator Cmd on Android devices you will be offered a list of available emulators. Just choose an emulator out of this list and emulator cmd and params will be filled in automatically.
The params that are passed to the emulator. You can use the following placeholders in your commands:
%ROM% - will be replaced with the current file name (complete path)
%ROMFILE% - will be replaced with the rom filename without path (MyGame.smc)
%ROMNAME% - will be replaced with the rom filename without path and extension (MyGame)
%GAME% - will be replaced with the name of the game that you see while browsing games in RCB (e.g. My Game)
%GAMECMD% - will be replaced with the value that you specified as game specific command for the selected game. Replaced with "" if no game specific command is available.
%ASKNUM% - select numbers from 0-9 (specially build for zsnes savestate handling but may be useful in other scenarios - who knows)
%ASKTEXT% - will launch the XBMC keyboard and then replaced with the text that you enter (useful for playing around with special settings like selecting graphic or sound drivers etc. - just edit the game command on every single game launch)
%I% - will be replaced with the zero-based index of the current rom file (in multi rom scenario).
If the emulator supports multiple rom files (like uae) you can use {} for repeating parameters. In a command like "uae {-%I% "%ROM%"}" the part in the {} brackets will be repeated for any disk file of the game. For example if you have an amiga game (MyGame) that consists of 2 disk files the uae command at runtime will be:
uae -0 "MyGame_Disk1.adf" -1 "MyGame_Disk2.adf".
If set to "True" RCB will try to quit XBMC before starting the emulator. After exiting the emulator you will return to XBMC. If set to "False" the emulator will be launched while XBMC is running in the background.
See Launch games in solo mode for details.
Popen is just another way to launch emulators from XBMC. If you have trouble with launching emulators from RCB it is worth to try if this option helps to solve your issues.
If RCB detects zip or 7z-files while launching games, it will by default extract these files and offer a selection of all available roms inside the compressed file. Some emulators support or require to get the compressed file unextracted (like MAME). In this case just set "Do not extract zip files" to "True".
The path to the savestate files of the selected Rom Collection. See Launching savestates for more information on how to configure launching savestates.
The file mask that will be used to search for the savestate files of the launched game in the savestate directory.
You can use all placeholders in savestate file mask that are available in emulator params.
The parameters that will be passed to the emulator when launching savestates.
You can use all placeholders in savestate file mask that are available in emulator params. Additionally you can use %STATEFILE% for the complete path to the statefile.
You can enter any command that should be executed before launching the emulator.
You can enter any command that should be executed after launching the emulator.
If set to "True" RCB will create a local copy of your rom files at "userdata/addon_data/script.games.rom.collection.browser/tmp". This might be useful if you have issues with launching roms from external sources. The copied files will be deleted on next run.
If set to "True" RCB will use the builtin game launcher RetroPlayer to launch the game. All config options used with external emulators will be disabled when you enable "Use RetroPlayer".
RetroPlayer knows several different gameclients (aka cores) per system. If you leave this option blank, RetroPlayer will ask you which gameclient to use on every run. If you want to launch all games of the selected system with the same gameclient you can select it here. Note: you can overwrite the gameclient per game in Context menu.