createAgent: Difference between revisions
Jump to navigation
Jump to search
Lou Montana (talk | contribs) m (Text replacement - "<code>([^<]*)\[\[([a-zA-Z][a-zA-Z0-9_]+)\]\]([^<]*)<\/code>" to "<code>$1$2$3</code>") |
Lou Montana (talk | contribs) m (Text replacement - "(\|[pr][0-9]+ *= *[^- ]*) *- *P([a-gi-z ])" to "$1 - p$2") |
||
| (31 intermediate revisions by 2 users not shown) | |||
| Line 17: | Line 17: | ||
|gr1= Object Manipulation | |gr1= Object Manipulation | ||
|descr= Creates an agent of the given type. An agent does not have a group or leader or the standard soldier [[FSM]] associated with it - for instance, an enemy soldier spawned as an agent has limited AI and will do nothing when fired upon - which can be useful to limit the amount of AI processing being done in a mission with very large numbers of "AI". | |descr= Creates an agent of the given type. An agent does not have a group or leader or the standard soldier [[FSM]] associated with it - for instance, an enemy soldier spawned as an agent has limited AI and will do nothing when fired upon - which can be useful to limit the amount of AI processing being done in a mission with very large numbers of "AI". Animals are also commonly created as agents. | ||
{{Feature | | {{Feature|informative| | ||
* Players assigned to an agent using [[selectPlayer]] will be able to control the agent, operate weapons and other actions, but will not be able to access their inventory using the gear screen. | |||
* To create objects of type {{hl|"Logic"}}, use [[createUnit]]. | |||
}} | |||
|s1= [[createAgent]] [type, position, markers, placement, special] | |s1= [[createAgent]] [type, position, markers, placement, special] | ||
| Line 28: | Line 31: | ||
|p4= markers: [[Array]] - if the markers array contains any markers, the position is randomly picked from array of given markers plus desired placement position. If any of the markers were given z coordinate with setMarkerPos, the vehicle will also be created at given z coordinate. | |p4= markers: [[Array]] - if the markers array contains any markers, the position is randomly picked from array of given markers plus desired placement position. If any of the markers were given z coordinate with setMarkerPos, the vehicle will also be created at given z coordinate. | ||
|p5= placement: [[Number]] - | |p5= placement: [[Number]] - placement radius, the unit is randomly place in a circle with this radius | ||
|p6= special: [[String]] - one of: | |p6= special: [[String]] - one of: | ||
| Line 36: | Line 39: | ||
|r1= [[Object]] | |r1= [[Object]] | ||
|x1= <sqf>private _agent = createAgent ["B_Soldier_F", getPosATL player, [], 0, " | |x1= <sqf>private _agent = createAgent ["B_Soldier_F", getPosATL player, [], 0, "NONE"];</sqf> | ||
|x2= <sqf>private _agent = createAgent ["Snake_random_F", ASLToAGL getPosASL player, [], 0, "CAN_COLLIDE"]; // Creates a snake at player's feet</sqf> | |||
|seealso= [[agent]] [[agents]] [[isAgent]] [[forEachMemberAgent]] [[execFSM]] [[BIS_fnc_execFSM]] | |seealso= [[agent]] [[agents]] [[isAgent]] [[forEachMemberAgent]] [[execFSM]] [[BIS_fnc_execFSM]] | ||
| Line 46: | Line 51: | ||
|text= In {{arma3}}, default FSM is calling [[BIS_fnc_animalBehaviour]] script upon agent creation, which takes on some animal behavioural logic. The problem here is that it is almost impossible to make animal do what is told. Until now. Since {{arma3}} v1.32 you can set ''BIS_fnc_animalBehaviour_disable'' variable on the agent at the moment of agent creation, to override the function. | |text= In {{arma3}}, default FSM is calling [[BIS_fnc_animalBehaviour]] script upon agent creation, which takes on some animal behavioural logic. The problem here is that it is almost impossible to make animal do what is told. Until now. Since {{arma3}} v1.32 you can set ''BIS_fnc_animalBehaviour_disable'' variable on the agent at the moment of agent creation, to override the function. | ||
< | <sqf> | ||
tr = createTrigger ["EmptyDetector", player modelToWorld [0, 10, 0]]; | |||
tr setTriggerArea [5, 5, 0, true]; | tr setTriggerArea [5, 5, 0, true]; | ||
tr setTriggerActivation ["CIV", "PRESENT", true]; | tr setTriggerActivation ["CIV", "PRESENT", true]; | ||
| Line 52: | Line 58: | ||
private "_r"; | private "_r"; | ||
for "_i" from 1 to 10 do { | for "_i" from 1 to 10 do { | ||
_r = | _r = createAgent ["Rabbit_F", position tr, [], 0, "NONE"]; | ||
_r | _r setVariable ["BIS_fnc_animalBehaviour_disable", true]; | ||
rabbits | rabbits pushBack _r; | ||
}; | }; | ||
tr | tr setTriggerStatements [ | ||
" | "if (rabbits isEqualTo thisList) exitWith { | ||
_r = thisList | _r = thisList select floor random count thisList; | ||
_r | _r moveTo (_r modelToWorld [2.5 - random 5, 2.5 - random 5, 0]); | ||
}; | }; | ||
_esc = rabbits - thisList; | _esc = rabbits - thisList; | ||
doStop _esc; | |||
{_x | {_x moveTo position thisTrigger} forEach _esc; | ||
systemChat str [time, _esc]; | |||
false", | |||
"", | "", | ||
"" | "" | ||
];</ | ]; | ||
</sqf> | |||
}} | }} | ||
Latest revision as of 15:45, 8 November 2023
Description
- Description:
- Creates an agent of the given type. An agent does not have a group or leader or the standard soldier FSM associated with it - for instance, an enemy soldier spawned as an agent has limited AI and will do nothing when fired upon - which can be useful to limit the amount of AI processing being done in a mission with very large numbers of "AI". Animals are also commonly created as agents.
- Groups:
- Object Manipulation
Syntax
- Syntax:
- createAgent [type, position, markers, placement, special]
- Parameters:
- type: String - class from CfgVehicles
- position: Object or Array format PositionAGL or Position2D - desired placement position
- markers: Array - if the markers array contains any markers, the position is randomly picked from array of given markers plus desired placement position. If any of the markers were given z coordinate with setMarkerPos, the vehicle will also be created at given z coordinate.
- placement: Number - placement radius, the unit is randomly place in a circle with this radius
- special: String - one of:
- "NONE" - will look for a suitable empty position near given position (subject to other placement params) before creating the agent
- "CAN_COLLIDE" - creates the agent at given position (subject to other placement params), without checking if others objects can cross its 3D model
- Return Value:
- Object
Examples
- Example 1:
- Example 2:
Additional Information
- See also:
- agent agents isAgent forEachMemberAgent execFSM BIS_fnc_execFSM
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
- Posted on Sep 29, 2014 - 20:03 (UTC)
-
In Arma 3, default FSM is calling BIS_fnc_animalBehaviour script upon agent creation, which takes on some animal behavioural logic. The problem here is that it is almost impossible to make animal do what is told. Until now. Since Arma 3 v1.32 you can set BIS_fnc_animalBehaviour_disable variable on the agent at the moment of agent creation, to override the function.
tr = createTrigger ["EmptyDetector", player modelToWorld [0, 10, 0]]; tr setTriggerArea [5, 5, 0, true]; tr setTriggerActivation ["CIV", "PRESENT", true]; rabbits = []; private "_r"; for "_i" from 1 to 10 do { _r = createAgent ["Rabbit_F", position tr, [], 0, "NONE"]; _r setVariable ["BIS_fnc_animalBehaviour_disable", true]; rabbits pushBack _r; }; tr setTriggerStatements [ "if (rabbits isEqualTo thisList) exitWith { _r = thisList select floor random count thisList; _r moveTo (_r modelToWorld [2.5 - random 5, 2.5 - random 5, 0]); }; _esc = rabbits - thisList; doStop _esc; {_x moveTo position thisTrigger} forEach _esc; systemChat str [time, _esc]; false", "", "" ];
- Posted on Apr 18, 2015 - 07:17 (UTC)
- Agents seem to use the same collision model that the player uses, unlike normal AI. Normal AI don't collide with objects, but agents are physically stopped by obstacles the same way players are. This also probably means agents cost more resources than normal AI.