Privé par convention

GDScript n'a pas de mot-clé private : chaque propriété et méthode d'un objet peut être accessible depuis d'autres scripts. La convention de Godot consiste à utiliser un trait de soulignement en préfixe. _coins et _is_valid() ci-dessous sont destinés au code de la classe uniquement :

# wallet.gd
class_name Wallet
extends RefCounted

var _coins: int = 0

func add(amount: int) -> void:
	if _is_valid(amount):
		_coins += amount

func spend(amount: int) -> bool:
	if not _is_valid(amount) or amount > _coins:
		return false
	_coins -= amount
	return true

func get_coins() -> int:
	return _coins

func _is_valid(amount: int) -> bool:
	return amount > 0

D’autres scripts utilisent les méthodes publiques, qui vérifient chaque modification : spend() refuse de retirer plus de pièces que le portefeuille n’en contient, ainsi le nombre de pièces ne passe jamais en dessous de zéro.

var wallet := Wallet.new()
wallet.add(50)
wallet.add(-20)
print(wallet.spend(80)) # false
print(wallet.get_coins()) # 50

Le trait de soulignement est une promesse, pas un verrou : wallet._coins = -999 s’exécute sans aucune erreur. Il appartient à quiconque écrit les autres scripts de tenir cette promesse ; ne lisez donc pas et ne modifiez pas les membres précédés d’un trait de soulignement depuis l’extérieur de leur classe.

Tu connais déjà deux noms avec un trait de soulignement provenant de Godot lui-même : _ready() et _init() sont appelées par le moteur, pas par ton propre code.