chore: clarify the code more

Author: razcore-rad

character.gd

@@ -1,3 +1,4 @@
+class_name Character
 extends Node
 
 # `growth_data` gets passed to the experience progress bar. The first value of the array
@@ -19,7 +20,15 @@ var experience_required := get_required_experience(level + 1)
 
 
 func get_required_experience(for_level: int) -> int:
-	return roundi(pow(for_level, 1.8) + for_level * 4)
+	# If you followed along with the first video tutorial, this is the formula that was shown
+	# for calculating the required experience for a level up.
+	#
+	# We used the same variable names as the red formula from Desmos for greater clarity.
+	# See the graph at: https://www.desmos.com/calculator/0r0mrngda2
+	var a := 4.0
+	var b := 1.8
+	var x := for_level
+	return roundi(a * x + pow(x, b))
 
 
 func gain_experience(amount: int) -> void:
@@ -41,6 +50,8 @@ func level_up() -> void:
 	level += 1
 	experience_required = get_required_experience(level + 1)
 
-	var stats: Array[String] = ["max_hp", "strength", "magic"]
-	var random_stat := stats[randi() % stats.size()]
-	set(random_stat, get(random_stat) + randi() % 4)
+	# We simulate the player picking stats to increase, by selecting a random
+	# stat each time we level up and increasing it with a random number.
+	var stats := ["max_hp", "strength", "magic"]
+	var random_stat: String = stats.pick_random()
+	set(random_stat, get(random_stat) + randi_range(1, 3))

game.gd

@@ -1,20 +1,21 @@
 extends Node
 
-@onready var _character := %Character
+@onready var _character: Character = %Character
 @onready var _label: Label = %Label
 @onready var _experience_bar: TextureProgressBar = %ExperienceBar
 
 
 func _ready() -> void:
-	_label.update_text(_character.level, _character.experience, _character.experience_required)
+	randomize()
+	_label.update_text(_character)
 	_experience_bar.initialize(_character.experience, _character.experience_required)
 
 
 func _unhandled_input(event: InputEvent) -> void:
 	if not event.is_action_pressed("ui_accept"):
 		return
 
-	# We just picked a random value to increase the experience by. Notice how the higher level
-	# need you to run this function multiple times before leveling up.
+	# We just picked a random value to increase the experience by. At higher levels you
+	# need to gain this experience multiple times before leveling up.
 	_character.gain_experience(34)
-	_label.update_text(_character.level, _character.experience, _character.experience_required)
+	_label.update_text(_character)

game.tscn

@@ -33,9 +33,9 @@ unique_name_in_owner = true
 layout_mode = 1
 anchors_preset = -1
 anchor_left = 0.5
-anchor_top = 0.525
+anchor_top = 0.8
 anchor_right = 0.5
-anchor_bottom = 0.525
+anchor_bottom = 0.8
 offset_left = -430.5
 offset_top = -34.5
 offset_right = 430.5
@@ -54,10 +54,16 @@ offset_right = 314.0
 offset_bottom = 249.0
 theme_override_fonts/font = ExtResource("4_j5wjh")
 theme_override_font_sizes/font_size = 32
-text = "Level: 4
-			Experience: 86
-			Next level: 23
+text = "Character
+	Max HP: 8
+	Strenght: 6
+	Magic: 5
+
+	Level: 4
+		Experience: 86
+		Next level: 23
 			"
+tab_stops = PackedFloat32Array(48)
 script = ExtResource("5_vef74")
 
 [connection signal="experience_gained" from="Character" to="InterfaceControl/ExperienceBar" method="_on_character_experience_gained"]

label.gd

@@ -1,7 +1,22 @@
 extends Label
 
-func update_text(level: int, experience: int, required_exp: int) -> void:
-	text = """Level: %d
-			Experience: %d
-			Next level: %d
-			""" % [level, experience, required_exp]
+func update_text(character: Character) -> void:
+	text = "\n".join(
+		[
+			"Character",
+			"	Max HP: %d",
+			"	Strength: %d",
+			"	Magic: %d",
+			"",
+			"	Level: %d",
+			"		Experience: %d",
+			"		Next level: %d",
+		],
+	) % [
+		character.max_hp,
+		character.strength,
+		character.magic,
+		character.level,
+		character.experience,
+		character.experience_required,
+	]