Parameter Types

Skill parameters (skill_parameters) define values that can change by skill level and can be referenced by scripts, costs, and display templates.

Types

Type	Aliases	Description
expression	expr, formula	Math expression using variables such as %level%.
string	str, text	String value.
random_text	random_lines, random_line, text_lines, random_text_lines	Randomly selects one line.
random_char	random_chars, char_random, chars_random	Picks one candidate with equal probability.
weighted_random_char	weighted_random_chars, weighted_char, weighted_chars, weighted_char_random	Picks one candidate by weight.
conditional_char	condition_char, case_char, if_char	Picks one candidate by condition branch.
boolean	bool, flag	Boolean value with expression support.
constant	const, fixed	Fixed value. Unrecognized type values also fall back to this.
range	—	Range value.
uniform	—	Uniform random number.
gaussian	normal	Gaussian random number.
skew_normal	skewnormal	Skew-normal random number.
triangle	—	Triangle distribution random number.

string, random_text, random_char, weighted_random_char, conditional_char, and boolean are non-numeric types; min, max, and decimals do not apply to them.

Fields

Field	Description
type	Parameter type.
value	Value or expression.
min	Lower clamp.
max	Upper clamp.
decimals	Decimal precision; 0 means integer-like output.
default	Fallback value when parsing fails.

Examples

skill_parameters:
  damage:
    type: expression
    value: "10 + %level% * 5"
    min: 10
    max: 100
    decimals: 0
  bonus_damage:
    type: uniform
    value: "5~15"
    decimals: 0
  cast_message:
    type: random_text
    values:
      - "<red>Flame Burst!"
      - "<red>Burn!"
  is_aoe:
    type: boolean
    value: "%level% >= 5"

Using parameters in scripts

Parameters can be referenced in action lines, conditions, and text with %parameter% syntax:

script:
  actions:
    cast:
      - 'damage amount=%damage%'
      - '@if="%is_aoe% == true" particle particle=EXPLOSION at=target count=10'

Level overrides

upgrade:
  max_level: 10
  levels:
    5:
      parameters:
        damage:
          value: "50 + %level% * 8"