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 5 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
startConversation(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:

extendConversation(4); // give player 15 seconds to send their reply

Notes

If there is an active Conversation with the player, commands will be ignored and all chat messages from the player will be sent to the conversation handler instead.

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 stopConversation(). When a conversation ends, chat message handling will be returned to the command interface.

Availability

Requires:

Chat API

Topics:

 

  • No labels