Wld levels.ini (Config pack)

From PGE Wiki
Jump to navigation Jump to search

wld_levels.ini - Definition of level points for world maps.

[ levels-main ]
Parameter Allowed values Example value Description
total >=1 total = 32 Allocate LEVEL-ID's to define level enter points.
grid >=1 grid = 32 Default alignment grid size for all level points without defined "grid" field.
path >=0 path = 0 Choice a LEVEL-ID's to reserve it as "background path" picture.
bigpath >=0 bigpath= 29 Choice a LEVEL-ID's to reserve it as "BIG background path" picture.
config-dir string config-dir = "items/levels" Enables split config mode (using a set of level-*.ini files in the specified directory instead finding sections in the same INI-file)
extra-settings string extra-settings = "items/levels" Relative path to folder where are extra settings JSON layouts are stored. If the field didn't define, the value of `config-dir` will be used. When it's also empty too, extra settings will not work.

Note: in the split mode or in the custom level/episode level-*.ini config file, section name is always level.

Settings of each level (Where '*' - should be a LEVEL-ID from 0 to total number of levels)
You should define settings for all allocated LEVEL-ID range! (Be careful! Unlike other items, level items iteration begins from 0!)

[ level-* ]
Parameter Allowed values Example value Description
group string group = "Common levels" Name of organizing group (reserved)
category string category = "Blue" Name of organizing category (reserved)
description string description = "Just blue" A short description about this element.
extra-settings string extra-settings = "mylayout.json" Filename of GUI layout for extra settings if they are needed for this element.
is-meta-object boolean is-meta-object = false Make this element be meta-object: It will be hidden on exported images/screeshots in dependence from a choice.
image string image = level-1.gif Filename of level picture
grid >=1 grid = 32 Size of align grid
animated [0,1] animated = 0 Enable sprite animation for this tile
frames >=1 frames = 1 Total number of frames on sprite
frame-delay >=1 frame-delay = 128 Delay between animation frames in milliseconds
frame-speed >=1 frame-speed = 128 Alias to frame-delay
framespeed >=1 framespeed = 8 Delay between animation frames in 1/65 seconds
display-frame >=0 display-frame = 0 Default frame index for disabled animation mode in the editor
frame-sequence string, sequence of integers frame-sequence = "1,3,2,0" Initial custom animation frames sequence (first frame is 0, last is n-1). Empty string is usage of default sequence.