Script calls User API

Script calls

Network game state and information:

• nAPI.isNetworkGame() - is current game in multiplayer?
• nAPI.myPlayerIndex() - client index (in room), host always 1
• nAPI.myActorId() - client Actor ID
• nAPI.playersCount() - players count in game
• nAPI.isMasterClient() - current client is host?

---

Show different alerts and messages to players:

• nAPI.showGreenAlert(text)
• nAPI.showRedAlert(text)
• nAPI.showInfoMessage(text, subText)
• nAPI.hideInfoMessage()

⚠️ Examples you can find in Demo Project, map nAPI (script calls)

---

Create own commands to server in game

You can define your custom server commands and send them to all players. When players received your command, game will start common event that you can specify for each custom command.

• nAPI.registerCommonEventForCommand(name, commonEventId) - register common event for command with NAME
• nAPI.sendCustomCommand(name) - send for all command NAME (call registered common event for this command)

⚠️ Example: see event CustomCmd (003) in Demo Project on map nAPI (script calls)

---

Create own commands to server in code (for plugin developers)

Example code:

// 1. SEND CUSTOM COMMAND
var data = {}; // * some data if you need it (or null)
nAPI.sendCustomCommand("someName", data);

// 2. RECEIVE AND WORK WITH YOUR CUSTOM COMMAND

//@[ALIAS] // Aliasing is REQUIRED!
var _alias_nAPI_onCustomCommand = nAPI.onCustomCommand;
nAPI.onCustomCommand = function (name, data) {
    _alias_nAPI_onCustomCommand.call(this, ...arguments);
    if(name == "someName") {
        // YOUR CODE
    }
};

Download example code file