Inspect: Difference between revisions

Inspect
Type	Script block
Collider	None
Folder	Values
Ports
Inputs	Before; Value;
Outputs	After;

Latest revision as of 14:37, 23 August 2025

Displays the value given to the input, allowing you to see values of variables or results of scripts.

This block is essential for debugging your games, as it allows you to know what value your variables have at all times. So you can see if a position is correct, or if a loop it's reaching the desired number.

If you connect its only input to a variable or value block, the data will be printed on its top.

Types of inspect

There are 5 different inspect blocks, each one for a different type of value.

From left to right and top to bottom, we have:

Number: either a floating-point value, truncating the decimal when necessary, or nan or inf
Object: either None, or the ID of the object
Vector: each component of the vector
Truth: either True or False
Rotation: a quaternion represented by 3 angles

The number displayed on the object inspect is usually not useful, but there is a use for the object inspect, which we will talk about bellow in the next section.

And you might also notice that the rotation inspect shows a completely different value from what it's being given to it, this is because the same rotation can be expressed with different angles, so don't worry too much about this one.

Note that the display on this block is only visible when the block is on the ground, so it's impossible to see the value when using it inside a script block.

And that's when: Advanced mode, comes in.

Advanced mode

In the image above you can see a small blue square at the bottom right, this is what advanced mode does. With this you can still see the value of your variables regardless of where the inspect block is or where your camera is pointing.

To enable it, all you need to do is select any inspect block in the game, once selected you will see a new button appear on the bottom right of the hotbar which says "Advanced". Clickng this button will toggle advanced mode, indicated by a checkmark. The toggle is global and will enable/disable advanced mode on all inspect blocks at once.

With it enabled, all object inspects will show a pink line going from the inspect button to the object being inspected, instead of only displaying an ID.

While playing in edit mode, if advanced mode is activated, all inspected values will be displayed on the right side of your screen, arranged vertically. If you tap on one of them, each time it is executed, it's value will be printed to a "console log" on the left side. This is helpful if you want to keep track of how values change over time. To stop printing the values simply tap that same button again.

The first three lines of the log will always be occupied by percentages of object, script, and block limits consumed.

@@ Line 8: / Line 8: @@
 }}
-Displays the value given to the input, allowing you to see the value in a variable.
+Displays the value given to the input, allowing you to see values of [[variables]] or results of scripts.
-== Importance ==
 This block is essential for debugging your games, as it allows you to know what value your variables have at all times.
 So you can see if a position is correct, or if a loop it's reaching the desired number.
@@ Line 17: / Line 15: @@
 If you connect its only input to a variable or value block, the data will be printed on its top.
-[[File:?]]
+{{Image|Inspect debug.jpeg}}
 == Types of inspect ==
@@ Line 23: / Line 21: @@
 There are 5 different inspect blocks, each one for a different type of value.
-[[File:?]]
+{{Image|Inspect types.png}}
 From left to right and top to bottom, we have:
-* '''Number''': either a floating-point value, truncating the decimal when necessary, or a nan or inf
+* '''[[Number]]''': either a floating-point value, truncating the decimal when necessary, or '''nan''' or '''inf'''
-* '''Object''': either '''none''', or the ID of the object
+* '''[[Object]]''': either '''None''', or the ID of the object
-* '''Vector''': three numbers into one!
+* '''[[Vector]]''': each component of the vector
-* '''Truth''': either '''true''' or '''false'''
+* '''[[Truth]]''': either '''True''' or '''False'''
-* '''Rotation''': a quaternion
+* '''[[Rotation]]''': a quaternion represented by 3 angles
-One small consideration is that the number displayed on the object inspect is not actually useful, but there is an use for the object inspect, which we will talk about bellow in the next section.
+The number displayed on the object inspect is usually not useful, but there is a use for the object inspect, which we will talk about bellow in the next section.
 And you might also notice that the rotation inspect shows a completely different value from what it's being given to it, this is because the same rotation can be expressed with different angles, so don't worry too much about this one.
-It's also necessary to know that the display on this block it's only visible when the block it's on the ground, so it's impossible to see the value when you are using it inside a script block.
+Note that the display on this block is only visible when the block is on the ground, so it's impossible to see the value when using it inside a script block.
 And that's when: '''Advanced mode''', comes in.
@@ Line 43: / Line 41: @@
 == Advanced mode ==
-[[File:?]]
+{{Image|Inspect advanced mode.png}}
 In the image above you can see a small blue square at the bottom right, this is what advanced mode does.
-With this you can still see the value of your variables regardless of where the block is or where your camera is pointing.
+With this you can still see the value of your variables regardless of where the inspect block is or where your [[Set Camera|camera]] is pointing.
-To use it all you need to do is select any inspect block in the game, once selected you will see a new button appear on the bottom right of the hotbar which says "<u>Advanced</u>", click this button and a checkmark will appear, this means advanced mode is now enabled.
+To enable it, all you need to do is select any inspect block in the game, once selected you will see a new button appear on the bottom right of the hotbar which says "<u>Advanced</u>". Clickng this button will toggle advanced mode, indicated by a checkmark. The toggle is global and will enable/disable advanced mode on all inspect blocks at once.
-[[File:?]]
+{{Image|Inspect advanced mode option.png}}
-Now about that useless object inspect, it turns out it's actually not that useless, and that's thanks to the advanced inspect, when you activate it the object inspect will show a line going from the inspect button to the object being inspected.
+With it enabled, all object inspects will show a pink line going from the inspect button to the object being inspected, instead of only displaying an ID.
-[[File:?]]
+{{Image|Inspect advanced mode object.png}}
-While playing, if the mode is activated, all inspected values will be displayed on the right side of your screen. If you tap on one of them, it will be printed to a "console log" on the left side. It's helpful if you want to keep track of how values change  over time.
+While playing in [[Editor|edit mode]], if advanced mode is activated, all inspected values will be displayed on the right side of your screen, arranged vertically. If you tap on one of them, each time it is [[Execution order|executed]], it's value will be printed to a "console log" on the left side. This is helpful if you want to keep track of how values change  over time.
 To stop printing the values simply tap that same button again.
-[[File:?]]
+{{Image|Inspect advanced mode log.png}}
-The first three lines of the log will always be occupied by percentages of object, script, and block limits consumed.
-Note that activating or deactivating this option will be shared to all inspect block existing in the game.
+The first three lines of the log will always be occupied by percentages of [[Limitations in Fancade scripting#Number of created objects|object]], [[Script limit|script]], and [[Limitations in Fancade scripting#Maximum custom blocks|block]] limits consumed.
 [[Category:Blocks]]