User Tools

Site Tools


guide:troubleshooting

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
guide:troubleshooting [2019-01-15 10:12]
skyjake
guide:troubleshooting [2020-02-14 21:15] (current)
skyjake
Line 1: Line 1:
 +<- Multiplayer ^ introduction|User Guide ^ Index ->
 +
 +====== Troubleshooting ======
 +Quick links:
 +  * [[https://​talk.dengine.net/​categories/​technical-support|Tech support forum]]
 +  * [[http://​talk.dengine.net/​discussion/​2757/​how-to-report-bugs-technical-issues|How to report bugs / technical issues]]
 +
 +
 +===== Doomsday.out log file =====
 +
 +When you encounter a bug or something seems to be malfunctioning,​ your first place to check for more information is the [[doomsday.out|Doomsday log file]] called **doomsday.out**. It may contain errors or diagnostic messages that help understand what is going on.
 +
 +**doomsday.out** can be found in the [[runtime folder]].
 +
 +When reporting the bug or posting on the [[https://​talk.dengine.net/​categories/​technical-support|tech support forum]], please attach the contents of the log file. This will ensure the basic information like operating system, OpenGL version and driver identifier, Doomsday version and build type, game configuration and loaded mods are included. These details may be crucial when trying to figure out what is causing the issue.
 +
 +
 +===== Common issues =====
 +
 +==== Problems with key/control bindings ====
 +
 +The keyboard, mouse, and gamepad/​joystick bindings can be reset to defaults to fix any configuration issues with them.
 +
 +There are two main ways to do this:
 +  * When Doomsday is not running, open the [[runtime folder]] and delete the ''​configs/<​game>/​player/​bindings.cfg''​ file. Note that each game plugin has its own subdirectory with a separate bindings configuration.
 +  * Alternatively:​ when you have a game running, you can open the [[guide:​task_bar_and_console#​console|console]] by pressing Shift-Esc and type the following commands:
 +
 +  clearbindings
 +  defaultbindings
 +
 +
 +
 +
 +==== Doomsday started crashing and even reinstall won't help ====
 +
 +The problem may be with the persistently stored configuration settings. Try clearing the [[runtime folder]] or just deleting the [[persist.pack]] file.
 +
 +==== Low FPS / renderer slowdown ====
 +
 +Since version [[version:​1.10]],​ the renderer has been inflicted with some performance bottlenecks.
 +
 +Version [[version:​2.1]] introduced OpenGL draw call batching, which alleviated some of the issues.
 +
 +Here are some things you can do to see what is triggering the slowdown:
 +  * If reducing pixel density or window resolution/​size increases FPS back to 60, the problem is that the GPU is too slow. It might help to disable the Bloom effect in this case.
 +  * When in a large map you notice the slowdown (perhaps looking at a large open area), does the FPS significantly increase if you turn and face a wall so that nothing but the wall is visible? This would indicate the slowdown is caused by the renderer'​s per-frame geometry processing.
 +  * Does the slowdown go away if you don't use add-ons? Some maps have tons of objects or light decorations so rendering these might get expensive. Some texture packs may also be too large to comfortably fit in GPU memory. (4 GB GPU memory should be quite OK, though.)
 +