# GemRB

<div align="left"><figure><picture><source srcset="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2Fl16ARVvaQm02NFhnDuhF%2Fgemrb.png?alt=media&#x26;token=c1be91fd-b805-4c05-a6ed-5bbc80420720" media="(prefers-color-scheme: dark)"><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2FJJ8oIijsdY1LaC4kls9h%2Fgemrb.png?alt=media&#x26;token=f9aa051d-5b43-47fa-a7ac-03f50e03a69b" alt="GemRB" width="375"></picture><figcaption></figcaption></figure></div>

GemRB - Infinity Engine Open-Source Implementation

{% embed url="<https://gemrb.org/>" %}

## Information

<table data-header-hidden><thead><tr><th width="184"></th><th></th><th data-hidden></th></tr></thead><tbody><tr><td><strong>Emulators</strong></td><td><ul><li>gemrb</li></ul></td><td></td></tr><tr><td><strong>Games Location</strong></td><td><span data-gb-custom-inline data-tag="emoji" data-code="1f4c2">📂</span>roms \ <span data-gb-custom-inline data-tag="emoji" data-code="1f4c2">📂</span> gemrb</td><td></td></tr><tr><td><strong>File extensions</strong></td><td>.auto .bg1 .bg2 .how .iwd .iwd2 .pst</td><td></td></tr></tbody></table>

## BIOS information

No BIOS required

## Controls

Controls are managed in-game.&#x20;

GemRB / Infinity Engine games are designed for mouse and keyboard controls.&#x20;

Touchscreens are compatible as mouse-replacement.&#x20;

The gameplay consists of point and click actions and shortcut keys, like the most of C-RPG and RTS games.

## Specific system information

GemRB is an open-source implementation of the Bioware's Infinity Engine. It runs Baldur's Gate, Icewind Dale and Planescape Torment games, their expansions, sequels and mods.

GemRB is in heavy development since more than 20 years, a lot of effort has been put for games compatibility though it is not yet perfect.

Here is a table showing compatibility status:

<table><thead><tr><th width="253">Games</th><th width="159" align="center">Playable</th><th width="157" align="center">Completable</th><th align="center">Polished</th></tr></thead><tbody><tr><td>Baldur's Gate</td><td align="center">YES</td><td align="center">YES</td><td align="center">YES</td></tr><tr><td>Baldur's Gate II</td><td align="center">YES</td><td align="center">YES</td><td align="center">YES</td></tr><tr><td>Icewind Dale</td><td align="center">YES</td><td align="center">YES</td><td align="center">YES</td></tr><tr><td>Icewind Dale II</td><td align="center">YES</td><td align="center"><mark style="color:red;">NO</mark></td><td align="center"><mark style="color:red;">NO</mark></td></tr><tr><td>Planescape Torment</td><td align="center">YES</td><td align="center">YES</td><td align="center"><mark style="color:red;">NO</mark></td></tr><tr><td>Any Enhanced Edition</td><td align="center"><mark style="color:red;">NO</mark></td><td align="center"><mark style="color:red;">NO</mark></td><td align="center"><mark style="color:red;">NO</mark></td></tr><tr><td>New games</td><td align="center"><mark style="color:red;">NO</mark></td><td align="center"><mark style="color:red;">NO</mark></td><td align="center"><mark style="color:red;">NO</mark></td></tr></tbody></table>

### Adding GemRB games

GemRB needs the original game files published by Bioware and Black Isle. It is not yet compatible with the Enhanced Editions by Beamdog.&#x20;

For each games, you need to create a folder where all the files of the game need to be copied.

&#x20;The folder name must contain an extension that identifies the game type you want to run and each game has its own identifier:&#x20;

