Updated FAQ

Added 2 additional issues and changed the layout.
This commit is contained in:
Bulldozer 2025-02-03 19:55:20 +01:00 committed by GitHub
parent e37a5f4d06
commit e31c64e42e
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -1,11 +1,14 @@
# Frequently Asked Questions # 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. 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: If you have an **NVIDIA** or **AMD** GPU, you can try these commands:
- **For NVIDIA GPUs:** - **For NVIDIA GPUs:**
@ -20,13 +23,13 @@ If you have an **NVIDIA** or **AMD** GPU, you can try these commands:
- **For AMD GPUs:** - **For AMD GPUs:**
Open the **AMD Radeon Software** and manually adjust brightness or SDR settings to reset them. 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. 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. 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 youre using Linux with Xorg, try this command to reset gamma settings: If youre using Linux with Xorg, try this command to reset gamma settings:
```bash ```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.) (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: 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**. 1. Right-click on your desktop and select **Display settings**.
2. Scroll down to **Display resolution** and change it to a different setting. 2. Scroll down to **Display resolution** and change it to a different setting.
3. Revert it back to your original resolution. 3. Revert it back to your original resolution.
This forces Windows to refresh display settings, which may restore brightness. 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>