[Tutorial] Math Utils

Features

Math Utils adds the following variables.

• Random Source
• Vector
• Vector List
• Vector Map

Random Source

Random Source is a variable required to generate random numbers.

In order to generate random numbers,  you will need to create a random source. If the source is used without creating, errors will occur.

The seed is a number required to calculate random numbers, and it can fixes the sequence of those.

Next, get random numbers with the source.

Note that random numbers are not automatically synchronized between client and server side.

Vector

Vector is a variable which can have 3 numbers as X, Y and Z value.

In order to create a vector from numbers, do it like this. If a vector is not created, a zero vector (x, y, z) = (0, 0, 0) is used as an initial value.

For yaw and pitch values, vectors follow Minecraft's coordinate system.

These procedures can get each of numbers.

To do easy operations for vectors, these procedure are available.

The operations are done for each X/Y/Z component of numbers in vectors. For example, "(0, 1, 2) + (3, 4, 5)" is "(3, 5, 7)."

Vector List

Vector List can store vectors using index numbers.

You will need to create a vector list at first. If the list is used without creating, errors will occur.

The initial size is the size of the fixed-size array used internally for the list. Note that the size is not an actual size of the list.

When the current size of the list reaches the initial size, the fixed-size array will automatically be replaced with a larger array.

Vector Map

Vector map can store vectors using string keys.

You will need to create a vector map at first. If the map is used without creating, errors will occur.

The initial size is the size of the hash table used internally to store vectors. Note that the size is not an actual size of the map.

When the current size of the map reaches the initial size * the load factor, the size of the hash table will be expanded automatically.

Data Element/List/Map

Data List/Map can store Data Elements. You can create data elements from boolean, double, float, int and string.

Note that a data list can only store one element type. For example, if you add a double element to a data list at first, after that only double can be added.

Moreover, when you add data to data lists, need to use the current size of the list. You can get the size using the data list procedures