<table><thead><tr><th width="474">Games</th><th align="center">Identifiers</th></tr></thead><tbody><tr><td>Baldur's Gate<br>+/- Tales of the Sword Coast</td><td align="center">bg1</td></tr><tr><td>Baldur's Gate II - Shadows of Amn<br>+/- Throne of Bhaal</td><td align="center">bg2</td></tr><tr><td>Icewind Dale (without any extension)</td><td align="center">iwd</td></tr><tr><td>Icewind Dale - Heart of Winter<br>+/- Trial of the Luremaster</td><td align="center">how</td></tr><tr><td>Icewind Dale II</td><td align="center">iwd2</td></tr><tr><td>Planescape Torment</td><td align="center">pst</td></tr><tr><td>To try game autodetection</td><td align="center">auto</td></tr></tbody></table>

For example for the game Baldur's Gate:

<div align="left"><figure><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2F8m6wqMlDCl7e5SLOGbSk%2Fgemrb_game_folder.png?alt=media&#x26;token=2a71b67d-7c9a-4a82-bdaa-b387032c4cd6" alt=""><figcaption><p>Example of GemRB game folder</p></figcaption></figure></div>

### Change game resolution

Without any widescreen mod installed, games are only compatible with their native resolution(s).

Here is the native resolutions compatibility list:

<table data-header-hidden><thead><tr><th width="329">Games</th><th>Native resolutions</th></tr></thead><tbody><tr><td>Baldur's Gate<br>+/- Tales of the Sword Coast</td><td>640x480</td></tr><tr><td>Baldur's Gate II - Shadows of Amn<br>+/- Throne of Bhaal</td><td>640x480 / 800x600 / 1024x768 / 1280x960</td></tr><tr><td>Icewind Dale (without any extension)</td><td>640x480</td></tr><tr><td>Icewind Dale - Heart of Winter<br>+/- Trial of the Luremaster</td><td>640x480 / 800x600 / 1024x768 / 1280x960</td></tr><tr><td>Icewind Dale II</td><td>800x600 / 1024x768 / 1280x960</td></tr><tr><td>Planescape Torment</td><td>640x480</td></tr></tbody></table>

To change the game resolution you need to edit the **Internal Resolution** option in RetroBat:

<div align="left"><figure><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2FAHMRdA2F3wUap49WTaN9%2Fsystem_options_en.png?alt=media&#x26;token=c0231903-d95b-4d6f-828a-b287d2856be2" alt="" width="539"><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2FAIkDmxJ7YgDbAqMKoFGA%2Fgemrb_options_en.png?alt=media&#x26;token=5bc876d2-1664-44a7-8b1c-c5feff33e6ab" alt="" width="543"><figcaption></figcaption></figure></div>

Unlike usual, you will need here to manually type the compatible resolution you want for your game, for example 800x600 in the edit box, then validate it:

<div align="left"><figure><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2FsDwUN4ELzXEgYUWBSXdX%2Fresolution_input_en.png?alt=media&#x26;token=8c30580e-1e69-4a9b-87ef-0103df17c8a3" alt="" width="563"><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2FI34FP5vCiNDQb9XhNt8s%2Fgemrb_resolution_en.png?alt=media&#x26;token=b720437b-e9b0-4387-9b9b-eb52cd1de778" alt="" width="545"><figcaption></figcaption></figure></div>

If you leave the edit box empty, it will default to the lower game's native resolution.

### Widescreen Mod

For a more modern widescreen resolution you will need to apply a widescreen patch to your game. Depending on the game, it may require also additional mods for the game interface to fit the screen.

You can download the widescreen mods [here](https://www.gibberlings3.net/mods/tools/widescreen/).

Follow the instruction of the mod then repeat the step above to change the resolution to the one you specified when applying the widescreen mod.

{% hint style="info" %}
If this resolution is the same than your desktop's, simply type "desktop" instead of the full resolution.
{% endhint %}

<div align="left"><figure><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2FjkbUuj2eztwDZQIIFxjW%2Fgemrb_desktop_en.png?alt=media&#x26;token=01f27513-722f-4691-a9b3-c67a4547153d" alt="" width="542"><figcaption></figcaption></figure></div>
