Classes Internas

Uma classe pode declarar outra classe dentro dela, com a palavra-chave class, um nome e um corpo indentado. Essa classe interna é um tipo auxiliar que pertence à classe externa:

# inventory.gd
class_name Inventory
extends RefCounted

const MAX_STACK := 5

class Slot:
	var item_name: String
	var count: int

	func _init(new_name: String, new_count: int) -> void:
		item_name = new_name
		count = mini(new_count, MAX_STACK)

	func _to_string() -> String:
		return "%s x%d" % [item_name, count]

var slots: Array[Slot] = []

func add(item_name: String, count: int) -> Slot:
	var slot := Slot.new(item_name, count)
	slots.append(slot)
	return slot

Dentro de inventory.gd, a classe interna é Slot. Todos os outros arquivos a acessam por meio da classe externa: Inventory.Slot.

# main.gd
var bag := Inventory.new()
bag.add("Potion", 9)
var arrows: Inventory.Slot = bag.add("Arrow", 3)
print(bag.slots)    # [Potion x5, Arrow x3]
var gem := Inventory.Slot.new("Gem", 1)

Uma classe interna sem extends estende RefCounted e pode ter variáveis, um construtor e métodos como qualquer classe. Ela pode usar as constantes e enumerações da classe externa (MAX_STACK acima), mas não suas variáveis-membro: Slot não tem acesso a slots, porque um slot é um objeto separado. Passe ao construtor qualquer valor de que ela precise.

Use uma classe interna para um tipo pequeno que só faz sentido junto com sua classe externa, como um espaço de um inventário ou uma entrada de uma tabela de pontuação. Um tipo que outras partes do jogo usam por conta própria merece seu próprio arquivo e class_name.