Helpful functions

Introduction

Have you ever searched the Godot docs looking for a function and thinking "surely there has to be a function to..." only to not find what you're looking for? ProtoJam comes packed with a variety of commonly needed static functions to help fill that gap, including:

• Graceful shutdown
• Framerate independent lerps
• Time formatting
• and more...

Using CollectionUtils

The CollectionUtils class provides supplemental functions for Dictionary and Array.

filterd(dictionary, filter)

Returns a copy of a dictionary with only the filtered entries remaining similar to Array.filter. Returning true from the filter callable will retain the key/value pair it was called with.

var items: Dictionary[StringName, int] = {
	&"egg": 2,
	&"bullet": 20,
	&"herb": 0,
	&"key": -1,
}

# Remove egg items
var egg_filter: Callable = func(key: Variant, _value: Variant) -> bool:
	return &"egg" != key


# Prints { "bullet": 20, "herb": 0, "key": -1 }
print(CollectionUtils.filterd(items, egg_filter))

get_or_create(dictionary, key, callable)

Performs the same function as Dictionary.get_or_add(key, default) but defers to a callable to produce the default value. This is ideal for situations where the default value requires initialization beyond its construction or should not be constructed when not required.

var _npcs: Dictionary[String, NonPlayerCharacter] = {}

func _ready() -> void:
	CollectionUtils.get_or_add(_npcs, "blacksmith", _spawn_blacksmith) # Invokes _spawn_blacksmith and stores the result
	CollectionUtils.get_or_add(_npcs, "blacksmith", _spawn_blacksmith) # Returns the previously created blacksmith


func _spawn_blacksmith() -> NonPlayerCharacter:
	var npc: BlacksmithCharacter= BlacksmithCharacter.new()
	add_child(npc)
	return npc

remove_all(a, b)

Removes all entries from the first array that are also in the second array.

var a: Array[int] = [1, 2, 3, 4, 5]
var b: Array[int] = [2, 4]

# Prints [ 1, 3, 5 ]
print(CollectionUtils.remove_all(a, b))

Using NodeUtils

🚧 WIP

connect_descendant_signal(node, type, signal_name, callable, flags)

🚧 WIP

free_all_children(node)

🚧 WIP

focus_first_available(node)

🚧 WIP

get_tree()

🚧 WIP

quit_gracefully(exit_code)

🚧 WIP

Using PhysicsUtils

🚧 WIP

is_on_floor(max_floor_angle, state)

🚧 WIP

Using RandomUtils

🚧 WIP

pick_random(rng, array)

🚧 WIP

Using TimeUtils

🚧 WIP

framerate_aware_lerp_weight(lambda, delta)

🚧 WIP

format_stopwatch(millis, full_precision)

🚧 WIP

minutes_to_millis(minutes)

🚧 WIP

seconds_to_millis(seconds)

🚧 WIP

minutes_to_centis(minutes)

🚧 WIP

seconds_to_centis(seconds)

🚧 WIP

millis_to_centis(millis)

🚧 WIP

millis_to_minutes(millis)

🚧 WIP

millis_to_seconds(millis)

🚧 WIP

centis_to_minutes(centis)

🚧 WIP

centis_to_seconds(centis)

🚧 WIP