Documentation
Contextual Interactions

Some objects are able to contextually affect the state or behavior of other objects. For example, turning on a Microwave with a Potato object in it will cause the Potato’s metadata to automatically change the members isCooked to True and ObjectTemperature to Hot. Additionally, some objects might have certain restricted interactions with others. ToiletPaperHanger objects, which are receptacles, can only have ToiletPaper objects placed in them for example.

Table of Objects with Contextual Interactions

Object Type Contextual Interactions  
Bottle Will break if subjected to enough force. Will fill up with water if moved underneath a running water source.  
Bowl Will automatically break if subjected to enough force. Not all bowls are breakable (Plastic-Unbreakable vs Glass-Breakable vs Ceramic-Breakable). If empty, will fill up with water if moved underneath a running water source. If in the Dirty state, will automatically become Clean if moved under running water.  
BreadSliced Use PutObject action to place BreadSliced into Toaster objects. If the Toaster is on, the BreadSliced will automatically cook. BreadSliced will also automatically cook if moved over an active StoveBurner object.  
Candle Can be lit using the ToggleObjectOn action. If another source of flame (another Candle or a Stove Burner) touches the wick, the Candle will automatically be lit and turn on. If the wick of the Candle touches a source of water, then the Candle will automatically be put out and turned off.  
CellPhone Will automatically break if subjected to enough force. When broken, the CellPhone’s screen will appear cracked and the On/Off state will be switched to Off. Broken CellPhones will no longer be able to turn on with ToggleObjectOn.  
Cloth If in the Dirty state, will automatically become Clean if moved under running water.  
CoffeeMachine Coffee Machines are receptacles but only allow objects of type Mug to be placed in them. If a Coffee Machine is On and an empty Mug is placed in it, the Mug will automatically fill with Coffee and have its Temperature changed to Hot  
Cup Will automatically break if subjected to enough force. Not all Cups are breakable (Plastic-Unbreakable vs Glass-Breakable vs Ceramic-Breakable). If empty, will fill up with water if moved underneath a running water source. If in the Dirty state, will automatically become Clean if moved under running water.  
Egg Using the Slice action or the Break action will change the Egg to an EggCracked object. Dropping or Throwing the Egg with enough force will also automatically Break the egg into an EggCracked.  
EggCracked Placing an EggCracked object onto an active StoveBurner will automatically cook it. Placing an EggCracked object into a Microwave, and then turning on the Microwave will automatically cook it.  
Faucet Can be turned on with ToggleObjectOn action. When on, a stream of running water will pour out from the faucet spout. If the Faucet is over a Sink or a Bathtub, the interior of the Sink/Bathtub will fill with standing water. For objects that can be automatically cleaned, the stream of water is a Running Water Source  
Fridge Objects placed in a Fridge will have their temperature automatically changed to Cold  
HandTowelHolder HandTowelHolders are recptacle objects, but only allow HandTowel type objects to be placed on them.  
HousePlant Will fill up with water if moved underneath a running water source.  
Kettle Will fill up with water if moved underneath a running water source.  
Laptop Will automatically break if subjected to enough force. When broken, the Laptop’s screen will appear cracked and the On/Off state will be switched to Off. Broken Laptops will no longer be able to turn on with ToggleObjectOn, but they can still be opened or closed with OpenObject or CloseObject.  
Microwave Any objects inside a Microwave while it is turned On will have their temperature changed to Hot. Some object will also automatically cook (Potato, Egg). Microwaves cannot be turned on if they are open, and cannot be opened if they are currently on.  
Mirror Will automatically break if subjected to enough force, for example, from an object Thrown hard enough  
Mug Will automatically break if subjected to enough force. Not all Mugs are breakable (Plastic-Unbreakable vs Glass-Breakable vs Ceramic-Breakable). If empty, will fill up with water if moved underneath a running water source. If in the Dirty state, will automatically become Clean if moved under running water. If empty and placed in a CoffeeMachine that is on, will automatically fill with Coffee and have temperature changed to Hot  
Pan If in the Dirty state, will automatically become Clean if moved under running water.  
Plate Will automatically break if subjected to enough force. Not all Plates are breakable (Plastic-Unbreakable vs Glass-Breakable vs Ceramic-Breakable). If in the Dirty state, will automatically become Clean if moved under running water.  
Pot If empty, will fill up with water if moved underneath a running water source. If in the Dirty state, will automatically become Clean if moved under running water.  
Potato Will automatically be Cooked if placed over an active Stove Burner or in a turned on Microwave. When Sliced, will create multiple PotatoSliced objects. Cooking the Potato first and then Slicing it will result in Cooked PotatoSliced objects.  
PotatoSliced Will automatically be Cooked if placed over an active Stove Burner or in a turned on Microwave.  
ShowerDoor Will automatically break if subjected to enough force, for example, from an object Thrown hard enough  
ShowerGlass Will automatically break if subjected to enough force, for example, from an object Thrown hard enough  
ShowerHead Can be turned on with ToggleObjectOn action. When on, a stream of running water will pour out from the Shower Head. For objects that can be automatically cleaned, the stream of water is a Running Water Source.  
Statue Will automatically break if subjected to enough force, for example if dropped from a high enough distance  
StoveBurner While this object type can be turned on/off, the ToggleObjectOn and ToggleObjectOff actions will not work on it directly. All StoveBurners are controlled by the on/off state of a StoveKnob object. Turning on/off the StoveKnob will automatically turn on/off the StoveBurner that it is linked to. Objects placed over an active StoveBurner will have their temperature changed to Hot. Some objects can be automatically cooked over an active StoveBurner (Potato, BreadSliced). StoveBurners are receptacles but only allow objects of type Pot, Pan, and Kettle to be placed on them directly. StoveBurners are also sources of fire and can light Candles if the wick of the candle is moved over the burner  
StoveKnob All StoveKnobs control the on/off state of themselves and a linked StoveBurner.  
TargetCircle Can only be spawned in via the SpawnTargetCircles action (See the Miscellaneous Actions section). TargetCircles are a special type of sim object that have no collision, but do return what objects are contained by the circle in the circle’s object metadata. This can be used to create target areas to maneuver other sim objects to, allowing for a success or failure flag to see if an object was succesfully moved to a specific target circle’s position. There are three sizes of target circles: small, medium, and large. This allows for easier or harder target areas.  
Television Will automatically break if subjected to enough force. When broken, the Television’s screen will appear cracked and the On/Off state will be switched to Off. Broken Televisions will no longer be able to turn on with ToggleObjectOn.  
Toaster Toasters are receptacles but only allow BreadSliced objects to be placed in them. Any BreadSliced object in a Toaster that is turned on will automatically be Cooked.  
ToiletPaperHanger ToiletPaperHangers are receptacles but only allow ToiletPaper objects to be placed in them  
Tomato When Sliced, will create multiple TomatoSliced objects.  
TowelHolder TowelHolders are receptacles but only allow Towel objects to be placed in them.  
Vase Will automaticaly break if subjected to enough force.  
WateringCan If empty, will automatically fill with water if placed under a running water source.  
Window Will automatically break if subjected to enough force.  
WineBottle Will automatically break if subjected to enough force. If empty, will automatically fill with water if placed under a running water source.