======Put Entity======
----

Instantly positions an [[object]] or [[character]] onto the specified [[tile]].

====Signature:====
<code python>
put_entity(entity, target_tile)
</code>

^Argument^Description^Type^Required^
|entity|[[Entity]] to reposition.|[[Entity]]|Yes|
|target_tile|Target [[tile]] onto which the [[entity]] will be placed.|[[Entity]], [[Coordinate]]|Yes|

<WRAP center round info 100%>
If you are changing the [[player_character|player's]] position, you can alternatively use the more convenient [[Put Player]] function which also lets you specify the [[player_character|player's]] [[cardinal_direction|direction]].
</WRAP>

====Example:====
<code bauxite>
put_entity(entity["slippery_chest"], "chest_destination");
</code>
//Results:// The [[entity]] with an ID of "slippery_chest" is immediately repositioned onto the [[tile]] with an ID of "chest_destination".

<WRAP center round tip 100%>
Use the **Put Entity** function to move [[object|objects]] around the scene, for example to create the illusion that the [[player_character|player]] has pushed an obstacle out of their way.
</WRAP>

----

<WRAP group>
<WRAP half column>
====Editor Node:====
{{:put_entity_node.png?nolink|}}
</WRAP>

<WRAP half column>
====Visual Demo:====
{{:put_entity_demo.gif?nolink|}}
</WRAP>
</WRAP>

~~NOTOC~~