java-commons/muscript
2022-06-03 19:54:31 +02:00
..
src [muscript] First iteration, seems to work 2022-06-03 19:54:31 +02:00
build.gradle [muscript] First iteration, seems to work 2022-06-03 19:54:31 +02:00
README.md [muscript] First iteration, seems to work 2022-06-03 19:54:31 +02:00

μScript

MuScript was created to allow respackopts pack authors to specify conditions for loading resources in a more human-friendly manner than the previous json tree-based system. It is intended to be vaguely like java in its syntax, though it deviates in some aspects. The language is parsed into an AST representation which is executed in-place, no compilation is performed. MuScript supports outputting data using various types, not just strings or booleans

Value types

This DSL supports numbers (double), booleans, strings, objects, lists and functions. The topmost operator of a condition must always return a boolean for it to be valid in the context of respackopts. The values of input data are according to the pack config. String literals may be written with quotation marks as follows: "some text" or 'some text' Numbers may be written as follows: 103 or 10.15 Booleans may be written either as true or false Objects, lists and functions cannot be created manually but may be provided to the script as parameters or from functions. Additionally, function parameters will automatically be packed in a list

Please ensure you use proper whitespace, as this might behave unexpectedly otherwise.

Operators

Numbers support the following operators (x and y are numbers):

  • Addition: x + y
  • Subtraction: x - y
  • Multiplication: x * y
  • Division: x / y
  • Modulo: x % y
  • Power: x ^ y
  • Inversion: -x
  • Greater than: x > y
  • Greater than or equal: x >= y
  • Less than: x < y
  • Less than or equal: x <= y
  • Equality: x == y
  • Inequality: x != y

Strings support the following operators (x and y are strings, a is any value):

  • Equality: x == y
  • Inequality: x != y
  • Concatenation: x || a or a || x

Booleans support the following operators (x and y are booleans, a and b are values of the same type):

  • Conditional: x ? a : b
  • Inversion: !x
  • And: x & y
  • Or: x | y
  • Equality (=XNOR): x == y
  • Inequality (=XOR): x != y

Objects support the following operators (x is an object with an entry called entry):

  • Value access via .: x.entry
  • Value access via square brackets: x["entry"] (also supports other types)

Parentheses (()) may be used to indicate order of operation

Namespacing is done using double colons like in c++ (namespace::value), though it should not be used