serverCommand: Difference between revisions
Jump to navigation
Jump to search
Lou Montana (talk | contribs) |
Lou Montana (talk | contribs) m (Text replacement - "server.cfg" to "server config") |
||
(22 intermediate revisions by 4 users not shown) | |||
Line 21: | Line 21: | ||
}} | }} | ||
{{Feature | important | If [[serverCommand]] is executed on a client, it must be executed from [[isUIContext|UI context]], such as [[User Interface Event Handlers#onButtonDown|"onButtonDown"]] or similar events (see [[User Interface Event Handlers]]).}} | {{Feature|important|If [[serverCommand]] is executed on a client, it must be executed from [[isUIContext|UI context]], such as [[User Interface Event Handlers#onButtonDown|"onButtonDown"]] or similar events (see [[User Interface Event Handlers]]).}} | ||
|s1= [[serverCommand]] command | |s1= [[serverCommand]] command | ||
Line 27: | Line 27: | ||
|p1= command : [[String]] | |p1= command : [[String]] | ||
|r1= [[Boolean]] - | |r1= [[Boolean]] - [[false]] if a non valid command is used ("#blah"), false otherwise (was always [[true]] before {{GVI|arma3|1.40|size= 0.75}}) | ||
|s2= password [[serverCommand]] command | |s2= password [[serverCommand]] command | ||
|s2exec= server | |||
|s2since= arma3 1.40 | |s2since= arma3 1.40 | ||
|p21= password : [[String]] - password defined in [[server | |p21= password : [[String]] - case-sensitive password defined in [[Arma 3: Server Config File|server config]] with {{hl|serverCommandPassword}} param | ||
|p22= command : [[String]] - server command | |p22= command : [[String]] - server command | ||
|r2= [[Boolean]] - [[true]] | |r2= [[Boolean]] - [[false]] if command failed at some stage. [[true]] doesn't mean that command succeeded. | ||
|x1= < | |x1= <sqf>serverCommand "#logout";</sqf> | ||
|x2= Create button on the main map which will show userlist to anyone who clicks on it: | |x2= Create button on the main map which will show userlist to anyone who clicks on it: | ||
< | <sqf>with uiNamespace do | ||
{ | { | ||
private _ctrl = findDisplay 12 ctrlCreate ["RscButton", -1]; | |||
_ctrl | _ctrl ctrlSetPosition [0,0,0.5,0.1]; | ||
_ctrl | _ctrl ctrlSetText "USERLIST"; | ||
_ctrl | _ctrl ctrlCommit 0; | ||
_ctrl | _ctrl ctrlAddEventHandler ["ButtonDown", | ||
{ | { | ||
serverCommand "#userlist"; | |||
}]; | }]; | ||
};</ | };</sqf> | ||
|x3= < | |x3= <sqf>serverCommand format ["#kick %1",_name];</sqf> | ||
|x4= < | |x4= <sqf>private _passwordWasOK = "MyServerCommandPassword" serverCommand "#lock";</sqf> | ||
|seealso= [[serverCommandAvailable]] [[serverCommandExecutable]] [[admin]] | |seealso= [[serverCommandAvailable]] [[serverCommandExecutable]] [[admin]] [[isUIContext]] | ||
}} | }} | ||
Revision as of 13:35, 17 May 2024
Description
- Description:
- Executes the given server command.
- Groups:
- Multiplayer
Syntax
- Syntax:
- serverCommand command
- Parameters:
- command : String
- Return Value:
- Boolean - false if a non valid command is used ("#blah"), false otherwise (was always true before 1.40)
- Syntax:
- password serverCommand command
- Parameters:
- password : String - case-sensitive password defined in server config with serverCommandPassword param
- command : String - server command
- Return Value:
- Boolean - false if command failed at some stage. true doesn't mean that command succeeded.
Examples
- Example 1:
- serverCommand "#logout";
- Example 2:
- Create button on the main map which will show userlist to anyone who clicks on it:
with uiNamespace do { private _ctrl = findDisplay 12 ctrlCreate ["RscButton", -1]; _ctrl ctrlSetPosition [0,0,0.5,0.1]; _ctrl ctrlSetText "USERLIST"; _ctrl ctrlCommit 0; _ctrl ctrlAddEventHandler ["ButtonDown", { serverCommand "#userlist"; }]; };
- Example 3:
- Example 4:
Additional Information
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
Categories:
- Scripting Commands
- Introduced with Arma 2 version 1.05
- Arma 2: New Scripting Commands
- Arma 2: Scripting Commands
- Arma 2: Operation Arrowhead: Scripting Commands
- Take On Helicopters: Scripting Commands
- Arma 3: Scripting Commands
- Command Group: Multiplayer
- Scripting Commands: Server Execution
- Introduced with Arma 3 version 1.40