This AI is still in early stages of development.

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 12 Next »

Quick start guide for making and using conversations...

 

Step 1

Define a Conversation Handler Function:

var myConvHandler = function myConvHandler(command, player, message, conversation) {
  // command = first word in the message (string)
  // player = id of player who sent the command (number)
  // message = array of words in chat message (message[0] == command)
  // conversation = conversation object associated with player
 
  // do some stuff
 
  // if you want a message sent to the player,
  // return a string or an array of strings
  return "done";
}

Step 2

Start a conversation:

// example: conversation with player id 4
chat.start(4, myConvHandler);
chat(4, "What do you want me to do?");

By default, the user will be given 15 seconds to reply to a conversation before it expires.

Step 3

Remember to extend conversations after each interaction:

chat.extend(4); // give player 15 seconds to send their reply

Notes

While there is an active Conversation with a player all chat messages from that player will be sent to the conversation handler. This means they can't send Command Mode while a conversation is active.

Conversations will automatically expire if the player doesn't reply within a set amount of time (default: 15 seconds). You can stop a conversation at any time using chat.stop(). When a conversation ends, chat message handling will be returned to the command interface.

Availability BETA

Requires:

Chat API

Topics:

 

  • No labels