Lvl npc.ini (Config pack)

From PGE Wiki
Jump to navigation Jump to search

lvl_npc.ini - Definition of Non-playable characters for levels.

Header with common settings

[npc-main]
Parameter Allowed values Example value Description
total >=1 total = 292 Total number of defined NPC's. Allocate NPC-ID range which should be used to define NPC's
config-dir string config-dir = "items/npc" Enables split config mode (using a set of npc-*.ini files in the specified directory instead finding sections in the same INI-file)
extra-settings string extra-settings = "items/npc" 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.
grid >=1 grid = 32 Default alignment grid size for all NPCs without defined "grid" field.
coin-in-block >=1 coin-in-block = 10 Default coin NPC for coins block
physics-gravity-acceleration floating point number physics-gravity-acceleration = 16.25 Gravity acceleration on fall
physics-max-fall-speed floating point number physics-max-fall-speed = 8 Max falling speed of NPCs
effect-lava-burn >=0 effect-lava-burn = 13 Spawn effect ID when NPC contacts with lava blocks and dies
projectile-sound-id >=0 projectile-sound-id = 0 Play sound on projectile generation
projectile-speed floating point number projectile-speed = 10.0g Initial speed of shooted NPC
talking-sign-image string talking-sign-image = "excl.png" Filename of image file in the common images folder which will be shown to player when it touches a talkable NPCs


Note: When the split mode is used, this file will contain only one [npc-main] section and will don't store NPC entries anymore. Read more about NPC entry config files here.

Settings of each NPC (Where '*' - should be a NPC-ID from 1 to total number of NPCs)
You should define settings for all allocated NPC-ID range!

[ npc-* ]
Parameter Allowed values Example value Description
* * * = * Specification of content of theese sections are fully repeats the specification of NPC entry config files.