======キャラクターを追加======
----

[[map|マップ]]内の指定された[[tile|タイル]]に[[character|キャラクター]]を追加します([[tile|タイル]]がまだ別の[[character|キャラクター]]で占められていない場合)。[[entity|エンティティ]]IDはオプションで、指定した場合は新しい[[character|キャラクター]]に割り当てられます。

====構文:====
<code python>
add_character(model_name, tile, entity_id)
</code>

^引数^説明^型^必須/オプション^
|model_name|新しい[[character|キャラクター]]に使用するモデル。|[[string|文字列]]|必須|
|tile|[[character|キャラクター]]が配置される[[tile|タイル]]のIDまたは[[coordinate|座標]]。|[[string|文字列]], [[coordinate|座標]]|必須|
|entity_id|割り当てる一意の[[entity|エンティティ]]ID。|[[string|文字列]]|オプション|

<WRAP center round info 100%>
後ほど[[remove_entity|エンティティの削除]]関数を実行すれば、キャラクターの追加関数でシーンに追加された[[character|キャラクター]]を削除することができます。
</WRAP>

====使用例:====
<code bauxite>
add_character("purple_slime", "dungeon_door_01", "slime_01")
</code>
//結果:// 紫色のスライムが[[map|マップ]]内にある「dungeon_door_01」というIDを持った[[tile|タイル]]の上に追加され、そのスライムには「slime_01」というIDが割り当てられます。

<WRAP center round tip 100%>
** キャラクターを追加 **機能を使用して、シーンに新しい[[npc|NPC]]を導入します。追加後、[[set_dialogue|ダイアログを設定]]機能を使用して[[dialogue|ダイアログ]]を[[character|キャラクター]]に割り当てたり、[[set_character_name|キャラクター名の設定]]機能を使用して名前を変更したりできます。
</WRAP>

----

<WRAP group>
<WRAP half column>
====エディターノード:====
{{:ja:add_character_node.png?nolink|}}
</WRAP>

<WRAP half column>
====ビジュアルデモ:====
{{:add_character_demo.gif?nolink|}}
</WRAP>
</WRAP>

~~NOTOC~~