Difference between revisions of "Debug"

Revision as of 19:34, 5 June 2017

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

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: An average time (in milliseconds) it's taking to render each frame, not including processing other than rendering. This number is directly related to FPS, lower is better
dtime_jitter: Jitter in the time difference between rendering frames, including all processing. 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!

@@ Line 19: / Line 19: @@
 * '''FPS''': Number of [https://en.wikipedia.org/wiki/Frames_per_second frames per second], denotes how fast everything is [https://en.wikipedia.org/wiki/Rendering_%28computer_graphics%29 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 (<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. '''Note''': This value is [https://en.wikipedia.org/wiki/Low-pass filter low-pass filtered] over the few seconds to prevent the value jumping around rapidly
+* '''drawtime''': An average time (in milliseconds) it's taking to render each frame, not including processing other than rendering. 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.
+* '''dtime_jitter''': Jitter in the time difference between rendering frames, including all processing. 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>.
 * '''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