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 total 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. Function can be 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 .. Example: player.name.

Operators

There are 5 total 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 ().

Comparing values

There are 6 total 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.

Conditional operator

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

Standard variables

There are a few standard variables defined in StandardLib:

• 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.