Level Design / Level Routine Editing / Routine Action Editing / Item Actions
 
When the Item Actions item is selected in the Level Routines Window's Actions to Perform column, the following set of controls appears in the panel on the right side of the Level Routines window. These controls are used to configure actions that give items to the player or create new items when the selected routine is performed in the game.


Give Item To Player Checkbox

Determines whether an item is given to the player when the selected routine is performed

Type of Item To Give To Player Pop-Up Menu

Determines which type of item is given to the player when the selected routine is performed. The Edit button may be used to edit the game project's item types.

Item Value Field

Determines the value of the item that is given to the player. The purpose of this field differs depending upon which item is given to the player. For example, if the item is a Hit Point Recovery Power-Up, then this field determines how many hit points the item restores. If the item is an ammo pack as in the above screen shot, this field determines how many bullets the ammo pack contains.

Create New Item Checkbox

Determines whether a new item is created when the selected routine is performed

Type Of Item To Create Pop-Up Menu

Determines which type of item is created when the selected routine is performed. The Edit button may be used to edit the game project's item types.

New Item Value Field

Determines the value of the new item. The purpose of this field differs depending upon which item is created. For example, if the item is a Hit Point Recovery Power-Up, then this field determines how many hit points the item restores. If the item is an ammo pack as in the above screen shot, this field determines how many bullets the ammo pack contains. In this case, entering a negative value takes ammo away from the player. If all of the ammo is removed from a weapon that disappears when out of ammo, the player will drop that weapon.

Create Item At Fixed Location Radio Button

Determines whether a pair of fixed coordinates are used to determine the location of the new item when the selected routine is performed

Item Location X and Y Fields

Determines the location of the new item

Use a Pair Of Variables To Determine Location Radio Button

Determines whether a pair of variables is used to set the location of the new item when the selected routine is performed

Item Variable Location X and Y Pop-Up Menus

Determines which variables are used to set the location of the new item when the selected routine is performed

Current Horizontal Speed Field

Determines the rightward speed of the item that is created when the selected routine is performed

Current Downward Speed Field

Determines the downward speed of the item that is created when the selected routine is performed

Ticks Before Disappearing Field

Determines the number of ticks that must pass before the disappearance of the item that is created when the selected routine is performed. There are 30 ticks per second. Enter a value of -1 to make the item stay on the screen indefinitely.

Gravitational Acceleration Field

Determines how much downward speed the item gains with the passing of each tick. There are 30 ticks per second.

Maximum Downward Speed Field

Determines the maximum speed at which the item can fall downwards as a result of gravitational acceleration, as measured in pixels per tick. There are 30 ticks per second.

Point Value Field

Determines how many points the player earns by collecting the item that is created when the selected routine is performed.

Only Create Item If Item Would Be On Screen Checkbox

Determines whether the new item is only created if it would be on the screen. This checkbox should be checked if this routine is performed often, to prevent a huge number of items from being created while the player is elsewhere.
 
More information on items is available in the Elements of a Game section.