BIS fnc spawnEnemy: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "|= Game name" to "|Game name=")
m (Remove 'broken' warning)
 
(30 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Function|= Comments
{{RV|type=function
____________________________________________________________________________________________


| arma2oa |Game name=
|game1= arma2oa
|version1= 1.50


|1.00|= Game version
|game2= tkoh
____________________________________________________________________________________________
|version2= 1.00


| Spawns enemies around a player according to array of enemy classes. The units will try to hunt down the player.
|game3= arma3
{{warning|This function is broken (at least in {{arma3}}) as it uses an undefined variable, displaying an error on each use!  (typo '''line 30''', {{Inline code|_players}} )}} |DESCRIPTION=
|version3= 0.50
____________________________________________________________________________________________


| [aPlayer, target, side, classes, maxEnemies, delay, code] call [[BIS_fnc_spawnEnemy]] |SYNTAX=
|gr1= Object Manipulation


|p1= aPlayer: [[Object]] - player |PARAMETER1=
|descr= Constantly spawns enemies around a player according to array of enemy classes. The units will try to hunt down the player.


|p2= target: [[Object]] - refence object (enemies will be spawned on same direction in respect to the player) |PARAMETER2=
|exec= spawn


|p3= side: [[Side]] - side of the spawned enemies |PARAMETER3=
|s1= [aPlayer, target, side, classes, maxEnemies, delay, code] spawn [[BIS_fnc_spawnEnemy]]


|p4= classes: [[Array]] of [[String]] - list of enemy classes (units will form a group together) |PARAMETER4=
|p1= aPlayer: [[Object]] - a unit that [[isPlayer|is a player]]


|p5= maxEnemies: [[Number]] - (Optional, default 10) maximum number of enemies at once |PARAMETER5=
|p2= target: [[Object]] - reference object (enemies will be spawned on same direction in respect to the player)


|p6= delay: [[Number]] - (Optional, default 30) time between spawn waves |PARAMETER6=
|p3= side: [[Side]] - side of the spawned enemies


|p7= code: [[Code]] - (Optional, default {}) - code to execute on each unit (referenced by [[_this]]) |PARAMETER7=
|p4= classes: [[Array]] of [[String]]s - list of enemy classes (units will form a group together)
{{Feature|important|Classes must be of the defined ''side'', otherwise they will attack each other.}}


| [[Array]] - spawned enemies |RETURNVALUE=
|p5= maxEnemies: [[Number]] - (Optional, default 10) maximum number of enemies at once
____________________________________________________________________________________________


|x1= <code><nowiki>[</nowiki>[[player]], [[player]], [[opfor]], ["O_Soldier_F"]] [[spawn]] [[BIS_fnc_spawnEnemy]];</code> |EXAMPLE1=
|p6= delay: [[Number]] - (Optional, default 30) time between spawn waves
____________________________________________________________________________________________


| [[BIS_fnc_spawnGroup]], [[BIS_fnc_stalk]] |SEEALSO=
|p7= code: [[Code]] - (Optional, default {}) - code to execute on each unit (referenced by [[Magic Variables#this|_this]])
}}


<h3 style="display:none">Notes</h3>
|r1= [[Nothing]]
<dl class="command_description">
<!-- Note Section BEGIN -->


<!-- Note Section END -->
|x1= <sqf>[player, player, opfor, ["O_Soldier_F"]] spawn BIS_fnc_spawnEnemy;</sqf>
</dl>


<h3 style="display:none">Bottom Section</h3>
|seealso= [[BIS_fnc_spawnGroup]] [[BIS_fnc_stalk]]
[[Category:Function Group: Spawning|{{uc:spawnEnemy}}]]
}}
[[Category:Functions|{{uc:spawnEnemy}}]]
[[Category:{{Name|arma2oa}}: Functions|{{uc:spawnEnemy}}]]
[[Category:{{Name|tkoh}}: Functions|{{uc:spawnEnemy}}]]
[[Category:{{Name|arma3}}: Functions|{{uc:spawnEnemy}}]]
[[Category:Broken_Functions]]

Latest revision as of 00:19, 4 February 2023

Hover & click on the images for description

Description

Description:
Constantly spawns enemies around a player according to array of enemy classes. The units will try to hunt down the player.
Execution:
spawn
Groups:
Object Manipulation

Syntax

Syntax:
[aPlayer, target, side, classes, maxEnemies, delay, code] spawn BIS_fnc_spawnEnemy
Parameters:
aPlayer: Object - a unit that is a player
target: Object - reference object (enemies will be spawned on same direction in respect to the player)
side: Side - side of the spawned enemies
classes: Array of Strings - list of enemy classes (units will form a group together)
Classes must be of the defined side, otherwise they will attack each other.
maxEnemies: Number - (Optional, default 10) maximum number of enemies at once
delay: Number - (Optional, default 30) time between spawn waves
code: Code - (Optional, default {}) - code to execute on each unit (referenced by _this)
Return Value:
Nothing

Examples

Example 1:
[player, player, opfor, ["O_Soldier_F"]] spawn BIS_fnc_spawnEnemy;

Additional Information

See also:
BIS_fnc_spawnGroup BIS_fnc_stalk

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note