+3 votes

I can create a 1-dimensional array as follows:

var list = []

How would I create a 2-dimensional array? I can't seem to find an obvious example in the docs or project examples. In Python I think it would be:

var matrix = [[0 for x in range(width)] for y in range(height)] 

but this returns an error in Godot.

in Engine by (99 points)

6 Answers

+4 votes
Best answer

godotscript is not python and doesn't follow the pythonic way. Simply do it the old fashion way:

var matrix=[]
for x in range(width):
    for y in range(height):
by (698 points)
selected by

This approach is returning an error " Invalid set index '0' (on base: 'Array'). " at the first step

matrix[x] = []

Strange. I did try it yesterday. Anyway, maybe using


does the trick. The theory for the n dimensional matrix doesn't change.

Thank you , that seems to fix the problem:

var matrix = []
for x in range(width):
    for y in range(height):

Almost, I fixed it for you. Your method had some redundancies that slowed it down.

var matrix = []
for x in range(width):
    for y in range(height):


this sets the [] you just appended into a []



these append a [] and then set the [] to a 0, which is weird and inefficient

the cleaned up method simply starts with a [], then adds [] as rows, ex: [ [],[],[] ]
then adds 0's into the rows, ex: [ [0,0,0],[0,0,0],[0,0,0] ]

one last side note: if you are making a very large 2D array (300x300 or higher), it seems to be faster to use a while loop instead of the for each loop with the range method, because the range method does something along the lines of building an array, ex: range(3) makes an array = [0,1,2]. This is slower than simply having an increment counter, ex: int x = 0, while(x<3), x += 1

very helpful, thanks for the advice and improvements!

+8 votes

Or such:

func create_map(w, h):
    var map = []

    for x in range(w):
        var col = []

    return map

Return Null-filled array.

by (40 points)
+2 votes

This is the way I create 2d arrays in godot:

var array_a = [1,2,3,4]
var array_b = [5,6,7,8]

var array_2d = [array_a, array_b]

And then, to read:

array_2d[0,1] -> 2
array_2d[1,2] -> 7
by (18 points)

I believe the correct way to read/write is (now):

array_2d[0][1] -> 2 


At least that's what i experienced in Godot 3.0

+8 votes

Seeing these awful answers; this is the most performance-friendly way of creating it:

func create_2d_array(width, height, value):
    var a = []

    for y in range(height):

        for x in range(width):
            a[y][x] = value

    return a

To be used as array[y][x].

by (1,087 points)

This comment is ancient now, but why did you put y before x? That seems pretty programmer-unfriendly, considering that every other time coordinates are used, they go in alphabetical order (x,y)

@Davi-Danger, that isn't always true. It comes down to row-major vs. column major, which very much depends on the application of the 2D array. If I'm modeling something like a matrix, it isn't uncommon at all to have y first; and in some APIs it's the standard to do it that way.

After all, it doesn't just affect how the programmer sees it, it affects how it's arranged in memory.

0 votes
#creating 2D Arrays in GDscript
var my_array = [[]]

var width = 5
var height = 5

func _ready():
#setting 2D Array size
for x in width:

    for y in height:

#setting a value
my_array[0][0] = 1
by (14 points)
0 votes

The simplest way is probably:

var r = [0,0,0,0,0,0,0,0,0,0,0,0,0]#r for row
var matrix = [r,r,r,r,r,r,r,r,r,r,r,r,r,r,r]
by (14 points)
Welcome to Godot Engine Q&A, where you can ask questions and receive answers from other members of the community.

Please make sure to read How to use this Q&A? before posting your first questions.
Social login is currently unavailable. If you've previously logged in with a Facebook or GitHub account, use the I forgot my password link in the login box to set a password for your account. If you still can't access your account, send an email to webmaster@godotengine.org with your username.