Winlator Settings RUN Good old Games (GOG)

Running GOG Games on Android using Winlator is generally very smooth because the game is lightweight (based on the GameMaker engine). However, to avoid graphical glitches or black screens, you need the correct compatibility settings. Below is the recommended configuration guide. ## 1. Container Settings (General) Create a new container or edit your existing one with the following parameters: * *Screen Size (Resolution)*: Select **800x600** or **640x480**. * *Reason*: Undertale was designed for a 4:3 aspect ratio. Using a lower resolution ensures **pixel-perfect** visuals and better performance on mobile devices. * *Graphics Driver*: * Select **Turnip (Zink)** if you are using a **Snapdragon** chipset. * Select **VirGL** if you are using **MediaTek**, **Exynos**, or **Mali** GPUs. * *DX Wrapper*: Choose **WineD3D** or **Default**. * *Important*: Do not use **DXVK** for this game. Undertale is a 2D game that relies on older DirectX versions. Using **WineD3D** prevents the common "black screen" issue. * *Audio Driver*: **PulseAudio**. ## 2. Advanced Settings If you experience crashes or the game refuses to open, adjust the compatibility presets: * *Box86 Preset*: Set to **Compatibility**. * *Box64 Preset*: Set to **Compatibility**. * *System Environment Variables*: * Make sure `MESA_LOADER_DRIVER_OVERRIDE` is set to **zink** (specifically for Snapdragon users). ## 3. Input Controls (Key Mapping) Undertale requires keyboard inputs. You must configure Winlator's **On-Screen Controls** to map virtual buttons to specific PC keys. **Recommended Mapping:** | Virtual Button | PC Keyboard Key | In-Game Action | | :--- | :--- | :--- | | **D-Pad** | **Arrow Keys** | Movement / Dodge | | **Button A** | **Z** or **Enter** | Interact / Confirm | | **Button B** | **X** | Cancel / Skip Text | | **Button C** | **C** or **Ctrl** | Open Menu | ## Troubleshooting Common Issues * *Issue: Black Screen but Audio is Playing* * **Fix**: Switch the **DX Wrapper** to **WineD3D** and ensure the resolution is set to **640x480**. * *Issue: Game Runs Too Fast (Speedup)* * **Fix**: This happens on 120Hz screens. Go to Container Settings -> **FPS Limit** and set it to **30** or **60**.