ActionAPI

The ActionAPI contains a spigot and bungeecord implementation to fetch and execute Actions from the ActionAPIService. Redis is used for pubsub for now.

Services can send json formatted actions to the ActionAPIService, in the expectation that these actions will be executed on the appropriate bungee/spigot servers.

ActionAPI messages will be consumed up to one time by every destination. When an action is posted, it is registered to all appropriate destinations This means when the destination is specific to the player, it first fetches the server of the player, and publishes the action to that server. So if the player leaves before that servers polls it's messages, he will not receive the message.

##Action format

{  "subject":"ffcc67a2-b114-4825-beea-63c4bdee2b21",
   "action":"CHAT",
   "meta":{  
      "lines":["Line one", "Line two"]
   }
}

• "subject": The subject (optional, defaults to NONE), usually the player.
• "action": The destination (optional, defaults according to the subject), indicates what servers this message should schedule too.
• "meta": The action metadata, different for every action.

##Subject Actions may contain a field 's', indicating the subject of the action. Defaults to NONE. The action will be executed on the subject.

• 'ALL': Executes for all players on specified destinations (Useful for broadcasts)
• 'NONE' [DEFAULT]:The action executes once for every specified destination (Useful for in-world events)
• '{uuid}(,{uuid2},...)': Only executes for specified player (Useful for sending a private msg). Optionally send to multiple uuids

##Destination Actions may contain the 'd' parameter, to specify the location that the action will be scheduled to.

• SUBJECT [DEFAULT]: Depends on the subject: ALL/NONE: Every server, {uuid}: Server of the uuid player
• ALL: Every server receives the action (useful for global broadcasts)
• {uuid}(,{uuid2},...): The action is send to the server of the specified uuid (useful for broadcasting on 1 server). Optionally send to multiple uuids

##Bungeecord Actions ###JOIN Connects target to specified server ###CHAT Sends array of messages to target chat ###KICK Kicks target from network (disconnect) ###BATCH Executes an array of actions on the target

##Spigot Actions ###HUD Adds HUDText to specific target HUD location ###BATCH Executes an array of actions on the target