moveInTurret: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(add. classification)
m (Text replacement - "\] +\[" to "] [")
 
(78 intermediate revisions by 12 users not shown)
Line 1: Line 1:
[[Category:Scripting Commands|MOVEINTURRET]]
{{RV|type=command
[[Category:Scripting Commands ArmA|MOVEINTURRET]]
[[Category:Command_Group:_Vehicle_Assignment|{{uc:{{PAGENAME}}}}]]


{{Command|= Comments
|game1= arma1
____________________________________________________________________________________________
|version1= 1.00


| arma |= Game name
|game2= arma2
|version2= 1.00


|1.00|= Game version
|game3= arma2oa
|version3= 1.50


|arg= local |= Arguments in MP
|game4= tkoh
|version4= 1.00


|eff= global |= Effects in MP
|game5= arma3
____________________________________________________________________________________________
|version5= 0.50


| Moves the soldier into the vehicle's turret. (Immediately, without animation).
|arg= local


''turret path'' is an array of positions inside a turret, or positions inside a turret of a turret.
|eff= global


[0,0] means first turret of first turret.
|gr1= Turrets


[1,0] means second turret of first turret.
|descr= Moves the soldier into the vehicle's turret. (Immediately, without animation).
{{Feature|informative|See [[AI Group Vehicle Management]] for more information.}}
{{Feature|important|If the unit is already in a vehicle, nothing will happen. You should use [[moveOut]] to move the unit out of his vehicle before trying to move him into a new (or same) vehicle.}}


[0,1] means first turret of the second turret.
|s1= unitName [[moveInTurret]] [vehicle, turretPath]


[0,2] means first turret of third turret.
|p1= unitName: [[Object]]


[1] means second turret (without turrets in that turret).
|p2= vehicle: [[Object]]


And so on ... |= Description
|p3= turretPath: [[Array]] format [[Turret Path]]
____________________________________________________________________________________________


| unitName '''moveInTurret''' [vehicle, turret path] |= Syntax
|r1= [[Nothing]]


|x1= <sqf>_soldierOne moveInTurret [_tank, [0, 0]];</sqf>


|p1= unitName: [[Object]] |= Parameter 1
|seealso= [[allTurrets]] [[fullCrew]] [[assignAsTurret]] [[moveInAny]] [[moveInCargo]] [[moveInCommander]] [[moveInDriver]] [[moveInGunner]] [[assignAsCargo]] [[assignAsCommander]] [[assignAsDriver]] [[assignAsGunner]] [[ArmA:_Actions#GetInTurret|GetInTurret]]
|p2= [vehicle, turret path]: [[Array]] |= Parameter 2
}}
|p3= vehicle: [[Object]] |= Parameter 3
|p4= turret path: [[Array]] - see Description. |= Parameter 4
 
| [[Nothing]] |= Return value
____________________________________________________________________________________________
 
|x1= <code>_soldierOne '''moveInTurret''' [_tank, [0, 0]] </code>|= Example 1
____________________________________________________________________________________________
 
|[[moveInCargo]], [[moveInCommander]], [[moveInDriver]], [[moveInGunner]], [[assignAsCargo]], [[assignAsCommander]], [[assignAsDriver]], [[assignAsGunner]] |= See also


{{Note
|user= Kronzky
|timestamp= 20080306203100
|text= To find out which turrets are available on a vehicle ('''edit:''' before [[allTurrets]]), and what the syntax is, you can use {{Link|http://kronzky.info/turrets/index.htm|this little script}}.
<!-- in case kronzky.info disappears :(
<sqf>
_cfg = configFile >> "CfgVehicles" >> typeof _veh >> "turrets";
_tc = count _cfg;
if (_tc>0) then {
_mtc = count _cfg; // number of main turrets
_out = _out + format["Main Turrets: %1\n",count _cfg];
for "_mti" from 0 to _mtc-1 do {
_mt = (_cfg select _mti);
_st = _mt >> "turrets";
_stc = count _st; // sub-turrets in current main one
_out = _out + format["Turret #%1, %2: [%1]\n",_mti,configName(_mt)];
_weaps = getArray(_mt >> "weapons");
_out = _out + format[" Weapons:\n"];
{_out = _out + format["  %1\n",_x]}forEach _weaps;
_aid = player addAction [format["MoveIn: %1 [%2]",configName(_mt),_mti],"vehinfo.sqf",[_veh,_mti,-1]];
_actionIDs=_actionIDs + [_aid];
for "_sti" from 0 to _stc-1 do {
_stp = (_st select _sti);
_out = _out + format["Turret #%1, %2: [%1,%3]\n",_mti,configName(_stp),_sti];
_weaps = getArray(_stp >> "weapons");
_out = _out + format[" Weapons:\n"];
{_out = _out + format["  %1\n",_x]}forEach _weaps;
_aid = player addAction [format["MoveIn: %1 [%2,%3]",configName(_stp),_mti,_sti],"vehinfo.sqf",[_veh,_mti,_sti]];
_actionIDs=_actionIDs + [_aid];
};
};
};
</sqf>
-->
}}
}}


<h3 style="display:none">Notes</h3>
{{Note
<dl class="command_description">
|user= hcpookie
<!-- Note Section BEGIN -->
|timestamp= 20140213015600
TurretPath [0,0] moves the soldier in the first turret of the first turret of a vehicle,
|text= Examples for nested turrets:


TurretPath [0, 2, 1] would move him to the second turret of the third turret of the first turret, [1] moves him to the second turret of a vehicle.
MainTurret = <sqf>_soldierOne moveInTurret [_tank, [0]];</sqf>


Turret order has to be defined in the class [[CfgVehicles]] of the [[Config]].
CommanderTurret = <sqf>_soldierOne moveInTurret [_tank, [0, 0]];</sqf>


<b>here 2 examples : </b>
... where:
Boat1 is an "RHIB 2 Turrets"


<code>Soldier MoveInTurret [Boat1,[0]]</code>
MainTurret is the standard BIS MainTurret... e.g:
<syntaxhighlight lang="cpp">
class Turrets
{
class MainTurret {};
};
</syntaxhighlight>


result : Soldier will mount into the front turret of the boat
CommanderTurret is the standard BIS CommanderTurret located on the MainTurret... e.g:
<syntaxhighlight lang="cpp">
class Turrets
{
class MainTurret
{
class Turrets
{
class CommanderTurret {};
};
};
};
</syntaxhighlight>
}}


<code>Soldier MoveInTurret [Boat1,[1]]</code>
{{Note
 
|user= Killzone_Kid
result : Soldier will mount into the Back turret of the boat
|timestamp= 20140319000700
 
|text= Here is a small function to find available ''turret paths'' for a given vehicle. It will only search 2 levels deep, hence called ''commonTurrets'':
<dd class="notedate">Posted on March 6, 2008</dd>
<sqf>
<dt class="note">'''[[User:Kronzky|Kronzky]]'''</dt>
KK_fnc_commonTurrets = {
<dd class="note">To find out which turrets are available on a vehicle, and what the syntax is, you can use [http://kronzky.info/turrets/index.htm this little script].
private ["_arr","_trts"];
</dd>
_arr = [];
<!-- Note Section END -->
_trts = configFile / "CfgVehicles" / typeOf _this / "Turrets";
</dl>
for "_i" from 0 to count _trts - 1 do {
 
_arr set [count _arr, [_i]];
<h3 style="display:none">Bottom Section</h3>
for "_j" from 0 to count (
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
_trts / configName (_trts select _i) / "Turrets"
[[Category:Scripting Commands VBS2|{{uc:{{PAGENAME}}}}]]
) - 1 do {
_arr set [count _arr, [_i, _j]];
};
};
_arr
};
</sqf>
Example call:
<sqf>hint str (vehicle player call KK_fnc_commonTurrets); // [[0],[0,0]]</sqf>
See also [[allTurrets]]
}}

Latest revision as of 11:46, 5 May 2024

Hover & click on the images for description

Description

Description:
Moves the soldier into the vehicle's turret. (Immediately, without animation).
See AI Group Vehicle Management for more information.
If the unit is already in a vehicle, nothing will happen. You should use moveOut to move the unit out of his vehicle before trying to move him into a new (or same) vehicle.
Groups:
Turrets

Syntax

Syntax:
unitName moveInTurret [vehicle, turretPath]
Parameters:
unitName: Object
vehicle: Object
turretPath: Array format Turret Path
Return Value:
Nothing

Examples

Example 1:
_soldierOne moveInTurret [_tank, [0, 0]];

Additional Information

See also:
allTurrets fullCrew assignAsTurret moveInAny moveInCargo moveInCommander moveInDriver moveInGunner assignAsCargo assignAsCommander assignAsDriver assignAsGunner GetInTurret

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
Kronzky - c
Posted on Mar 06, 2008 - 20:31 (UTC)
To find out which turrets are available on a vehicle (edit: before allTurrets), and what the syntax is, you can use this little script.
hcpookie - c
Posted on Feb 13, 2014 - 01:56 (UTC)
Examples for nested turrets: MainTurret =
_soldierOne moveInTurret [_tank, [0]];
CommanderTurret =
_soldierOne moveInTurret [_tank, [0, 0]];
... where: MainTurret is the standard BIS MainTurret... e.g:
class Turrets 
{
	class MainTurret {};
};

CommanderTurret is the standard BIS CommanderTurret located on the MainTurret... e.g:

class Turrets 
{
	class MainTurret
	{
		class Turrets 
		{
			class CommanderTurret {};
		};
	};
};
Killzone_Kid - c
Posted on Mar 19, 2014 - 00:07 (UTC)
Here is a small function to find available turret paths for a given vehicle. It will only search 2 levels deep, hence called commonTurrets:
KK_fnc_commonTurrets = { private ["_arr","_trts"]; _arr = []; _trts = configFile / "CfgVehicles" / typeOf _this / "Turrets"; for "_i" from 0 to count _trts - 1 do { _arr set [count _arr, [_i]]; for "_j" from 0 to count ( _trts / configName (_trts select _i) / "Turrets" ) - 1 do { _arr set [count _arr, [_i, _j]]; }; }; _arr };
Example call:
hint str (vehicle player call KK_fnc_commonTurrets); // [[0],[0,0]]
See also allTurrets