Amiga machines have been separated into 4 systems:
OCS/ECS machines of Amiga 1000 unitl the last Amiga 600.AGA machines, starting from Amiga 1200.Here is a list with explanations of the differents file formats for Amiga systems:
*.adf), the most popular disk format (cannot integrate disk protections). Can be zipped or 7-zipped.*.ipf), most commonly used by non-intro game copies (may incorporate disk protections). Can be zipped.*.lha/lzh/lzx, *.zip), the well-known format for hard disk games. WHD folders are recognized using the *.slave file inside the folder, but it is strongly recommended to keep them packaged as lha or zip. Unpacked WHDs are not faster and even worse, they can make the frontend super slow..hd extension. Rarely used. For true Amiga fans who have backed up their machine's hard drive. Can be zipped, but not recommended.*.hdf), Disk image in a single file. Can be zipped.*.rp9), Amiga Forever's all-in-one packages.*.iso), CD copies.*.bin / *.cue), CD copies. Can have 1 cue file and one or multiple bin files.When you play from zipped/7-zipped files, the system tries to identify the type of rom by looking for specific extensions inside the archive.
ADF/IPF/BIN/ISO extensions are fast to identify.WHD is fast, but LHA should be the preferred option.HDDFS may take longer to identify and may result in false interpretations. If you use HDDFS, leave it as normal files and folders and end the root folder name with .hd for easy identification.F12.F12, go down to Quit and validate with ENTER.HK + B.HK + START.The configuration overrides on Libretro cores are configuration overrides. Here, only Amiberry will be dealt with.
As seen above, a huge amount of work has been done to automatically configure emulators according to what you want to boot.
Recalbox generates one configuration per system. However, in certain situations, you can override these configurations.
The configuration files are generated in /tmp/amiga/conf. The most important is the uaeconfig.uae file in which you will find all the keys defining the machine, the hard disks, etc.
If you are curious, you can have a look at the Amiberry documentation.
You have 2 ways of overriding the configurations with an example for each case:
To do this, you need to create a file in the /recalbox/share/system/configs/amiberry/ folder. This file will be named according to the system:
amiga600.uae to override the Amiga 600amiga1200.uae to override the Amiga 1200amigacd32.uae to override the Amiga CD32amigacdtv.uae to override the Amiga CDTVFor example, to disable the LED display in the bottom right-hand corner, you can use this line:
show_leds=false
To do this, you need to create a file in the roms folder where the game to be overrided is located, ending with the .uae extension.
For example, in your /recalbox/share/roms/amiga1200 folder, for the game Aladdin (AGA).ipf, you can create the file Aladdin (AGA).uae and place your overrides in it.
Overrides are handled as follows:
Copy them to your Amiga roms folder corresponding to the system.
Multiple discs are automatically loaded, up to 4 discs for games using the correct nomenclature such as (Disk 1 of X).
WHD games are a little more difficult to use, but nothing too complicated.
Unzip your WHDLoad game, delete the .info file at the same level as the folder, and copy only this folder to your roms folder (you can use subfolders if you wish, for example /recalbox/share/roms/amiga1200/ShootEmUp).
You will need a .uae file at the same level as the folder of the same name. There are two ways of doing this:
For the second method, there is a little utility called UCG. This will allow you to generate a UAE configuration.
In the uae file, you can define ;hardware, ;controls and ;graphics blocks to replace the standard emulator configuration.
The customised parts of the configuration in the .uae file will only be used if they start with the correct block name: ;hardware, ;controls or ;graphics.
This can allow you, for example, to use two joysticks, to have a very specific hardware configuration for certain games that are a bit special/capricious or to define a custom resolution.
You can also delete everything in the .uae file and the basic emulator configuration will then be used.
Copy this (corresponding to the Amiga model you wish to use) next to the WHDL game folder and rename it exactly as the game folder (keeping the .uae extension). For example, if your game's folder name is Rick Dangerous, your uae file should be named Rick Dangerous.uae and be at the same level as the folder.
The standard startup sequence generated for WHDL games is WHDload game.slave Preload (in WHDL/S/Startup-Sequence). But a few WHDL games (such as History Line: 1914-1918) may require additional parameters at startup or they will crash.
You can add a second file (completely optional) containing these additional parameters. Taking History Line as an example, you would have :
CUSTOM1=1)The game will be launched at this point.
Here is a small list of games that require additional parameters.
| Game | Extra parameter(s) / File contents |
|---|---|
| HistoryLine 1914-1918 | CUSTOM1=1 for the intro, CUSTOM1=2 for the game. |
| The Settlers / Die Siedlers | CUSTOM1=1 to skip the intro. |