Differences

This shows you the differences between two versions of the page.

--- add_tile [2017/07/29 23:27] – justin
+++ add_tile [2023/01/02 21:13] (current) – justin
@@ Line 2: / Line 2: @@
 ----
-Adds a tile at the specified coordinate within the map (if a tile does not already exist at that coordinate). The entity ID is optional and will be assigned to the new tile if supplied.
+Adds a [[tile|tile]] at the specified [[coordinate|coordinate]] within the [[map|map]] (if a [[tile|tile]] does not already exist at that [[coordinate|coordinate]]). The [[entity|entity]] ID is optional and will be assigned to the new [[tile|tile]] if supplied.
+====Signature:====
 <code python>
 add_tile(model_name, coordinate, entity_id)
@@ Line 9: / Line 10: @@
 ^Argument^Description^Type^Required^
-|model_name|Model to use for the new tile.|[[String]]|Yes|
+|model_name|Model to use for the new [[tile|tile]].|[[string|String]]|Yes|
-|coordinate|Position of the new tile.|[[Coordinate]]|Yes|
+|coordinate|Position of the new [[tile|tile]].|[[coordinate|Coordinate]]|Yes|
-|entity_id|Unique entity ID to assign to the new tile.|[[String]]|No|
+|entity_id|Unique [[entity|entity]] ID that will be assigned.|[[string|String]]|No|
+^Return Value^Description^Type^
+|Tile Added|Returns a reference to the [[tile]] that was added.|[[Entity]]|
+<WRAP center round info 100%>
+After adding a new [[tile|tile]], you can use the [[modify_navigation|Modify Navigation]] function to make the [[tile|tile]] walkable from any adjacent [[tile|tiles]]. For example, if you add a bridge [[tile|tile]] on top of a river, you'll need to update the [[navigation_and_interaction|navigation]] to allow the [[character|characters]] to walk across it.
+</WRAP>
+====Example:====
+<code bauxite>
+add_tile("wooden_floor_02", coord[10, 0, -1], "bridge");
+</code>
+//Results:// A new [[tile|tile]], using model "wooden_floor_02", will be added to the [[map|map]] at [[coordinate|coordinate]] (10, 0, -1) and given an ID of "bridge".
+<WRAP center round tip 100%>
+Use the **Add Tile** function to place a bridge across a river or chasm after the player performs a certain action, opening up a new area for them to explore.
+</WRAP>
+----
+<WRAP group>
+<WRAP half column>
+====Editor Node:====
+{{:add_tile_node.png?nolink|}}
+</WRAP>
+<WRAP half column>
+====Visual Demo:====
+{{:add_tile_demo.gif?nolink|}}
+</WRAP>
+</WRAP>
 ~~NOTOC~~

RPG in a BoxOfficial Documentation

User Tools

Site Tools

Differences

Page Tools

RPG in a Box
Official Documentation