gdscript utility classes

:information_source: Attention Topic was automatically imported from the old Question2Answer platform.
:bust_in_silhouette: Asked By raould
:warning: Old Version Published before Godot 3 was released.

How do I most easily create a pure code utility class? Do I have to make a Node, rename it “Utils”, and then attach a new script to it for the functions? I’d like to just have that utility code exist without having to be attached to a fake/dummy node.

:bust_in_silhouette: Reply From: splite

Edit: Nevermind, Zylanns answer is much better :slight_smile: (see yourself below) i didnt know that godot support static func (cool to know & +1 :slight_smile: )

Well, you can just load your script without existing node

file res://Scripts/

extends Node #or whatever

#silly example :)
static func plus(x, y):
    return x + y

and in ‘real’ node:

var x
func _ready():
     x = load("res://Scripts/")
     var p =,2)

Or maybe, you would like to extend your base class (its always better then having Utils class) like this:

file res://Scripts/

extends RigidBody
var _turn_speed
func set_turn_speed(x):
     _turn_speed = x

script on your (RigidBody) node:

extends "res://Scripts/"
func _ready():

edit: i re-read your question and flip examples :slight_smile: Sorry for confusion :slight_smile:

I’m unsure about the last recommendation, as you probably want your spaceship node to keep the functionality you get from extending RigidBody2D/3D, and everything up its hierarchy.

avencherus | 2016-08-25 12:15

I dont lose any functionality, its classic inheritance (see another question), SpaceShipBase extends RigidBody (RigidBody = “RigidBody3D”, dont have “3D” in name), node-specific-script extends SpaceShipBase. So in node-specific-script, i have access to SpaceShipBase and RigidBody functions.

What i get is central script of common functions of all spaceships (like movement func etc) without caring of ship specific (one or dozen thrusters, etc… :slight_smile: )

edit: Of course, all my spaceships have to be RigidBody node :slight_smile:

splite | 2016-08-25 13:15

:bust_in_silhouette: Reply From: Zylann

If your utilities are just functions or constants, you can make a script file that don’t extend anything and write static func functions inside.
Then you preload it where you need it:

const Util = preload("")

func foo():

Here is an utility script I wrote for a plugin: for example
And the way it’s used:

If you need the script to hold some states (vars) or if your functions cannot be static for some reason, you can also make it a singleton with auto-load and give it the name “Util” so it’s accessible everywhere. But I like the first solution because it has less potential for race condition errors :stuck_out_tongue:

It’s also possible to create a pure script class and in another script, after preloading the class, instance it with “new()”.

Edit: I misinterpreted the need for a utility class, so you won’t want this specifically.

Aaron | 2016-08-25 10:38

Using new is useful only if you want an instance that is not global, for example a Grid class or something carrying parameters.

Zylann | 2016-08-25 12:38

(Thanks everybody for the thoughts!) How do I create the file from inside the Editor? Or how do I import it into the project? (I find the Editor to be generally confusing wrt project management.)

raould | 2016-08-26 05:13

Go to Script tab, File → New?
Otherwise you can just create the .gd file in the system explorer and Godot will find it.

Zylann | 2016-08-26 09:19

with 2.1 when i do file → new it gives me a dialog box where i cannot type anything into the class name text field?! directly underneath the text field it says “N/A”. confusing as all heck. I clicked on Path and give it a file name at least. i have no idea what “built-in script” toggle does. etc.

this seemed to work until i tried to use get_node(“/path/to/node”) and it said “Invalid call. Nonexistent function ‘get_node’ in base ‘GDScript’.”

so i guess for my purposes I have to have my utilities be derived from a real Node.

raould | 2016-10-01 20:55

:bust_in_silhouette: Reply From: avencherus

I meant to post earlier, but I would add that another option is to make your class a global singleton if you want it available to the whole project.

Create a new script. Add that script in the Auto Load tab found in the Project Settings menu. Give it a name like Util, ensure it’s marked as singleton. Then as long as everything is properly setup, you should be able to just call it directly like Util.func(x) anywhere in your scripts.

Frankly none of the approaches I have seen really make a lot of sense to me. They all feel like they are confusing strange hacks compared to how this would be done in other programming language environments like a Java IDE or whatever. I think the whole attempt to have the “res://” stuff sounds nice at first, but seems to lead to weird things like the op and the various answers.

This here to me actually feels like the “simplest” and so i am hoping to do this. But I haven’t gotten it to work (nor the other suggestions) yet, though I am still going to keep trying. :slight_smile:

I did pretty much as far as I know what you said, and I get e.g. “Invalid call. Nonexistent function ‘v’ in base ‘Nil’.” when I try to invoke a fn in there.

raould | 2016-08-26 05:24

If you’re getting that error, it might be because the GDScript isn’t extending anything.

At the top see if you have something like

extends Node

The other solutions offered are valid approaches too, it’s how things like this were done I think before the singleton feature was added, or if you prefer to only have the script loaded into specific scenes.

avencherus | 2016-08-26 07:52

I am from c# background (actually, my main job is c#, godot is hobby) and have to say, when you get some basic things and relax muscle memory (like not writing ‘;’ at end of every line :slight_smile: ) everything become pretty simple.

  1. Just click Scripts → File → New → insert Path, make sure build-in is off → Create.

  2. add some code, for simplicity lets say

    static func Plus(x,y):
        return x + y;

And save.

  1. Add this script as singleton (becouse godot doesnt have anything like static classes, this is actually simple hack, but why not :slight_smile: ) via Scene → ProjectSettings → AutoLoad.

  2. Profit. Now you can use your script just like that:

    Utils.Plus(1,2) # 3

(i just slapped it randomly in my script just to show it really works :slight_smile: )

splite | 2016-08-26 08:07

:bust_in_silhouette: Reply From: luislodosm

Use class_name to access a class everywhere. Example:

class_name MyConstants

const PLAYER_GROUP = "player"
const GLOBAL_GRAVITY = 9.8

Then, everywhere:

if body.is_in_group(MyConstants.PLAYER_GROUP):
   gravity = MyConstants.GLOBAL_GRAVITY