Add game 'life' api reference (#1569)
This commit is contained in:
committed by
Peli de Halleux
parent
a8d64c8ae9
commit
08e9c9c416
33
docs/reference/game/remove-life.md
Normal file
33
docs/reference/game/remove-life.md
Normal file
@ -0,0 +1,33 @@
|
||||
# remove Life
|
||||
|
||||
Decrease the number of lives remaining by some amount.
|
||||
|
||||
```sig
|
||||
game.removeLife(0)
|
||||
```
|
||||
|
||||
The life count in the game is decreased by the number of lives you say. If the life count reaches `0` when these lives are removed, then the game is over.
|
||||
|
||||
## Parameters
|
||||
|
||||
* **life**: a [number](/types/number) to remove from the count.
|
||||
|
||||
## Example #example
|
||||
|
||||
Take away `20` lives count if the player's score reaches `10000` points.
|
||||
|
||||
```blocks
|
||||
let giveLives = true
|
||||
|
||||
if (game.score() > 9999) {
|
||||
if (giveLives) {
|
||||
game.removeLife(20)
|
||||
giveLives = false
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## See also #seealso
|
||||
|
||||
[set life](/reference/game/set-life),
|
||||
[add life](/reference/game/add-life)
|
Reference in New Issue
Block a user