Lvl effects.ini (Config pack)

From Moondust Wiki
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.