ESCItem

Extends: Area2D

Description

An ESCItem defines a (usually interactive) item in the game.

When interacting with an ESCItem, the game character will automatically walk to an ESCLocation that is created as a child of an ESCItem.

By selecting the “Is Exit” checkbox when you create an ESCItem node, Escoria will look for an :exit_scene event in the attached script file. Any commands you place in the :exit_scene event will be run when the player chooses to “use” the exit - for example, saying a goodbye, or running a cutscene. Place a change_scene command inside this event to move the character to the next room.

Constants Descriptions

GROUP_ITEM_CAN_COLLIDE

const GROUP_ITEM_CAN_COLLIDE: String = "item_can_collide"

Group for ESCItem’s that can be collided with in a scene. Used for quick retrieval of such nodes to easily change their attributes at the same time.

Property Descriptions

global_id

export var global_id = ""

The global ID of this item

esc_script

export var esc_script = ""

The ESC script for this item

is_exit

export var is_exit = false

If true, the ESC script may have an :exit_scene event to manage scene changes. For simple exits that do not require scripted actions, the ESCExit node may be preferred.

is_trigger

export var is_trigger = false

If true, object is considered as trigger. Allows using :trigger_in and :trigger_out verbs in ESC scripts.

trigger_in_verb

export var trigger_in_verb = "trigger_in"

The verb used for the trigger in ESC events

trigger_out_verb

export var trigger_out_verb = "trigger_out"

The verb used for the trigger out ESC events

is_interactive

export var is_interactive = true

If true, the player can interact with this item

is_movable

export var is_movable = false

Whether this item is movable

player_orients_on_arrival

export var player_orients_on_arrival = true

If true, player orients towards ‘interaction_direction’ as player character arrives.

interaction_direction

export var interaction_direction = 0

Let the player turn to this direction when the player arrives at the item

default_action

export var default_action = ""

Default action to use if object is not in the inventory

default_action_inventory

export var default_action_inventory = ""

Default action to use if object is in the inventory

combine_when_selected_action_is_in

export var combine_when_selected_action_is_in = []

If action used by player is in this list, the game will wait for a second click on another item to combine objects together (typical USE <X> WITH <Y>, GIVE <X> TO <Y>)

combine_is_one_way

export var combine_is_one_way = false

If true, combination must be done in the way it is written in ESC script ie. :use ON_ITEM If false, combination will be tried in the other way.

use_from_inventory_only

export var use_from_inventory_only = false

If true, then the object must have been picked up before using it. A false value is useful for items in the background, such as buttons.

inventory_texture

export var inventory_texture: Texture = "[Object:null]"

The visual representation for this item when its in the inventory

dialog_color

export var dialog_color = "0,0,0,1"

Color used for dialogs

dont_apply_terrain_scaling

export var dont_apply_terrain_scaling = false

If true, terrain scaling will not be applied and node will remain at the scale set in the scene.

speed

export var speed: int = 300

Speed of this item ifmovable

v_speed_damp

export var v_speed_damp: float = 1

Speed damp of this item if movable

animation_player_node

export var animation_player_node: NodePath = ""

The node used to play animations

camera_node

export var camera_node = ""

The node that references the camera position and zoom if this item is used as a camera target

animations

var animations: ESCAnimationResource

Setter: set_animations

ESCAnimationsResource (for walking, idling…)

animation_sprite

var animation_sprite

Reference to the animation node (null if none was found)

terrain

var terrain: ESCTerrain

Reference to the current terrain

collision

var collision: Node

Reference to this items collision shape node

Method Descriptions

validate_animations

func validate_animations(animations_resource: ESCAnimationResource) -> void

Validates the ESCAnimationResource if it exists. Note that we pass in the ESCAnimationResource as an argument so that it can also be used to validate an ESCAnimationResource prior to being set.

Parameters

animation_resource: the ESCAnimationResource to validate.

set_animations

func set_animations(p_animations: ESCAnimationResource) -> void

Setter for the animations property.

get_animation_player

func get_animation_player() -> Node

Return the animation player node

get_interact_position

func get_interact_position() -> Vector2

Return the position the player needs to walk to to interact with this item. That can either be a direct Position2D child or a collision shape

