From e31c64e42ee11f5cb16c4e1d9a44b87f0c50b829 Mon Sep 17 00:00:00 2001
From: Bulldozer <bulldozerecske@gmail.com>
Date: Mon, 3 Feb 2025 19:55:20 +0100
Subject: [PATCH] Updated FAQ

Added 2 additional issues and changed the layout.
---
 docs/faq.md | 52 +++++++++++++++++++++++++++++++++++++++++++++-------
 1 file changed, 45 insertions(+), 7 deletions(-)

diff --git a/docs/faq.md b/docs/faq.md
index 0304e505..82895a25 100644
--- a/docs/faq.md
+++ b/docs/faq.md
@@ -1,11 +1,14 @@
 # Frequently Asked Questions
 
-## 1. My OpenMoHAA client has crashed, leaving the desktop brightened up. How can I fix this without restarting the computer?
+<details>
+<summary>My OpenMoHAA client has crashed, leaving the desktop brightened up. How can I fix this without restarting the computer?</summary>
 
-### 1.1 Lock and Unlock Your Screen (Windows+L)
+## Try one of the following options:
+  
+### 1. Lock and Unlock Your Screen (Windows+L)
 Simply pressing **Win+L** to lock your screen and then logging back in can sometimes reset the brightness to its previous state.
 
-### 1.2. Command Line Fix (Windows)
+### 2. Command Line Fix (Windows)
 If you have an **NVIDIA** or **AMD** GPU, you can try these commands:
 
 - **For NVIDIA GPUs:**
@@ -20,13 +23,13 @@ If you have an **NVIDIA** or **AMD** GPU, you can try these commands:
 - **For AMD GPUs:**
   Open the **AMD Radeon Software** and manually adjust brightness or SDR settings to reset them.
 
-### 1.3. Use a Third-Party Tool to Reset Gamma & Brightness
+### 3. Use a Third-Party Tool to Reset Gamma & Brightness
 Programs like **Gamma Panel** or **f.lux** can help restore modified brightness and gamma settings quickly.
 
-### 1.4. Restart the Graphics Driver (Windows)
+### 4. Restart the Graphics Driver (Windows)
 Press **Win + Ctrl + Shift + B** to restart the graphics driver without rebooting your PC. Your screen will briefly go black, then reset.
 
-### 1.5. Reset Gamma via Xrandr (Linux, Xorg Users)
+### 5. Reset Gamma via Xrandr (Linux, Xorg Users)
 If you’re using Linux with Xorg, try this command to reset gamma settings:
 
 ```bash
@@ -35,10 +38,45 @@ xrandr --output eDP-1 --gamma 1:1:1
 
 (Replace `eDP-1` with the correct display name, which you can find by running `xrandr` in the terminal.)
 
-### 1.6. Changing Display Mode in Windows (Alternative)
+### 6. Changing Display Mode in Windows (Alternative)
 If none of the above solutions work, you can manually reset brightness by changing the display mode:
 1. Right-click on your desktop and select **Display settings**.
 2. Scroll down to **Display resolution** and change it to a different setting.
 3. Revert it back to your original resolution.
 
 This forces Windows to refresh display settings, which may restore brightness.
+</details>
+
+---
+
+<details>
+<summary>I am using a custom map/mod, and I experience glitches that do not occur in the original game. What should I do?</summary>
+
+### 1. Check game file precedences:
+As OpenMoHAA has MultiUser Support (on Windows, user game data is stored in `%APPDATA%\openmohaa`), custom files in this directory ovveride existing files in the game installation folder.
+
+|Example|
+|-|
+| A custom `grenzuebergang_KE.pk3` (placed in the user game data folder) contains a `scripts/effects.shader` file and it does not declare `bh_wood_puff_simple`. As a result, bullet impact effect has no texture.
+However, if `grenzuebergang_KE.pk3` is placed in the game installation folder (`MOHAA/main` or `/mainta` or `/maintt`, where the base `pak*.pk3` files are located) original files take precedence over custom files as they follow the alphabetical order of file naming.
+`Pak1.pk3` contains the original `scripts/effects.shader` where the impact effect is declared; therefore, the player does not experience any issue, as the original file is "loaded" after the custom file. |
+
+### 2. Create a new issue:
+If changing the file precedences has no effect on the glitch you discovered, you have probably found a new bug in the OpenMoHAA engine, so please <a href="https://github.com/openmoh/openmohaa/issues/new/choose">create a new issue</a> for the developers.
+</details>
+
+---
+
+<details>
+<summary>I cannot set my screen resolution in the Options/Video menu. How can I change it?</summary>
+
+### 1. Edit `omconfig.cfg`
+
+If they do not exist, add the following cvars to your OpenMoHAA config file that is located in the user game data folder (on Windows,  `%APPDATA%\openmohaa\main` or `mainta` or `maintt` `\configs\omconfig.cfg`):
+
+> seta r_mode "-1"<br/>
+> seta r_customwidth "1920"<br/>
+> seta r_customheight "1080"
+
+Change the width and height accordingly.
+</details>