Due to the reach and aggressiveness of GM++, it will likely never be completely bug-free. If you have a bug or another type of issue to report, please provide the error traceback (if any) and the necessary steps to reproduce it. If there is a mod conflict, please provide the name or a workshop link of the addon in question.

There are multiple things you can do to help us help you help us all figure out what's wrong. First of all, check for any possible Lua errors. If not, then make sure the mod is running properly. You can do this by, in the console, setting gmpp_debug_on 1 and running either gmpp_reload or sv_gmpp_reload, depending on the realm you are experiencing trouble with. If GM++ is working, you should then see a load of text appear on your screen.

A GM++ module has an issue?
Please specify the module name and ways to replicate the issue.

GM++ itself isn't working properly?
Always ensure there are no Lua errors present. If not, then the problem is most likely the hook override. This is usually caused by a mod conflict, often with libraries such as DLib. GM++ ships with its own implementation to ensure that it is always the first in line and that things are handled properly, following native spec to the highest possible standard along with certain extensions. Modifying the hook library will result in failure for GM++ to work properly, as its functionality ceases to be run.

Another addon is not working properly?
Help us identify the issue by providing us with the name of the addon, and by describing the problems you are having. We are happy to look at it for you!

Nothing is working?
Then you have achieved a critical failure. Please make sure that you have:
1) restarted the game after subscribing
2) no conflicting mods present
3) read the discussion to see if others are experiencing this

You have a suggestion?
We're glad to hear it! But make sure it is easily implemented and fits into the philosophy of the mod. If you're smart, you might be able to do it yourself! GM++ is very modular and easy to extend, but is currently lacking in documentation.

• Incompatibility: GM++ will NOT work with libraries that manipulate or replace the native hook module, such as DLib.
  
• Hook manager: Hooks manipulating the current event hook list will result in undefined behavior. However, hooks that remove themselves work as intended.
  
• Depth buffer: Some entities might not draw when depth is used.
  
• Flashlight: No cross-compatibility between engine flashlight and custom flashlight (flashlight state, suit battery drain).
  
• Flashlight: Sometimes the flashlight prevents viewmodel hands with a selfillum texture from drawing. (???)
  
• Free-aim: A mild stutter might be visible when looking around.
  
• Drive FX: A stutter may be seen in chase camera mode.
  
• ...