Starpoint Arena - Level.ini
All levels of the game are contained in a Level-initialization file (SP_Levels.ini for 1 player game, SP_Levels2 for multiplayer game).
It contains the level properties, available random items, a field definition and enemy information.
The file structure (Lines containing --- or === should be structured as in example below)!
Level Properties:
The level properties are under a line "--Props--". Properties can be omitted if the default value should be used. The first property must be the level name.
- width - The field width (default 8, max. 10)
- height - The field height (default 8, max.10)
- enemySpeed - Speed (number of rounds between each move) of some enemies (default is 5)
- enemyIQ - "IQ" for some enemies (default is 80
- looseLives - Flag, if a life is lost when dying in the level.
- explosionEnergyLoss - energy loss when standing in an explosion caused by blue point (default 30)
- teamMode - only relevant for multiplayer game (default is false). true means that the level does not end, if only one player left.
- itemdensity - density of new items on cyan points/ at level start (default is 15).
- fogdensity - density of fogs (default is 0).
- grayEnergyLoss - energy loss on gray fields (default is 4).
- magentaEnergyGain - energy gain on magenta points (default is 4).
- levelColor - Level color (for title display, default is orange).
- roundLimit - The time limit (default is 250).
- showRounds - Flag, if round limit should be shown (default is true).
- onlyWinnerGetsPoints - Flag, if score is only added for winner of level (default is true).
- backgroundColor - Color for background (default is black).
- backgroundForeColor - Foreground color for background (default is white).
- swirling - Flag, if points swirl colors in the level (default is false).
- initialSwirlingRounds - Number of rounds, after which swirling points are stopped (defualt is 150).
- swirlingPercent - Percentage of swirling points (default is 3).
- blueSwirling - Flag, if points swirl blue colors in the level (default is false).
- blueSwirlingPercent - Percentage of blue swirling points (default is 2).
- blackRainProb - Percentage of black rains on holes (default is 15). Currently disabled!
- redHeatGain - Heat gain on red points (default is 2).
- placeItems - Flag, if items should be placed randomly on level start (default is true).
- cyanProb - Probability for new item appearance when stepping on cyan point (default is 18).
- levelSound - Sound clip name for level start (default is flashLevel).
- lastFigureWins - Flag, if last figure alive wins the level (default is true).
- onlyOnce - Flag, if level is played only once, even if player does not win (default is false).
- hasReplay - Flag, if replay should be shown for cool moves in the level (default is true).
- dontKill - Flag, if killing is forbidden in the level (default is false).
- levelText - Text to show during level intro (default is null).
- showLevelProps - Flag, if explosion stregth etc. should be shown at level start (default is false).
- directFlash - Flag, if no flash fx should be shown between levels (default is false).
- flashAnimation - Index of galaxy image animation (0-9) or -1 for none (default is -1).
- hasShop - Name of a shop as defined in Shops.ini-file.
Random items
Random items are defined in block --Items--.
Each random item is described by up to 4 properties, energy settings are optional:
ItemCleverRocket,4,400,600
- ItemCleverRocket is the item class. this might be a fully classified class name, "com.starpoints.item" is optional.
- 4 is the items probability (relatively to all other random items in the level).
- 400 is the initial energy. Optional.
- 400 is the maximum energy. Optional.
The random items are relevant for item placement at level start and for cyan points.
Concrete items
Concrete item are placed at a defined point at level start. They are described by 5 properties under a line --Iteminfo-- :
ItemPoints,10000,100000,9,2
- ItemPoints is the item class. this might be a fully classified class name, "com.starpoints.item" is optional.
- 10000 is the initial energy.
- 100000 is the maximum energy.
- 9 is the x position.
- 2 is the y position.
Enemies
Enemies in the level refer to a definition in the SP_Figures.ini-file. They consist of 4 properties in section --Enemies--
of the file:
GrayDeath,100,1,8
- GrayDeath is the reference to the figure class. This must be a figure class as defined in the SP_Figures.ini-file.
- 100 is the initial energy.
- 1 is the x position.
- 8 is the y position.
Example file snippet for one level:
===============
---------------
--Props--
Example arena
10, width
10, height
0, fogdensity
4, grayEnergyLoss
5, magentaEnergyGain
green, levelColor
120, roundLimit
false, swirling
false, blueSwirling
2, redHeatGain
false, placeItems
true, onlyOnce
flashRiddle, levelSound
false, lastFigureWins
false, hasReplay
---------------
--Field--
green,green,lightgray,green,green,lightgray,green,green,green,white
green,green,lightgray,green,green,lightgray,black,green,green,green
lightgray,lightgray,gray,lightgray,lightgray,gray,black,green,green,green
green,green,lightgray,green,green,lightgray,black,green,green,green
green,green,lightgray,green,green,lightgray,black,green,green,green
gray,gray,darkgray,lightgray,gray,gray,black,black,black,black
green,green,lightgray,green,green,lightgray,black,black,black,black
green,green,lightgray,green,green,gray,black,black,darkgray,darkgray
gray,gray,darkgray,lightgray,gray,darkgray,darkgray,darkgray,magenta,magenta
green,green,lightgray,green,green,gray,gray,darkgray,magenta,magenta
---------------
--Items--
ItemRandom,6
ItemMoney,12,80,200
ItemPoints,25,1000,2000
ItemBomb,4
ItemExtraLive,2
ItemRandomTune,2
ItemWarpPoints,4
ItemPermanentSlots,8
ItemDoubleShields,2
---------------
--Iteminfo--
ItemBombKit,100,300,4,5
ItemPoints,20000,100000,7,0
ItemPoints,20000,100000,7,3
ItemPoints,10000,100000,8,3
ItemPoints,10000,100000,9,3
ItemPoints,15000,100000,7,4
ItemPoints,10000,100000,8,4
ItemPoints,10000,100000,9,4
ItemBomb,140,1000,7,9
ItemBomb,120,1000,7,8
ItemBomb,80,1000,9,7
ItemMagentaPotion,75,250,8,9
ItemMagentaPotion,75,250,9,9
ItemNextLevel,10000,10000,6,0
------------
--Enemies--
KamikazeFigure,100,6,1
KamikazeFigure,100,1,6
KamikazeFigure,100,6,6
---------------