3. Configuration

3.1 Timings

Some values below are expressed as a comma-separated list of numbers, each of which corresponds to a different level. Keys which have a default value of more than one number or of a number followed by a comma may be set for each level.  The first number in a list is used for the demonstration level, and the following numbers are for the interactive game levels (the second value is used for level 1, the third for level 2 and so on). The maximum number of levels is defined by the value of the key "Levels". 
 

Key	Description	Default Value
SpeedMS	Duration of a single cycle (a "Tick"), in milliseconds. All other timings in the game are multiples of the single cycle duration.  Decreasing the value speeds up the game and increasing the value slows down the game.	20,
PacmanTicks	Number of cycles until the next move of the pacman.  Increasing the value makes the pacman move slower and decreasing the value makes the pacman move faster.	3,
RemTicks	Number of cycles for a monster to return to prison after being eaten by the pacman (the R.E.M. -- rapid eye movement -- phase).  Increasing the value increases the time until a eaten monster returns to prison and decreasing the value decreases the time until a monster returns to prison.	1,
DangerousTicks	Number of cycles until the next move of the monsters when they are dangerous and will eat the pacman.  Increasing the value makes the monsters move slower and decreasing the value makes the monsters move faster.	3,
HarmlessTicks	Number of cycles until the next move of the monsters when they are harmless and can be eaten by the pacman.  Increasing the value makes the monsters move slower and decreasing the value makes the monsters move faster.	7,6,,5,,4,
HarmlessDurationTicks	Number of cycles during which the monsters remain harmless and can be eaten by the pacman after the pacman eats a switch.  Increasing this value makes the monsters stay harmless longer and decreasing this value makes the monsters return to being dangerous sooner.	375,,,300,,250,200,150,
HarmlessWarningTicks	Number of cycles in which the user is warned of the upcoming end of the harmless-phase by the monsters blinking. This value must be less at each level than the corresponding "HarmlessDurationTicks".  Increasing this value increases the length of the warning and decreasing this value shortens the length of the warning.	135,
ArrestTicks	Number of cycles until the next move of the monsters when they are in prision.	6,
ArrestDurationTicks	Number of cycles in which monsters remain in prison after being eaten. This value will be multiplied by the id of the monster eaten ( 0 for first monster eaten after the pacman eats a switch, 1 for the second, and so on), so that the first monster will be freed immediatly and the other monsters have to wait longer (by way of exception the second monster is also freed immediatly during the initial stage of the game).  Increasing this value increases the prison time of the monsters, and decreasing this value frees the monsters sooner.	200,,,150,
FruitAppearsTicks	Number of cycles between the appearence of fruit.  Increasing this value causes fruit to appear less frequently and decreasing this value causes fruit to appear more frequently.	1000,,1500,2000,2500,  3000,3500,4000,
FruitDurationTicks	Number of cyles for which fruit remains.  Increasing this value causes the fruit to be available for consumption longer and decreasing this value causes the fruit to disappear sooner.	500,,,400,350,300,,250,  200,150,
FruitScoreDurationTicks	Number of cycles for which the score for eating a fruit is displayed after a fruit is eaten.	150,
MonsterScoreDurationMS	Number of milliseconds for which the score for eating a monster is displayed after a monster is eaten.	1000
PlayerDurationMS	Number of milliseconds for displaying "PLAYER ONE" at the start of the game. At the moment only one player is supported.	3000
ReadyDurationMS	Number of milliseconds for displaying "READY!" at the start of the game.	2000
GameOverDurationMS	Number of milliseconds for displaying "GAME OVER" at the end of the game.	3000
AfterPauseMS	Number of milliseconds until play is resumed after cancelling a "Pause".	1000
DyingPreAnimationMS	Number of milliseconds for which the monsters dance after catching the pacman.	1000
DyingAnimationMS	Number of milliseconds in which the scenes (other than the first and last scenes) of the pacman's death are displayed after he is caught by a monster.	100
DyingPostAnimationMS	Number of milliseconds in which the first and last scenes of the pacman's death are displayed after he is caught by a monster (this permits emphasis of these scenes).	500
IntroAnimationMS	Number of milliseconds between the scenes of the introduction.	800
IntroPostAnimationMS	Number of milliseconds between the introduction and the beginning of the demonstration.	1000
LevelUpPreAnimationMS	Number of milliseconds between completing a level and the beginning of the animation for the next level.	2000
LevelUpAnimationMS	Number of milliseconds for which the animation for changing levels is displayed.	2000
MonsterIQ	The intelligence of the monster (currently not fully implemented).  Increasing the value makes the monsters more clever and decreasing the value makes them dumber.	0,170,180,170,180,  170,180,
Levels	Number of different levels (without the demonstration).  If you increase this value be sure all the parameters for that level are defined above!	13
HallOfFameMS	The hall of fame is displayed this amount of milliseconds.	7000
CursorBlinkMS	Number of milliseconds the cursor, used for editing your name in the hall of fame, keeps his states (on or off). The repeating of keystrokes for scrolling (Key_Up and Key_Down) also depends of this value.	250

