Difference between revisions of "Debug"

From Minetest Wiki
Jump to navigation Jump to search
m (→‎Second row: fix broken link)
(→‎First row: Try to explain dtime_jitter.)
Line 20: Line 20:
 
* '''R: range_all''': If “1”, the full viewing range is enabled, if “0”, it is disabled. You can toggle this with the “Far View” key (<kbd>R</kbd>)
 
* '''R: range_all''': If “1”, the full viewing range is enabled, if “0”, it is disabled. You can toggle this with the “Far View” key (<kbd>R</kbd>)
 
* '''drawtime''': The time it took to render the previous frame, in milliseconds. This number is directly related to FPS, lower is better
 
* '''drawtime''': The time it took to render the previous frame, in milliseconds. This number is directly related to FPS, lower is better
* '''dtime_jitter''': Roughly spoken, the variance of drawtime over some short period of time <!-- TODO: This is a crappy explanation, please improve it! -->
+
* '''dtime_jitter''': Minetest remembers the previous drawtime values over a few seconds in the past. This value shows how much higher than the average the ''peak'' value (over the last few seconds) was. A value of 50% or lower is considered okay.
 
* '''v_range''': Viewing range in nodes. By default, you can adjust this with <kbd>+</kbd> and <kbd>-</kbd>.
 
* '''v_range''': Viewing range in nodes. By default, you can adjust this with <kbd>+</kbd> and <kbd>-</kbd>.
 
* '''RTT''': [https://en.wikipedia.org/wiki/Round_trip_time Round Trip Time] in seconds. This is especially important when connected to a server. Lower is better
 
* '''RTT''': [https://en.wikipedia.org/wiki/Round_trip_time Round Trip Time] in seconds. This is especially important when connected to a server. Lower is better

Revision as of 19:20, 5 June 2017

Mbox important.png This article is incomplete.
Please help expand this article to include more useful information.

The debug screen can be access by pressing the F5 key (by default) and shows various technical information about Minetest which are mostly interesting for developers, but some information are also useful for players, especially the coordinates.

It contains various information useful for development and testing. Press F5 to access different debug screen modes:

  • Debug screen disabled
  • Debug info
  • Debug info + profiler graph
  • Debug info + wireframe (only with “debug” privilege)

Debug info

Debug.png

The basic debug information is located at the top left of the screen.

First row

  • Minetest X.Y.Z: The version number of Minetest
  • FPS: Number of frames per second, denotes how fast everything is rendered. Higher = better. It is limited at 60 by default. An FPS lower than 30 is pretty bad (try to lower graphics settings or close some background applications)
  • R: range_all: If “1”, the full viewing range is enabled, if “0”, it is disabled. You can toggle this with the “Far View” key (R)
  • drawtime: The time it took to render the previous frame, in milliseconds. This number is directly related to FPS, lower is better
  • dtime_jitter: Minetest remembers the previous drawtime values over a few seconds in the past. This value shows how much higher than the average the peak value (over the last few seconds) was. A value of 50% or lower is considered okay.
  • v_range: Viewing range in nodes. By default, you can adjust this with + and -.
  • RTT: Round Trip Time in seconds. This is especially important when connected to a server. Lower is better

Second row

  • The first three numbers: Your coordinates: X, Y and Z
  • yaw: Your current horizontal looking direction (also known as “yaw”) in degrees (0-360), with 0° translated to “North”, 270° to “East”, 180° to “South” and 90° to “West”. Note that the concept of cardinal directions is not really meaningful in Minetest, as the world is a cube, not a sphere, and there are no poles
  • seed: The random seed used by the map generator to generate the current world. Equal seeds (along with equal mapen settings) will lead to equal worlds
  • pointing_at: If you're pointing at a node (block), this shows its itemstring as well as the file name of the primary texture (top side on cubes)

When pointing an entity

When you point an entity or object (such as a dropped item or player), the following information is shown to the left:

  • Entity type
  • hp: Health in hit points (→Player#Health)
  • armor: Armor groups, determine how the entity receives damage. (With “immortal=1”, the entity doesn't take damage, or it doesn't take damage the conventional way)

Profiler graphs

TO BE WRITTEN!