Overview

An NPC is not necessarily a person: it can also be a more general, solid interactive entity. In this case, it is called a generalized NPC.

Interactions with an NPC may start a dialog or be forwarded to Lua. More precisely, what happens can be one of the following.

A dialog starts.
A Lua event is called on the NPC itself, for instance npc:on_interaction() or npc:on_interaction_item().
A Lua event is called on an equipment item, for instance item:on_npc_interaction() or item:on_npc_interaction_item().

An NPC can move if you apply a movement to it by calling movement:start(npc).

The size of an NPC is always 16x16 pixels (like the hero) and by default, the NPC is an obstacle for most map entities, including the hero.

Usual NPCs (i.e. non-generalized ones) are suited to usual interactions with people. They must have a sprite with at least four directions, and with animations named "stopped" and (if you move them) "walking". These predefined animations are automatically started by the engine when you make the NPC move. When the hero talks to them, their sprite automatically stops its animation and looks into his direction.

Example of use of a usual NPC: a non-playing character walking randomly in a town.

Generalized NPCs are more customizable. They are solid entities that the hero can interact with, and there is essentially nothing more predefined by the engine. They may even have no sprite. You can choose to allow interactions with the hero from any of the four directions or from a precise direction only.

Example of use of a generalized NPC: a stone with something to read on it.

Methods inherited from map entity

Non-playing characters are particular map entities. Therefore, they inherit all methods from the type map entity.

See Methods of all entity types to know these methods.

Methods of the type non-playing character

The following methods are specific to non-playing characters.

npc:is_traversable()

Returns whether this NPC can be traversed by other entities.

By default, NPCs are not traversable. However, be aware that some entities can override this setting. Indeed, other NPCs, enemies and projectiles (thrown objects, arrows, boomerang) can traverse usual NPCs but cannot traverse generalized NPCs. And custom entities can have finer customization.

Return value (boolean): true if this NPC is traversable.

npc:set_traversable([traversable])

Sets whether this NPC can be traversed by other entities.

By default, NPCs are not traversable. However, be aware that some entities can override this setting. Indeed, other NPCs, enemies and projectiles (thrown objects, arrows, boomerang) can traverse usual NPCs but cannot traverse generalized NPCs. And custom entities can have finer customization.

If you want to allow the hero to be able to traverse this NPC, you can use this function.

traversable (boolean, optional): true to make this NPC traversable. No value means true.

Events inherited from map entity

Events are callback methods automatically called by the engine if you define them.

Non-playing characters are particular map entities. Therefore, they inherit all events from the type map entity.

See Events of all entity types to know these events.

Events of the type non-playing character

The following events are specific to non-playing characters.

npc:on_interaction()

Called when the hero interacts (the player pressed the action command) in front of this NPC, if the NPC has the property to notify its own Lua script.

npc:on_interaction_item(item_used)

Called when the hero uses any equipment item (the player pressed an item command) with this NPC, if the NPC has the property to notify its own Lua script.

item_used (item): The item currently used by the player.
Return value (boolean): true if an interaction happened. If you return false or nothing, then item_used:on_using() will be called (just like if there was no NPC in front of the hero).

npc:on_collision_fire()

Called when fire touches this NPC, if the NPC has the property to notify its own Lua script.

Table of Contents