If there are insufficient values in a list for the number of levels (including the demonstration level), or if there is an invalid or missing (e.g., ",,") in the list, then the previous (valid) value is used for that position. If no valid values are listed, the value will be 0.  For example "HarmlessTicks=7,6,,5,,4" is equivalent to "HarmlessTicks=7,6,6,5,5,4,4,4 (if Levels=7)". That means 7 cycles for the demonstration, 6 cycles for level 1 and so on. 

3.2 Points (Scoring)

3.3 Graphic schemes

Each graphic scheme is defined in a seperate scheme-group using the group designation [Scheme N], where N is the number of the scheme being defined.  Each scheme-group may have the following keys: 
 

Key	Description	Example
Font	Filename of the xbm-font. Names without an absolute path (a leading "/" or "~") are relative to $KDEDIR/share/apps/kpacman/fonts.  The structure of the fontfile will be explained in one of the next releases, but you should be able to figure it out by opening one of the fontfiles included with KPacman using a bitmap-editor.	font.xbm
FontFirstChar	Defines the numeric value of the first character in the bitfont.	14
FontLastChar	The last character in the bitfont, is giving here by its numeric code. If you extent the fonts by adding the lowercase characters, this value must be changed.	95
PixmapDirectory	Directory in which the pixmap-files for the figures are located.  Direcotry names without an absolute path (a leading "/" or "~") are relative to $KDEDIR/share/apps/kpacman/pics. The names of the individual xpm-files are fixed in the code at the moment (this will be changed) and are ''down.xpm" for an arrow pointing down, "fruit.xpm" for the series of fruit for the various levels, "lifes.xpm" for the image to display at the bottom of the screen for each pacman life remaining, "point.xpm" for the small points which the pacman eats, "switch.xpm" for the switch points, "dying.xpm" for the sequence of images for a dying pacman, "left.xpm" for an arrow pointing left, "monster.xpm" for the various monsters, including their appearance during the "switch" and "warning" cycles, "prison.xpm" for a series of images put together to draw the prison walls, "up.xpm" for , "eyes.xpm" for the series of eyes for the monsters when they move up, down, right and left, respectively, "level.xpm" for the row of fruit at the bottom of the screen indicating the current level, "pacman.xpm" for the series of pacman images (gobbling and normal x moving up, down, left and right), "right.xpm for a right arrow, and "wall.xpm" for a series of images put together to draw the non-prison walls.	tiny
Description	The name of the scheme, which will be displayed in the menu "Select Graphic Scheme". Use the '&'-character in front of a character in the name to set the accelerator-key to that character (that means pressing that key when the Select Graphic Scheme menu is down will select that scheme). You may add a location tag to the key (e.g., Description[de] to indicate that the description is in German).	MIDWAY MFG.CO. (&tiny)

3.4 Miscellaneous