> For the complete documentation index, see [llms.txt](https://darkgroom.gitbook.io/darkgroom-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://darkgroom.gitbook.io/darkgroom-docs/docs/troubleshooting.md). # Troubleshooting ### Client problems {% hint style="info" %} Always run the game and its tools with **administrator** privileges. This includes `Dark Groom.exe`, `Setup.exe`, and `Dark Groom Patcher.exe`. {% endhint %} To improve client stability and avoid common issues, try the following steps: * On Windows 10 or newer, right‑click `Dark Groom.exe` and set Compatibility to Windows 7, or on older systems use Windows XP Service Pack 3. * Right‑click `Dark Groom.exe` and enable the option to run it as Administrator. * Do the same for `Dark Groom Patcher.exe`, making sure it also runs as Administrator. * Use `Dark Groom Patcher.exe` to download and apply the most recent patch before playing. * Install the game in a custom folder such as `C:\Games\` instead of the default Program Files directory. * Temporarily turn off antivirus and firewall software while installing or patching, especially if you use tools like Avast or McAfee. * If you have Warsaw (a banking security program common in Brazil), uninstall it, as it can interfere with the client. ### White Map Client Issue If the game loads but you see white maps, adjust the dgVoodoo settings and a specific library file: 1. open `dgVoodooCpl.exe` then go to DirectX tab then click 'Disable and passthru to real DirectX' then click Apply. 2. find  `dbghelp.dll`  in that folder, rename it to `dbghelp_old.dll` . Then try to launch **`Dark Groom.exe`** ### My antivirus recognizes **`Dark Groom.exe`** and **`Dark Groom Patcher.exe`** as insecure software or virus. Some security tools can misidentify components of the client, particularly those related to anti‑cheat or anti‑bot systems, as malware or unsafe programs. Add the game directory and both `Dark Groom.exe` and `Dark Groom Patcher.exe` to your antivirus exclusion or exception list so they are not blocked or removed. ### Gepard Shield is stuck on the loading screen and is not showing any error messages. Run Setup.exe from the Dark Groom folder and try different options: * Choose the Resolution and Graphic Device. * Remove checkbox from **Play in Full Screen**. * Deactivate sound. * Select checkbox **Delete all Ragnarok-related settings (factory reset)**. ### There is a Gepard Shield error stating that illegal software is being used. **Image** ![Gepard error code 50](/files/xAP2GlBXOTSAHEfVlopk) **Message** ``` Gepard::IG Code 50::3 Macro tool has been detected! Press OK and Gepard will open browser for downloading macro removal tool ``` **Solution** Some mouse and keyboard software may be identified as prohibited macros or other types of unauthorized software. In order to enter a game, it may be necessary to close this software. The list of approved software is constantly updated and added to the whitelist. ### I got an error: Gepard can't validate license on the server. **Image** ![Gepard error code 1](/files/c9fAuWAJM7TVwemZwAvJ) **Message** ``` Gepard::GT Code 1 Gepard can't validate license on the server! If you use firewall, you have to allow connection to license server. ``` **Solution** * Check your internet connection * Add game client folder, **`Dark Groom.exe`**, or **`Dark Groom Patcher.exe`** as an exception for your antivirus and firewall **SEA Players**: Some ISP providers in this region block certain ports by default. These variables are used by Gepard for their firewall licensing server. 1. Manually unblock or allow `Port 6700` 2. Verify the following IPs are unblocked, or set a rule to unblock: `185.61.138.117` and `139.99.40.25` ### There are low FPS or freezes occurring in the game client on a Windows 10/11 system with Nvidia graphics. To fix low FPS or freezes in the game client on a Windows 10 system with Nvidia graphics, follow these steps. Go to the Nvidia Control Panel and adjust the 3D settings for Dark Groom`.exe`: * Set the Max Frame Rate to 60 FPS * Set the Monitor Technology to Fixed Refresh * Set the Preferred Refresh Rate to Application-controlled * Set Vertical Sync to Use the 3D-application setting If you do not see these options, make sure to update your NVIDIA drivers. You can do this through the GeForce Experience application or by downloading the latest drivers from NVIDIA's website. ### Cannot init d3d OR grf file has problem ![Gepard cannot init error](/files/pLS24RSjXtRk9jgYzdCr) * Run `Setup.exe` with administrator privileges * Select DirectX7 in the Graphics API option * Save the changes ![Select DirectX 7 from Setup.exe](/files/iSm6SMnDUiZAahuDRojS) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://darkgroom.gitbook.io/darkgroom-docs/docs/troubleshooting.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.