Network - Meteor 2 Scripting Functions

bool isSinglePlayer()

Is game single player?

if(isSinglePlayer())
{
print("Game is single player");
}
else
{
print("Game is multiplayer");
}

Same as using !isMultiplayer()

isMultiplayer

bool isMultiplayer()

Is game multiplayer?

if(isMultiplayer())
{
print("Game is multiplayer");
}
else
{
print("Game is single player");
}

isSinglePlayer isServer isMultiplayerServer isClient isCoop isHeadToHead

bool isServer()

Is local computer a server or single player?

if(isServer())
{
print("Local computer is server or single player");
}
else
{
print("Local computer is a multiplayer client");
}

Use to determine if the local computer has game authority.

isMultiplayerServer isMultiplayer isClient isCoop isHeadToHead

bool isMultiplayerServer()

Is local computer a multiplayer server?

if(isMultiplayerServer())
{
print("Local computer is multiplayer server");
}
else
{
print("Local computer is not a multiplayer server");
}

Similar to isServer() except returns false in single player.

isMultiplayerServer isMultiplayer isClient isCoop isHeadToHead

bool isClient()

Is local computer network client?

if(isClient())
{
print("Local computer is a multiplayer client");
}
else
{
print("Local computer is server or single player");
}

isMultiplayerServer isMultiplayer isServer isCoop isHeadToHead

bool isCoop()

Is game cooperative?

if(isCoop())
{
print("Play nice");
}
else
{
print("The gloves are off");
}

isMultiplayer isServer isMultiplayerServer isClient isHeadToHead

bool isHeadToHead()

Is game head to head (aka deathmatch)?

if(isHeadToHead())
{
print("The gloves are off");
}
else
{
print("Play nice");
}

isMultiplayer isServer isMultiplayerServer isClient isCoop

void syncVar(string variableName)

Syncs a variable to all players.

// global variable outside all functions
bool someVar = false;

void onWorldStart()
{
    // if server or single player
    if(isServer())
    {
        someVar = true;
        syncVar("someVar");
    }
}

The variable must be a global variable in the map script (not hud or ambient etc), which is defined outside of any functions.
The variable must be a float, int, bool, string or vector2, other types cannot be synced.
Synced variables are synced to players who join mid-game.
Variables can be synced at any time by any player.
In singleplayer, the function has no effect.

netExec

void netExec(int destPlayerID, string codeString)

Execute a string of code on a remote computer.

// display message on server only
netExec(NET_EXEC_DEST_SERVER, "print(\"Hello Server!\");");

// display message on all computers (includes local computer)
netExec(NET_EXEC_DEST_ALL, "print(\"Hello All!\");");

// display message on all computers except local computer
netExec(NET_EXEC_DEST_ALL_REMOTE, "print(\"Hello All!\");");

// display message on clients only
netExec(NET_EXEC_DEST_ALL_CLIENTS, "print(\"Hello Clients!\");");

// display message on a specific computer
int destPlayerID = getServerPlayer();
netExec(destPlayerID, "print(\"Hello player ID " + destPlayerID + "!\");");

The netExec function is disabled by default for security reasons, use setNetExecEnabled to enable.
netExec can be used from any computer (server or clients can exec code anywhere else).

getNetExecEnabled setNetExecEnabled

bool getNetExecEnabled()

Get netExec function enabled status.

print("netExec enabled: " + getNetExecEnabled());

Always returns false in single player.

setNetExecEnabled netExec

void setNetExecEnabled(bool enable)

Enable netExec function on all computers (server only).

void onWorldStart()
{
    if(isMultiplayerServer())
    {
        // enable netExec globally
        setNetExecEnabled(true);
    }
}

Has no effect in single player.

getNetExecEnabled netExec