Debug

Language:	English • Deutsch

The debug screen can be accessed 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)

Some games and mods might restrict the amount of debug information by hiding gameplay-relevant information like the coordinates (maybe because the player is supposed to “earn” the right to see the coordinates by playing, or to make the game more difficult). If you have the “debug” privilege, this does not affect you, and you always get to see the full debug information.

Debug info

Basic debug info

The basic debug information is located at the top left of the screen. It looks like this:

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)
• drawtime: An average time (in milliseconds) it's taking to render each frame, not including processing other than rendering. Lower is better
• dtime jitter: Jitter in the time difference between rendering frames, including all processing. 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
• view range: Your current viewing range in nodes. “All” means unlimited. By default, you can adjust this with +, - and R.
• RTT: Round Trip Time. This is especially important when connected to a server. Lower is better

Second row

• pos: Your coordinates: X, Y and Z
• yaw: Your current horizontal looking direction (also known as “yaw”). For convenience, also the cardinal direction (e.g. “North”) as well as the approximate axis direction are shown (e.g. “+Z”)
• pitch: Your current vertical looking direction (i.e. “pitch”). 0° means you look horizontally, positive numbers means looking upwards and negative numbers means looking downwards
• seed: The random seed used by the map generator to generate the current world. Equal seeds (along with equal mapgen settings) will lead to equal worlds
• pointed: The itemstring / “technical name” of the current pointed node (if any).
• param2: Value of param2 of the current pointed node (if any). This contains some additional info for a node, such as rotation, color, etc, which is important for programmers. The meaning of param2 is explained in the Lua API documentation.

Note: The entire second row is hidden when the debug information is restricted (see above).

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: See ActiveObject on the Minetest Developer Wiki
• hp: Health in hit points (→Player#Health)
• armor: Armor groups, determine how the entity receives damage (see below)

Note: This is hidden when the debug information is restricted (see above).

Armor groups

The armor groups are used internally by Minetest to tell how “vulnerable” an entity (including players) is to different forms of attack. Each armor group has a name and a number. The number is a percentage, 100 means you get 100% of the damage, 200 means you get double the damage, 50 means you get 50% of the damage, etc. Any armor group that is *not* in this list means that the entity does not take damage from attacks of this group.

By default, the armor group “fleshy=100” is used for entities. Most armor mods use these armor groups to reduce damage. Games/Minetest Game only uses this armor group for both weapons and entities, and so do many other games. The name “fleshy” does not mean the entity is actually made of flesh, this is just the default name.

But some games might use more complex systems. Think, for example, of elemental creatures that are vulnerable to ice-based attacks but immune to physical attacks.

The armor group “immortal=1” is a special case and means the entity does not take any damage by conventional means (however, mods might still manage to handle damage in a completely different manner).

Profiler graphs

The profiler graphs show the performance of Minetest in a more detailed fashion. This information is most useful for engine developers.

See [1] for more information.