Lvl effects.ini (Config pack)
Jump to navigation
Jump to search
lvl_effects.ini - Definition of graphical effects for levels.
Note: This configuration reference has not been completely finished and is subject to be changed at any time
| [effects-main] | |||
|---|---|---|---|
| Parameter | Allowed values | Example value | Description |
| total | [>=0] | total = 148 | Allocate number of EFFECT-ID's to define effects |
Default effect profiles | |||
| default-... | [>=0] | default-... = 42 | Default effect for calling of non-existing effect or for all undefined special effects. |
| smoke-... | [>=0] | smoke-... = 42 | Default effect for the smoke effect. |
| water-splash-... | [>=0] | water-splash-... = 42 | Default effect for the smoke effect. |
| player-transform-... | [>=0] | player-transform-... = 42 | Default effect for the player transformation effect. |
| ground-slide-... | [>=0] | ground-slide-... = 42 | Default effect shown when player sliding on the ground. |
| stomp-... | Effect profile | stomp-... = ... | Default effect for the stomp action. |
| smash-... | Effect profile | smash-... = ... | Default effect for the smash event. |
| block-destroy-... | Effect profile | block-destroy-... = ... | Default effect for block destroying. |
| block-coin-hit-... | Effect profile | block-coin-hit-... = ... | Default effect for block coin hit. |
Effect profiles
Effect profiles - the set of parameters defined inside of the same group. They may also appear at lvl_characters.ini too.
| [Effect Profile] | |||
|---|---|---|---|
| Parameter | Allowed values | Example value | Description |
Effect profile. Every effect profile contains these parameters. | |||
| ...-effect-function | string | ...-effect-function = callMe | Lua callback to build the complex effect. |
| ...-effect-id | >=0 | ...-effect-id = 42 | Lua callback to build the complex effect. |
| ...-effect-start-delay | >=0 | ...-effect-start-delay = 0 | Millisecond delay before effect spawn. |
| ...-effect-start-x | double | ...-effect-start-x = +4.2 | Relative spawn X offset. |
| ...-effect-start-y | double | ...-effect-start-y = -4.2 | Relative spawn Y offset. |
| ...-effect-animation-loops | integer | ...-effect-animation-loops = 1 | Count of animation loops. |
| ...-effect-delay | integer | ...-effect-delay = 0 | Life time limit. 0 is unlimited. |
| ...-effect-frame-delay | >=1 | ...-effect-frame-delay = 1 | Delay between animation frames in milliseconds. |
| ...-effect-framespeed | >=1 | ...-effect-framespeed = 1 | Alias to ..-effect-frame-delay. |
| ...-effect-velocity-x | double | ...-effect-velocity-x = 0.0 | Move effect object horizontally with a speed value in pixels per 1/65 of second. |
| ...-effect-velocity-y | double | ...-effect-velocity-y = 0.0 | Move effect object vertically with a speed value in pixels per 1/65 of second. |
| ...-effect-z-index | double | ...-effect-z-index = 0.0 | Absolute Z-value of the effect spawn. |
| ...-effect-gravity | double | ...-effect-gravity = 0.0 | A vertical speed increment value that adds value to Y velocity per 1/65 of second. |
| ...-effect-direction | -1 or 1 | ...-effect-direction = 1 | For two-side sprites, set the direction: left -1, or right +1. |
| ...-effect-min-vel-x | double | ...-effect-min-vel-x = 0.0 | Minimal limit for horizontal velocity value. 0 is no limit. |
| ...-effect-min-vel-y | double | ...-effect-min-vel-y = 0.0 | Minimal limit for vertical velocity value. 0 is no limit. |
| ...-effect-max-vel-x | double | ...-effect-max-vel-x = 0.0 | Maximal limit for horizontal velocity value. 0 is no limit. |
| ...-effect-max-vel-y | double | ...-effect-max-vel-y = 0.0 | Maximal limit for vertical velocity value. 0 is no limit. |
| ...-effect-decelerate-x | double | ...-effect-decelerate-x = 0.0 | Horizontal velocity decelerate per 1/65 of second until it reaches zero or minimal value. |
| ...-effect-decelerate-y | double | ...-effect-decelerate-y = 0.0 | Vertical velocity decelerate per 1/65 of second until it reaches zero or minimal value. |
| ...--effect-frame-sequence | int-array | ...--effect-frame-sequence = "0,1,2,3,4,5" | Custom frame sequence with a list of frame indeces at 0. |
Effect entry
Settings of each effect (Where '*' - should be a EFFECT-ID from 1 to total number of effects)
You should define settings for all allocated EFFECT-ID range!
| [effect-*] | |||
|---|---|---|---|
| Parameter | Allowed values | Example value | Description |
| * | * | * = * | Specification of content of theese sections are fully repeats the specification of Effect entry config files. |