When an item is set up to say or do something, it is called an item interaction.
You can set an item interaction to be triggered by almost anything. For example, it could be triggered when a player enters a room, when they dance, when they use an item, or when they have a certain attribute.
An example of a simple interaction would be if you set a door to say "Come In" when a player in that space says "Knock Knock."
How To Set An Item Interaction
Follow the instructions to make a door say "Come In".
1. Click on the door, then click Edit.
2. Click on Interactions.
3. Click on Reactions.
4. Click on Add to add a new reaction.
5. Select Avatar from the drop-down list.
6. Select Says from the drop-down list. This will trigger the reaction when an avatar in the space says something.
7. Type in the words that will trigger the reaction. For this example, type in "Knock Knock". The reaction will be triggered when an avatar in this space says "Knock Knock".
8. Select what you want the item to do when the reaction is triggered. In this example you want it to say something, so select Say Something in the Reaction field.
9. Type in the message the item will say. For this example, type "Come In".
10. If you want a delay between the time that the reaction is triggered (the person in the space says "Knock Knock"), and the item reacts (the door says "Come In"), you can enter the number of seconds for the delay.
By using the following codes you can personalise messages to recognise item or avatar names. For example, you might have a chair in your space configured to say “Sit here”, however by using these codes you can actually have the chair say “Sit here’ followed by the avatars name, eg, “Sit here Doris”. To get started, you”ll need to go to the ‘Items Interactions’ setup.
- First, click on the item that you want to set the interaction for.
- Next, click on Edit.
- Then, click on Interactions.
- When the interactions window pops up click on Reactions.
So now you need to decide what you want your item to react to. A popular choice is using Avatar Proximity to welcome people to your space. That is, when an avatar enters your space, you place an item right next to where they enter, and this then triggers a welcome message, because they are near to the item you set the interaction for.
To set the proximity interaction:
- Click on Add to add a new reaction.
- For React When: select Proximity. Then start with a proximity of 2 metres or less. You can edit this later if you need the area to be bigger.
- Now for the fun part – what do you want your item to say?
- For Reaction choose Say Something. (You will need to scroll down to find this one.) Choose the Delay you want (in seconds) you can set this so it’s instant.
- Type in what you want your item to say ie: If you want your item to say “Welcome <name>, to <space name>” you would type in “Welcome $avatarName, to $spaceName”
This is a list of different matching terms you can use.
$avatarName – The name of the avatar (Eg. John Smith).
$avatarDescription – The motto of the avatar.
$avatarFirstName – The first name of the avatar (Eg. John).
$avatarLastName – The last name of the avatar (Eg. Smith).
$avatarFullName – The full name of the avatar (Eg. John Smith the 2nd).
$avatarTitle - Adds Mr or Miss to the avatars name
$avatarFormalTitle – Adds “sir” or “madam” to the avatars name.
$avatarGender – Enters “female” or “male” into text
$petName – The name of the avatar’s pet.
$spaceName – The name of the space.
$spaceDescription – The description of the space.
$spaceAvatarCount – The number of avatars in the space.
$spaceItemCount – The number of items in the space.
$spaceRating – The rating of the space.
$spaceVotes – The number of votes the space has.
$itemName – The name of the item.
$itemDescription – The description of the item.
$itemPriceGold – The price of the item in gold.
$itemPriceTokens – The price of the item in tokens.
Simple Matching Terms
Matches a word at the *start* of a sentence that the user said.
Will match “time to go home”
Will not match “is it time yet?”
Matches the word at the *end* of a sentence that the user said
Will match “please leave”
Will not match “leave my house”
Matches a space character
Will match “this is on live right?”
Will not match “you are acting lively”
Will not match “live action”
Matches a ‘word boundary’ – word must be exactly the same. Plurals will not respond.
For example, “\bcookie\b”
Will match “This is my cookie”
Will match “cookie monster!”
Will not match “I love cookies”