connectToServer: Difference between revisions

Latest revision as of 11:14, 4 April 2025

2.00

Hover & click on the images for description

Description

Description:

Connects the client to the provided server.

ⓘ

only works on the Main Menu.
must be executed from UI context, such as onButtonDown or similar events (see User Interface Event Handlers).

2.20

If port is 0, the IP will be resolved as a SRV DNS Record.

["domain.com", 0, "password"] will be resolved as "_arma3._udp.domain.com".

Only the first found record will be used, there is no support for multiple records with priority/weights.

Groups:

System

Syntax

Syntax:: connectToServer [ip, port, password]
Parameters:: ip: String - IP in IPv4 format or 2.20 domain name
: port: Number
: password: String - "" if no password
Return Value:: Nothing

Examples

Example 1:: Copy
connectToServer ["192.168.0.2", 2302, "test"];
Example 2:: Copy
connectToServer ["publicserver.mydomain.com", 2302, ""];

Additional Information

See also:: serverCommand getSteamFriendsServers

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

@@ Line 1: / Line 1: @@
-{{Command
+{{RV|type=command
-|game1= arma3dev |Game name=
+|game1= arma3
+|version1= 2.00
-|version1= 1.99 |Game version=
+|gr1= System
-|gr1= System |GROUP1=
+|descr= Connects the client to the provided server.
-____________________________________________________________________________________________
+{{Feature|informative|
+* only works on the [[Arma 3: Main Menu|Main Menu]].
+* must be executed from [[isUIContext | UI context]], such as ''onButtonDown'' or similar events (see [[User Interface Event Handlers]]).
+}}
+{{Feature|GVI|arma3|2.20|
+If port is 0, the IP will be resolved as a SRV DNS Record.<br>
+["domain.com", 0, "password"] will be resolved as "_arma3._udp.domain.com".<br>
+Only the first found record will be used, there is no support for multiple records with priority/weights.
+}}
-|descr= Connects the client to the provided server.
-{{Informative |
-* only works on the [[Arma 3 Main Menu|Main Menu]].
-* must be executed from [[isUIContext | UI context]], such as ''onButtonDown'' or similar events (see [[User Interface Event Handlers]]).}} |Description=
-____________________________________________________________________________________________
-|s1= [[connectToServer]] [ip, port, password] |Syntax=
-|p1= ip: [[String]] |Parameter 1=
+|s1= [[connectToServer]] [ip, port, password]
-|p2= port: [[Number]] |Parameter 2=
+|p1= ip: [[String]] - IP in {{Link|https://en.wikipedia.org/wiki/IPv4}} format or {{GVI|arma3|2.20|size= 0.75}} domain name
-|p3= password: [[String]] - "" if no password |Parameter 3=
+|p2= port: [[Number]]
-____________________________________________________________________________________________
-|x1= <code>[[connectToServer]] ["192.168.0.2", 2302, "test"];</code> |Example 1=
+|p3= password: [[String]] - "" if no password
-____________________________________________________________________________________________
-|seealso= [[serverCommand]] [[getSteamFriendsServers]] |See Also=
+|r1= [[Nothing]]
-}}
-<dl class="command_description">
+|x1= <sqf>connectToServer ["192.168.0.2", 2302, "test"];</sqf>
-<!-- BEGIN Note Section -->
-<!-- END Note Section -->
+|x2= <sqf>connectToServer ["publicserver.mydomain.com", 2302, ""];</sqf>
-</dl>
-<h3 style="display:none">Bottom Section</h3>
+|seealso= [[serverCommand]] [[getSteamFriendsServers]]
+}}