Home

Runtime errors

When a runtime error happens a StarscriptError exception is thrown.

Expressions

Every expression needs to be surrounded by {}. Expression blocks can be nested where other expressions are required.

Variables

Variables can be simply accessed by their name anywhere in an expression. They can be different every time they are used. You cannot assign new values to variables. When the script tries to access a variable that doesn't exist, it throws a StarscriptError with a descriptive message.

Values

There are 6 value types:

Null

Null represents nothing and is not used by default anywhere.

Booleans

Can only be true or false.

Numbers

In Java, Starscript numbers are defined as double. When a number with no decimal places is printed it doesn't append .0 after it, unlike in Java.

Strings

String is just a bunch of text surrounded by ' or ".

Functions

Functions can only be defined in Java and can take any number of arguments. Functions are called like this: foo(), bar(5, true).

Maps

Maps can only be defined in Java and act as a collection of other values. Values inside a map are accessed using ., for example: player.name.

Operators

There are 5 operators:

• Addition +: Will add 2 strings or 2 numbers together.
• Subtraction -: Will subtract 2 numbers.
• Multiplication *: Will multiply 2 numbers.
• Division /: Will divide 2 numbers.
• Remainder %: Will calculate a remainder after a division of 2 numbers.
• Exponentiation ^: Will raise the first number to the power of the second number.

Operators follow standard precedence and can be grouped inside parentheses ().

Conditional operator

A value can be generated conditionally as <condition> ? <expression when condition is true> : <expression when condition is false>. Example: happy ? 'happy' : 'sad'.

Comparators

There are 6 operators:

• Equals ==: Will check if two values are equal.
• Not equals !=: Will check if two values are not equal.
• Greater >: Will check if the first number is greater than the second.
• Greater equal >=: Will check if the first number is greater or equal to the second.
• Less <: Will check if the first number is less than the second.
• Less equal <=: Will check if the first number is less or equal to the second.

Standard variables

There are 9 standard variables:

• PI: Variable that hold the number of PI.
• round(number), round(number, decimalPlaces): Rounds a number to 0 or the specified number of decimal places.
• floor(number): Removes decimal places from a number without rounding.
• ceil(number): Always rounds up.
• abs(number): Returns the absolute value of a number.
• toUpper(string): Makes every character in a string uppercase.
• toLower(string): Makes every character in a string lowercase.
• contains(string, string): Checks if the first string contains the second one.
• replace(string, string, string): Replaces every occurrence of the second string with third string in the first string.

Standard variables are defined in StandardLib.