Expressions

With one pattern
With multiple patterns
Property expression
Syntax
[local] [(plural|non(-|[ ])single))] expression <pattern>:
  return type: <skript type (cannot be a java type)> # optional
  loop of: <text> # optional
  parse:
    # code, optional
  get:
    # code, optional
  add:
    # code, optional
  set:
    # code, optional
  remove:
    # code, optional
  remove all:
    # code, optional
  delete:
    # code, optional
  reset:
    # code, optional
Syntax
[local] [(plural|non(-|[ ])single))] expression:
  patterns:
    # patterns, one per line
  return type: <skript type (cannot be a java type)> # optional
  parse:
    # code, optional
  get:
    # code, optional
  add:
    # code, optional
  set:
    # code, optional
  remove:
    # code, optional
  remove all:
    # code, optional
  delete:
    # code, optional
  reset:
    # code, optional
Syntax
[local] <skript types> property <pattern>:
  return type: <skript type> # optional
  parse:
    # code, optional
  get:
    # code, optional
  add:
    # code, optional
  set:
    # code, optional
  remove:
    # code, optional
  remove all:
    # code, optional
  delete:
    # code, optional
  reset:
    # code, optional
Property expressions have two patterns:
[the] <pattern> of %$<skript types>%
%$<skript types>%'[s] <pattern>
When property expressions are used, if multiple inputs are passed, the get section is called multiple times with each individual input passed as the first expression.
expression-1 is always the object the property belongs to, even when the[the] <pattern> of %$<skript types>% form is used.
Flag local
Specifying that an expression is local makes the expression only usable from within the script that it is defined in. This allows you to create expression that do not interfere with expressions from other addons or scripts.
Local expressions are guaranteed to be parsed before other custom expressions, but not necessarily before expressions from other addons.
Flag plural/non-single
Specifying that an expression is plural or non-single indicates that the expression may return more than one value regardless of context.
$ type modifier
If the expression is single or non-single depending on whether the input is single or non-single, you may prefix the type with a $.
example.sk
expression uppercase %$strings%:
  # ...
In the above example, uppercase "test" would be single and uppercase ("hello" and "world") would be non-single.
Option return type
Specifying a return type restricts the possible values that an expression returns, allowing Skript to potentially resolve type conflicts or perform optimizations.
In most cases, explicitly specifying a return type is unnecessary.
Option loop of
If the expression is non-single, this option specifies an alias that may be used if the expression is looped.
example.sk
plural expression test points:
  loop of: point
  
on script load:
  loop test points:
    # You may use "loop-point" instead of "loop-value" here
Section parse
Code in this section is executed whenever the effect is parsed. This section may be used to emit errors if the effect is used in an improper context.
If this section is included, you must also continue if the effect was parsed successfully.
Local variables created in this section are copied by-value to other sections.
example.sk
effect example:
  parse:
      set {_test} to 1
  get:
    # {_test} always starts at 1 here
    add 1 to {_test}
    # 2 is always returned 
    return {_test}
Section get
Code in this section is executed whenever the expression's value is read. This section must return a value and must not contain delays.
Return
Syntax
return [%objects%]
Section add/set/remove/remove all/delete/reset
Code in these sections is executed whenever the expression is changed using Skript's change effect (or by other means).
Change Value
Syntax
[the] change value[s]
Represents the value (or values) that the expression is being changed by.
If multiple change values are expected, use the plural form of the expression change values instead of the singular change value.
Conditions
Computed Options
Last updated 8 months ago
Expressions

Flag `local`

Flag `plural`/`non-single`

`$` type modifier

Option `return type`

Option `loop of`

Section `parse`

Section `get`

Return

Section `add`/`set`/`remove`/`remove all`/`delete`/`reset`

Change Value
