GDScript Data Types: int, float, String, bool and More

Every value in GDScript has a type. These are the ones you use every day:

extends Node

func _ready():
	var lives: int = 3
	var speed: float = 250.5
	var alive: bool = true
	var title: String = "Level 1"
	var spawn: Vector2 = Vector2(64, 128)
	var tint: Color = Color(1, 0.5, 0)
	var items: Array = ["key", "map"]
	var stats: Dictionary = {"hp": 10, "mp": 4}
	var target: Node = null

	print(lives, " ", speed, " ", alive, " ", title)
	print(spawn, " ", tint)
	print(items, " ", stats, " ", target)

3 250.5 true Level 1
(64.0, 128.0) (1.0, 0.5, 0.0, 1.0)
["key", "map"] { "hp": 10, "mp": 4 } <null>

Numbers: int and float

int is a 64-bit whole number. float is a 64-bit decimal number. A number with a dot is a float, even 3.0:

extends Node

func _ready():
	print(7 / 2)        # int / int: the remainder is dropped
	print(7 / 2.0)      # a float on either side gives a float
	print(7 % 3)        # remainder
	print(2 ** 10)      # power
	print(fmod(7.5, 2.0))
	print(1_000_000, " ", 0xFF, " ", 0b101, " ", 1e3)

3
3.5
1
1024
1.5
1000000 255 5 1000.0

Integer division is the classic surprise. When you want a fraction, write one side as a float. Underscores in a number are only for reading, and 0x and 0b write hex and binary.

Floats are not exact. Compare them with is_equal_approx() rather than ==:

extends Node

func _ready():
	var total := 0.1 + 0.2
	print(total == 0.3)
	print(is_equal_approx(total, 0.3))

false
true

bool

bool is true or false. Logic uses words (and, or, not), and the symbols &&, || and ! also work. Many values count as false in an if: 0, 0.0, "", an empty array or dictionary, and null.

String and StringName

String holds text. StringName is a text value Godot stores once and compares fast, written &"idle". Node names, animation names, input actions and signal names are StringNames, and they compare equal to the same String. The strings page covers text methods.

Vectors, Colors and Other Engine Types

GDScript has game math types built in, with no imports:

See Vector2 for the vector math a 2D game needs.

Collections and Objects

• Array: an ordered list. See arrays.
• Dictionary: key and value pairs. See dictionaries.
• Packed arrays such as PackedInt32Array and PackedVector2Array: compact lists of one type. See packed arrays.
• Object: every node and resource. Objects are passed by reference; the other types above are copied, except arrays and dictionaries, which are shared too.
• null: no value. See null and is_instance_valid.

Checking a Type

typeof() returns a number from the TYPE_* constants, and type_string() turns it into a name. is checks a type directly and also works for classes:

extends Node

func _ready():
	var values = [3, 2.5, "hi", true, Vector2.ZERO, [1], null, self]
	for value in values:
		print(type_string(typeof(value)))
	print(typeof(2.5) == TYPE_FLOAT)
	print(self is Node)

int
float
String
bool
Vector2
Array
Nil
Object
true
true

Converting Between Types

extends Node

func _ready():
	print(int("42") + 1)
	print(float("3.5") * 2)
	print(int(3.9))        # drops the decimals
	print(round(3.5))      # rounds, gives a float
	print(str(10) + " coins")
	print(int("abc"))      # not a number: 0
	print("12a".is_valid_int())
	print(bool(0), " ", bool(5))

43
7.0
3
4.0
10 coins
0
false
false true

int() on text that is not a number gives 0 without an error, so validate input first with is_valid_int() or is_valid_float().