Returns The interaction position

mouse_entered

func mouse_entered()

React to the mouse entering the item by emitting the respective signal

mouse_exited

func mouse_exited()

React to the mouse exiting the item by emitting the respective signal

element_entered

func element_entered(body)

Another item (e.g. the player) has entered this item

Parameters

body: Other object that has entered the item

element_exited

func element_exited(body)

Another item (e.g. the player) has exited this element

Parameters

body: Other object that has entered the item

teleport

func teleport(target: Node) -> void

Use the movable node to teleport this item to the target item

Parameters

target: Target node to teleport to

teleport_to

func teleport_to(target: Vector2) -> void

Use the movable node to teleport this item to the target position

Parameters

target: Vector2 position to teleport to

walk_to

func walk_to(pos: Vector2, p_walk_context: ESCWalkContext = null) -> void

Use the movable node to make the item walk to the given position

Parameters

pos: Position to walk to
p_walk_context: Walk context to use

stop_walking_now

func stop_walking_now(to_target: bool = false) -> void

Stop the movable node immediately and remain where it is at this moment, or teleport it directly at destination position if ‘to_target’ is true.

Parameters

to_target: if true, the movable node is teleport directly at its target destination

set_speed

func set_speed(speed_value: int) -> void

Set the moving speed

Parameters

speed_value: Set the new speed

has_moved

func has_moved() -> bool

Check whether this item moved

get_sprite

func get_sprite() -> Node

Return the sprite node

set_angle

func set_angle(deg: int, wait: float = 0)

Set the angle

Parameters

deg: The angle degree to set
wait: Wait this amount of seconds until continuing with turning around

turn_to

func turn_to(object: Node, wait: float = 0)

Turn to face another object

Parameters

deg: The angle degree to set
float Wait this amount of seconds until continuing with turning around

start_talking

func start_talking()

Play the talking animation

stop_talking

func stop_talking()

Stop playing the talking animation

update_idle

func update_idle()

Replay the last idle animation

get_camera_node

func get_camera_node()

Return the camera position if a camera_position_node exists or the global position of the player

is_moving

func is_moving() -> bool

Whether the item is currently moving.

Returns Returns true if the player is currently moving, false otherwise

Signals

signal mouse_entered_item(item): Emitted when the mouse has entered this item

Parameters

items: The inventory item node
signal mouse_exited_item(item): Emitted when the mouse has exited this item

Parameters

items: The inventory item node
signal mouse_left_clicked_item(global_id): Emitted when the item was left cliced

Parameters

global_id: ID of this item
signal mouse_double_left_clicked_item(global_id): Emitted when the item was double cliced

Parameters

global_id: ID of this item
signal mouse_right_clicked_item(global_id): Emitted when the item was right cliced

Parameters

global_id: ID of this item
signal arrived(walk_context): Emitted when the item walked to a destination

Parameters

walk_context: The walk context of the command

Sub-classes

HoverStackSorter

Method Descriptions

sort_ascending_z_index (static)

func sort_ascending_z_index(a, b)

ESCItem

Description

Constants Descriptions

GROUP_ITEM_CAN_COLLIDE

Property Descriptions

global_id

esc_script

is_exit

is_trigger

trigger_in_verb

trigger_out_verb

is_interactive

is_movable

player_orients_on_arrival

interaction_direction

tooltip_name

default_action

default_action_inventory

combine_when_selected_action_is_in

combine_is_one_way

use_from_inventory_only

inventory_texture

dialog_color

dont_apply_terrain_scaling

speed

v_speed_damp

animation_player_node

camera_node

animations

animation_sprite

terrain

collision

Method Descriptions

validate_animations

Parameters

set_animations

get_animation_player

get_interact_position

mouse_entered

mouse_exited

element_entered

Parameters

element_exited

Parameters

teleport

Parameters

teleport_to

Parameters

walk_to

Parameters

stop_walking_now

Parameters

set_speed

Parameters

has_moved

get_sprite

set_angle

Parameters

turn_to

Parameters

start_talking

stop_talking

update_idle

get_camera_node

is_moving

Signals

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Sub-classes

HoverStackSorter

Method Descriptions

sort_ascending_z_index (static)