chat.fromBabel()

Converts a Babel format message in to an array...

Syntax

var result = chat.fromBabel(message);

Parameters

Parameter	Type	Mandatory	Notes	API Version
message	String		A Babel formatted message that you want to decompile.	1.0

Return values

Value Type Notes API Version

<result>

Array of Variant

An array that looks like this:

[sender, to, message, dialect, data]

The values are as follows:

sender – the id of the player who sent the message
to – the id of the player who the message was sent to (or Player Scope constant)
message – the "message" component of the Babel message
dialect – the "dialect" component of the Babel message (defaults to "ai" if sender did not specify it)
data – the "data" component of the Babel message (or undefined if no data sent)

1.0

<error>

Error Dialect

Invalid parameters passed to function. See Error Dialect for more information on what's in the return value.

1.0

Example

function eventChat(sender, to, message) {
	if (chat.isBabel(message)) {
		// use .fromBabel() array as params to custom event...
		eventChatAI.apply(this, chat.fromBabel(sender, to, message));
	} else {
		// process other kinds of message
	}
}
 
function eventChatAI(sender, to, message, dialect, data) {
	// do stuff
}

Availability BETA

Requires:

Warzone 3.1 or above
Babel API

Babel API

Topics:

Data types — Babel supports most types of data...
Error Dialect — A specific dialect for reporting errors within Babel...
Babel on Warzone 3.1 — Babel handles Warzone 3.1 gracefully...
Position-like Objects — If your data has {x, y} properties, Babel treats it like a Position object...
chat.toBabel() — Compiles a Babel format message, ready for sending to your AI buddies...
chat.isBabel() — Quickly determine if a received message is in Babel format...
chat.fromBabel() — Converts a Babel format message in to an array...
Handling Dialects — Some ideas on how to handle multiple dialects...