# HG changeset patch
# User Wuzzy
# Date 1460994222 -3600
# Node ID 3222b4cfef8a239f144c62725e3be6c4ba16c83a
# Parent 55e67d58d19ea0d2edd349c02a44594c3acbd977
LuaAPI: Additional parameter for SpawnHealthCrate, SpawnAmmoCrate, SpawnUtilityCrate
diff -r 55e67d58d19e -r 3222b4cfef8a LuaAPI.wiki
--- a/LuaAPI.wiki Mon Apr 11 16:03:55 2016 +0100
+++ b/LuaAPI.wiki Mon Apr 18 16:43:42 2016 +0100
@@ -381,11 +381,11 @@
vgear = AddVisualGear(1000, 1000, vgtExplosion, 0, false)
-=== !SpawnHealthCrate(x, y) ===
-Spawns a health crate at the specified position. If `x` and `y` are set to 0, the crate will spawn on a random position (but always on land).
+=== !SpawnHealthCrate(x, y, [, health]) ===
+Spawns a health crate at the specified position. If `x` and `y` are set to 0, the crate will spawn on a random position (but always on land). Set `health` for the initial health contained in the health crate. If not set, the default health (`HealthCaseAmount`) is used.
-=== !SpawnAmmoCrate(x, y, ammoType) ===
-Spawns an ammo crate at the specified position with content of ammoType (see [AmmoTypes Ammo Types]). If `x` and `y` are set to 0, the crate will spawn on a random position (but always on land).
+=== !SpawnAmmoCrate(x, y, ammoType [, amount]) ===
+Spawns an ammo crate at the specified position with content of ammoType (see [AmmoTypes Ammo Types]). If `x` and `y` are set to 0, the crate will spawn on a random position (but always on land). The `amount` parameter specifies the amount of ammo contained in the crate. By default, the value set by `SetAmmo` is used. If `SetAmmo` has not been used for this ammo type, an ammo-type-dependent default value is used.
Because by default settings the number of ammo in crates is zero it has to be increased to at least one with `SetAmmo` first, see the example:
Example:
@@ -393,8 +393,8 @@
SetAmmo(amGrenade, 0, 0, 0, 1) -- see below
SpawnAmmoCrate(0, 0, amGrenade) -- x=y=0 means random position on map
-=== !SpawnUtilityCrate(x, y, ammoType) ===
-Spawns an utility crate at specified position with content of ammoType. If `x` and `y` are set to 0, the crate will spawn on a random position (but always on land).
+=== !SpawnUtilityCrate(x, y, ammoType [, amount]) ===
+Spawns an utility crate with some ammo at the specified position. The function behaves exactly like `SpawnAmmoCrate`, the only difference is the appearance of the crate.
Example: