This commit is contained in:
etjanster 2025-01-20 09:36:00 +01:00
parent 3c74b2c32f
commit 61a21bfd36
2 changed files with 37 additions and 7 deletions

View file

@ -4,7 +4,12 @@
This guide works for both the `ScummVM RetroArch Core` and `ScummVM-SA` This guide works for both the `ScummVM RetroArch Core` and `ScummVM-SA`
**Note:**
`ScummVM-SA` is not implemented in RetroDECK yet. But will be available in a future version.
### ScummVM Links: ### ScummVM Links:
[ScummVM Guides](https://docs.scummvm.org/en/v2.7.1/) [ScummVM Guides](https://docs.scummvm.org/en/v2.7.1/)
[ScummVM Game Compatibility and ID List](https://www.scummvm.org/compatibility) [ScummVM Game Compatibility and ID List](https://www.scummvm.org/compatibility)
@ -17,38 +22,63 @@ This guide works for both the `ScummVM RetroArch Core` and `ScummVM-SA`
### Where to put the games? ### Where to put the games?
ScummVM games should be put into the `retrodeck/roms/scummvm/` directory.<br>
ScummVM games should be put into the `retrodeck/roms/scummvm/` directory.
## What file formats are supported?
```
.scummvm
```
### Does ScummVM require BIOS or Firmware? ### Does ScummVM require BIOS or Firmware?
No No
## How to: Get games to show up inside the ES-DE interface
**Example:** <br> ## Folder structure
| Type | Folder | Comment |
| :---: | :---: | :---: |
| ROMs Folder |`retrodeck/roms/scummvm/` | |
## How-to: Create .scummvm files that run in ES-DE
**Example:**
In this example we got a game we want to add: `Beneath a Steel Sky` In this example we got a game we want to add: `Beneath a Steel Sky`
### Step 1: Add the game ### Step 1: Add the game
Move the uncompressed game into the `retrodeck/roms/scummvm/` folder.<br> Move the uncompressed game into the `retrodeck/roms/scummvm/` folder.
The result should be: `retrodeck/roms/scummvm/Beneath a Steel Sky/` The result should be: `retrodeck/roms/scummvm/Beneath a Steel Sky/`
### Step 2: Check the ScummVM ID of the game ### Step 2: Check the ScummVM ID of the game
<img src="../../../wiki_images/emulators/scummvm/scummvm-sky.png"> <img src="../../../wiki_images/emulators/scummvm/scummvm-sky.png">
Go into [ScummVM Game Compatibility and ID List](https://www.scummvm.org/compatibility)<br> Go into [ScummVM Game Compatibility and ID List](https://www.scummvm.org/compatibility)
Search for `Beneath a Steel Sky` make a note of the ScummVM ID in this case called: `sky` Search for `Beneath a Steel Sky` make a note of the ScummVM ID in this case called: `sky`
### Step 3: Create the .scummvm file ### Step 3: Create the .scummvm file
- The `.scummvm` file starts as a empty textfile that needs to be created in each game you want to adds directory. - The `.scummvm` file starts as a empty textfile that needs to be created in each game you want to adds directory.
- It should be named `<ScummVM_ID>.scummvm` - It should be named `<ScummVM_ID>.scummvm`
- In our example the file will be called `sky.scummvm` and should be created in `retrodeck/roms/scummvm/Beneath a Steel Sky/` - In our example the file will be called `sky.scummvm` and should be created in `retrodeck/roms/scummvm/Beneath a Steel Sky/`
The end result should look like:<br> The end result should look like:
`retrodeck/roms/scummvm/Beneath a Steel Sky/sky.scummvm` `retrodeck/roms/scummvm/Beneath a Steel Sky/sky.scummvm`
### Step 4: Open the .scummvm file and add the ScummVM_ID ### Step 4: Open the .scummvm file and add the ScummVM_ID
Open up the empty `sky.scummvm` file and just type in the `<ScummVM_ID>` in the first row of the file and save in this example `sky`. Make sure you don't add any spaces or linebreaks and the file should just contain the word `sky`.
Open up the empty `sky.scummvm` file and just type in the `<ScummVM_ID>` in the first row of the file and save in this example `sky`.
Make sure you don't add any spaces or linebreaks and the file should just contain the word `sky`.
### Step 5: The game should now run ### Step 5: The game should now run
The game should now be added to the ES-DE interface from the `retrodeck/roms/scummvm/Beneath a Steel Sky/sky.scummvm` file you just created and can be played after you reload RetroDECK from the Configurator or re-launch the application. The game should now be added to the ES-DE interface from the `retrodeck/roms/scummvm/Beneath a Steel Sky/sky.scummvm` file you just created and can be played after you reload RetroDECK from the Configurator or re-launch the application.