remoteExec

From Bohemia Interactive Community
Jump to navigation Jump to search


-wrong parameter ("arma3dev") defined!-[[:Category:Introduced with arma3dev version 1.46|1.46]]
Hover & click on the images for description

Description

Description:
Asks server to execute a command remotely by spawning it.
Groups:
Uncategorised

Syntax

Syntax:
[parms] remoteExec [functionName, targets, jipID];
Parameters:
functionName: String - function name. While any function can be used, only commands defined in CfgRemoteExecCommands are supported.
params: Array - parameters passed to the function
targets: - Optional. [default: 0]
Object - function will be executed only where unit is local [default: everyone]
Number - the function will be executed only on client with the given owner ID. When 0, the function will be executed on each client including the one where remoteExec was called from. When 2, it will be executed only by server. When negative, it will be executed everywhere except for machines with with the given client ID.
Side - the function will be executed only on clients where the player is on the specified side
Group - the function will be executed only on clients where the player is in the specified group
Array - array of any of types listed above
JIP: String or Boolean - Optional [default: false]. If true, function generates an unique ID for the message and the message itself is added to the JIP queue. If a non-empty string, it is a custom ID of the message and the message iteself is added to the JIP queue overriding any remoteExec message with the same ID. Otherwise, no ID is generated and no message is placed into the JIP queue.
Return Value:
Anything - Nil in case of error. String otherwise. If JIP is not requested this is an empty string. Otherwise this is an unique JIP ID. See the topic Function for more information.

Examples

Example 1:
"hello" remoteExec ["hint"]; // runs hint "hello" on each connected client
Example 2:
"hello" remoteExec ["hint", 0]; // runs hint "hello" on each connected client
Example 3:
"hello" remoteExec ["hint", 3]; // runs hint "hello" on first connected client
Example 4:
"hello" remoteExec ["hint", -2]; // runs hint "hello" everywhere but server
Example 5:
myJipID = "hello" remoteExec ["hint", -2, "IamUnique"]; // runs hint "hello" everywhere but server, JIPs the message and return e.g. "3_1" as a unique JIP id
Example 6:
remoteExec ["someFuncWithNoArgs"]; // runs "someFuncWithNoArgs" on each connected client
Example 7:
remoteExec ["", "IamUnique"]; // removes the message identified by "IamUnique" ID from the JIP queue. // Therefore, for newly connected clients hint "hello" won't be displayed anymore
Example 8:
{player setAmmo [primaryWeapon player, 1];} remoteExec ["bis_fnc_call", 0]; // all clients will have their ammo set to 1 for their current weapon
Example 9:
myJipID = "hello" remoteExec ["", 0]; if (isNil "myJipID") then { hint "empty function name is not allowed"; };

Additional Information

See also:
remoteExecCall BIS_fnc_MP

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

[[Category:Introduced with arma3dev version 1.46]][[ Category: arma3dev: New Scripting Commands | REMOTEEXEC]][[ Category: arma3dev: Scripting Commands | REMOTEEXEC]]