Difference between revisions of "Reporting bugs"

From Minetest Wiki
Jump to navigation Jump to search
(Created page with "== Reporting Bugs == '''Minetest is never finished, it is constantly a work in progress.''' As such, any bug reports trivial, or not, go a long way in helping us make the eng...")
 
m (rename minetest forums to luanti forums (another one))
 
(10 intermediate revisions by 7 users not shown)
Line 1: Line 1:
== Reporting Bugs ==
+
{{Languages}}
  
'''Minetest is never finished, it is constantly a work in progress.''' As such, any bug reports trivial, or not, go a long way in helping us make the engine better for everyone. Before you file a bug report, please make sure that the bug has not already been filed/fixed by checking the bugs sub forum, the Minetest GitHub Issues page, and asking about it in the <code>#minetest</code> IRC channel itself.
+
=== Notes ===
 +
Luanti is never finished, it is constantly a work in progress. Thus all bug reports trivial, or not, help us making the engine better for everyone.
  
Once you are sure that the bug you are experiencing is truly new, please collect the following system data.
+
=== Check for similar reports ===
 +
A bug might already be reported or even fixed by the time you are having problems. Please check the following sources for solution prior reporting:
  
* Minetest version: displayed at the top left of the Minetest game screen. Write it down exactly as it is displayed.
+
* [https://www.minetest.net/downloads/ Newest Luanti version] - are you using the most recent one?
* Operating system: if you are running GNU/Linux, please write down the distribution name, version and architecture (64 bits or 32 bits). If you are running Windows, please note the version name (Vista, 7, 8, 8.1, '''XP is not supported''') and architecture (64 bits or 32 bits).
+
* [https://github.com/minetest/minetest/issues?q=is%3Aissue GitHub issue tracker]
* Computer specs: please note down the CPU name, clockspeed, number of cores, the amount of RAM installed in your system, and the graphics card your system uses. In some cases, you may also be asked to provide the amount of free space in your hard drive.
+
* [https://kiwiirc.com/nextclient/irc.libera.chat:+6697/#minetest Libera IRC (English)] (answers might take a while)
 +
* [https://forum.minetest.net/viewforum.php?f=6 Luanti Forums: 'Problems']
  
With that done, open up the <code>debug.txt</code> located in your Minetest bin/ folder. Copy the last 50 lines or so of the debug file.
+
=== Gathering information ===
 +
If you cannot find any similar reported bug, please collect as much relevant information to the developers. More information usually means faster issue tracking. Usually it helps us a lot to provide following information.
  
Finally, file a bug report under the Bugs sub forum in the official Minetest Forums. Use the following template while doing so:
+
* Luanti version (ex. "0.4.17.1", "5.1.1", "5.1.0-dev-numbers")
 +
** This is displayed in the window title bar.
 +
** For advanced users: provide the output of <code>minetest --version</code>
 +
* Operating system and version (ex. "Ubuntu 18.04", "Windows 10", "Android 9")
 +
** Please be as precise as possible.
  
   Topic Title: Shortly state what bug you are experiencing
+
Following information can be found in the system settings / system information or in the task manager:
 +
 
 +
* CPU type (ex. "Ryzen 7 3700X", "Core2 Duo E8600")
 +
* Amount of installed RAM
 +
** You might also want to monitor the RAM usage while reproducing the bug.
 +
* Graphics card (ex. "Intel HD Graphics 4000", "GTX 2080 Ti Super")
 +
** If you can join a game, please provide the OpenGL version (see title bar).
 +
** For advanced users: driver version and date.
 +
 
 +
'''Most important:''' Luanti generates a <code>debug.txt</code> file which is located near to the <code>bin</code> folder, or <code>~/.minetest/</code> for system-wide installations. Copy the last 50 lines or so of the debug file.
 +
 
 +
If you are tech-savvy, you might also want to look for similar issues in [[Troubleshooting]] and try to find out the cause of the issue by clearing all settings, tweaking settings or disabling mods.
 +
 
 +
=== Bug report template ===
 +
If you would like to submit to the Luanti Forums, please consider using this template while doing so:
 +
 
 +
   Topic title: shortly state what bug you are experiencing
 
    
 
    
   Topic Body: State, and give as many details as possible about the bug you are experiencing.
+
   Topic body: state, and give as many details as possible about the bug you are experiencing.
   Minetest Version: The Minetest Version that you noted above
+
   Luanti version:
   Operating System: The OS variant you noted above
+
   Operating system:
   Computer Specs: CPU, RAM, GPU
+
   Computer specs: CPU, RAM, graphics card
 
    
 
    
   [spoiler=Debug.txt]''Paste debug.txt here''[/spoiler]
+
   [spoiler=debug.txt]''Paste debug.txt here''[/spoiler]
 +
 
 +
[[Category:Tutorials]]

Latest revision as of 02:13, 23 October 2024

Languages Language: English • français • Bahasa Melayu

Notes

Luanti is never finished, it is constantly a work in progress. Thus all bug reports trivial, or not, help us making the engine better for everyone.

Check for similar reports

A bug might already be reported or even fixed by the time you are having problems. Please check the following sources for solution prior reporting:

Gathering information

If you cannot find any similar reported bug, please collect as much relevant information to the developers. More information usually means faster issue tracking. Usually it helps us a lot to provide following information.

  • Luanti version (ex. "0.4.17.1", "5.1.1", "5.1.0-dev-numbers")
    • This is displayed in the window title bar.
    • For advanced users: provide the output of minetest --version
  • Operating system and version (ex. "Ubuntu 18.04", "Windows 10", "Android 9")
    • Please be as precise as possible.

Following information can be found in the system settings / system information or in the task manager:

  • CPU type (ex. "Ryzen 7 3700X", "Core2 Duo E8600")
  • Amount of installed RAM
    • You might also want to monitor the RAM usage while reproducing the bug.
  • Graphics card (ex. "Intel HD Graphics 4000", "GTX 2080 Ti Super")
    • If you can join a game, please provide the OpenGL version (see title bar).
    • For advanced users: driver version and date.

Most important: Luanti generates a debug.txt file which is located near to the bin folder, or ~/.minetest/ for system-wide installations. Copy the last 50 lines or so of the debug file.

If you are tech-savvy, you might also want to look for similar issues in Troubleshooting and try to find out the cause of the issue by clearing all settings, tweaking settings or disabling mods.

Bug report template

If you would like to submit to the Luanti Forums, please consider using this template while doing so:

 Topic title: shortly state what bug you are experiencing
 
 Topic body: state, and give as many details as possible about the bug you are experiencing.
 Luanti version:
 Operating system:
 Computer specs: CPU, RAM, graphics card
 
 [spoiler=debug.txt]Paste debug.txt here[/spoiler]